AceOptions

ACE Command-line Options

Below are the most common command-line usages of ACE, followed by a complete reference for all the command-line options.

Parsing (input is one sentence per line): ace -g grammar.dat [input-file] [-1 | -n count]

Generating (input is one MRS per line): ace -g grammar.dat -e [input-file] [-1 | -n count]

Compiling a grammar: ace -G grammar.dat -g path-to-config.tdl

Complete Reference:

Option	Description	Version
-g filename	Identify the grammar to be used. Normally, a compiled grammar image. When compiling a grammar, the location of that grammar's config.tdl file.	0.9
-G filename	Enable grammar-compilation mode, and specify where to save the compiled grammar.	0.9
-e	Generate, rather than parse.	0.9
-n count	Use selective unpacking to enumerate only the top count results.
-1	Equivalent to -n 1.
-r roots	Supplies a space-delimited list of root instances (overriding the setting compiled into the grammar image).
-l	Enable LUI mode. You must have a working yzlui binary in your PATH.
-f	Format each EP on its own line when printing MRSes.
-p	Turn off packing.
-R	Do not output results.
-T	Only output MRSes, not trees.
-t	Run as a [incr tsdb()] client.
-h	Show a short synopsis of usage
-V	Show ACE version number.
-v	Increase verbosity; up to 3 -v options can be used if desired. The additional output is unlikely to be useful except for debugging.
-E	Run the REPP preprocessor on each input and output the result; do not perform token mapping or any further parsing.
-m hostname	Join an arbiter grid of parsers.
-q	Suppress printing the input sentence in cases of successful parsing.
-X	Stop when the first result is found, rather than generating the complete packed forest. Not recommended.
-L lexemes	Disable certain lexemes when parsing.
-i	Perform a fine-grained timing profile of the operation requested (experimental).	0.9.3
-y	Enable YY input mode (experimental).	0.9.4
--max-chart-megabytes=X	Use up to X megabytes of RAM on chart edges before terminating the forest creation portion of parsing.
--max-unpack-megabytes=X	Use up to X megabytes of total RAM for chart edges and unpacking operations before cancelling a parse.
--timeout=X	Use up to X seconds of time before cancelling a parse. Off by default.
--disable-subsumption-test	Turn off the subsumption check in generation (underspecified generation)
--disable-generalization	Turn off subsumption under generalization (useful for debugging)	0.9.17
--ubertagging=0.001	enable ubertagging	0.9.21
--pcfg=pcfg	use a pcfg approximation to parse (c-saw) and combine its results with the HPSG
--rooted-derivations	include the root in the derivation (if multiple roots apply, the first listed in roots.tdl will be used)
--udx(=all)	decorate lexeme nodes with their type; "--udx=all" decorates rule nodes too	0.9.24
--tsdb-stdout	produce structured output as expected by tsdb	0.9.24
--report-labels	add a tree with the labels (e.g., DT, VP as specified in labels.tdl)	0.9.24
--yy-rules	when in YY mode, require input tokens to undergo specific lexical rules