There are 3 main running modes for Grew:
- GUI mode (this is the default mode): grew
- Deterministic mode for one-to-one graph transformation: grew -det
- Corpus mode runs grew on a set of input graphs (see details below): grew -corpus
Options for all modes
-grs <grs_file> chose the grs file to load -seq <seq> set the module sequence to use -timeout <float> set a timeout on rewriting -main_feat <feat_name_list> set the list of feature names used in dep format to set the "main word"
If an option is not set, grew tries to recover the last used values.
The GUI mode
The following option is available only for the GUI mode:
-gr <gr_file> set the graph file (.gr or .conll) to use -doc force to generate the GRS doc
The documentation generation take some time (about 20 seconds for synsem_ftb) and it is disable by default. The documentation given in the GUI can be outdated if the GRS has changed since the last documentation generation.
The deterministic mode
When the GRS file describes a one-to-one transformation, the
-det option can be used to transform all graph of a corpus.
The two commands below rewrite each graph found in
input (either a conll file or a directory).
The output is written in a file (first command) or in a directory (second command).
grew -det -i input -f output_file
grew -det -i input -o output_dir
NB: One way to ensure that a GRS is deterministic is to declare all modules as confluent (at most one normal form) and to avoid filter rules (at least one normal form).
The corpus mode
The corpus mode runs some GRS on a set of graphs. This mode produces a directory which contains:
- a file index.html with a table of modules and rules usage statistics;
- a GRS documentation in the doc subdir;
- optionally (with option -html or -full_html) an html file f.html for each graph f.gr of f.conll of the input corpus;
- optionally (with option -out_gr) a gr file for each normal forms obtained.
There are two required options for this mode:
-i <input_dir> set the input dir where to find graph files (.gr or .conll) in corpus mode -o <output_dir> set the output dir where to generate statistics and documentation in corpus mode
WARNING If some directory of some file named output_dir exists, it will be erased.
Other options available for corpus mode are:
-title set the title for the generated page of statistics -html generate html files for each rewritten sentence -full_html generate html files for each sentence of the corpus -out_gr generate gr output for each rewriting normal form of the corpus -no_init do not display initial graph (requires html of full_html)
WARNING options -html, -full_html or -out_gr can produce an high number of files if there are applied on a large corpus.