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	Task			Version
		P	T	G
General options
-V	Show ACE version number.
-h	Show a short synopsis of usage
-v	Increase verbosity; up to 3 -v options can be used if desired. The additional output is unlikely to be useful except for debugging.	:white_check_mark:	:white_check_mark:	:white_check_mark:
–license-info	Show ACE’s license
Grammar loading/compiling
-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.	:white_check_mark:	:white_check_mark:	:white_check_mark:	0.9
-G filename	Enable grammar-compilation mode, and specify where to save the compiled grammar.				0.9
–gen-qc	Generate a quickcheck skeleton based on the unification failures encountered during this run.	:white_check_mark:		:white_check_mark:	0.9.31
Alternative modes
-e	Generate, rather than parse.			:white_check_mark:	0.9
-l	Enable LUI mode. You must have a working yzlui binary in your PATH.	:white_check_mark:	:white_check_mark:	:white_check_mark:
–input-from-lui	Inputs to parse are provided by LUI instead of stdin.	:white_check_mark:
–lui-fd=N	LUI front-end is already running and connected to file descriptor N.
–generation-server=fr	Operate as the generator in the LOGON architecture: read MRSes from ~/tmp/.transfer.$USER.fr			:white_check_mark:
-E	Run the REPP preprocessor on each input and output the result; do not perform token mapping or any further parsing.	:white_check_mark:
-m hostname	Join an arbiter grid of parsers.	:white_check_mark:	:white_check_mark:	:white_check_mark:
-t	Run as a [incr tsdb()] client.	:white_check_mark:	:white_check_mark:	:white_check_mark:
-O	Full-forest parse results; output chart edges instead of derivations.	:white_check_mark:
–itsdb-forest	Full-forest parse results with structured output; use with –tsdb-stdout and not with -O	:white_check_mark:			0.9.7
Input/output options
-f	Format each EP on its own line when printing MRSes.	:white_check_mark:	:white_check_mark:	:white_check_mark:
-y	Enable YY input mode (experimental).	:white_check_mark:			0.9.4
–yy-rules	when in YY mode, require input tokens to undergo specific lexical rules	:white_check_mark:			0.9.4
-q	Suppress printing the input sentence in cases of successful parsing.	:white_check_mark:
-R	Do not output results.	:white_check_mark:		:white_check_mark:
-T	Only output MRSes, not trees.	:white_check_mark:
–udx(=all)	decorate lexeme nodes with their type; “–udx=all” decorates rule nodes too	:white_check_mark:		:white_check_mark:	0.9.24
–tsdb-stdout	produce structured output as expected by tsdb	:white_check_mark:		:white_check_mark:	0.9.24
–tsdb-notes	output structured run and parse notes	:white_check_mark:		:white_check_mark:
–report-labels	add a tree with the labels (e.g., DT, VP as specified in parse-nodes.tdl in ERG defined in config in the parameter parse-node-labels)	:white_check_mark:		:white_check_mark:	0.9.24
–rooted-derivations	include the root in the derivation (if multiple roots apply, the first listed in roots.tdl will be used)	:white_check_mark:		:white_check_mark:
–show-realization-mrses	output the final MRS for each realization			:white_check_mark:
–show-realization-trees	output the derivation for each realization			:white_check_mark:
–show-probability	output the probability from the parse reranker	:white_check_mark:
Processing/filtering/robustness options
-n count	Use selective unpacking to enumerate only the top count results.	:white_check_mark:		:white_check_mark:
-1	Equivalent to -n 1.	:white_check_mark:		:white_check_mark:
-X	Stop when the first result is found, rather than generating the complete packed forest. Not recommended.	:white_check_mark:	:white_check_mark:	:white_check_mark:
-r roots	Supplies a space-delimited list of root instances (overriding the setting compiled into the grammar image).	:white_check_mark:
-L lexemes	Disable certain lexemes when parsing.	:white_check_mark:
-p	Turn off packing.	:white_check_mark:	:white_check_mark:	:white_check_mark:
–equivalence-packing	Disable packing under subsumption; only pack edges that are fully equivalent.	:white_check_mark:		:white_check_mark:
–disable-generalization	Turn off subsumption under generalization (useful for debugging)	:white_check_mark:	:white_check_mark:	:white_check_mark:	0.9.17
–disable-subsumption-test	Turn off the subsumption check in generation (underspecified generation)			:white_check_mark:
–ubertagging=0.001	enable ubertagging	:white_check_mark:			0.9.21
–pcfg=pcfg	use a pcfg approximation to parse (c-saw) and combine its results with the HPSG	:white_check_mark:
Performance
-i	Perform a fine-grained timing profile of the operation requested (experimental).	:white_check_mark:	:white_check_mark:	:white_check_mark:	0.9.3
–max-chart-megabytes=X	Use up to X megabytes of RAM on chart edges before terminating the forest creation portion of parsing (default 1200).	:white_check_mark:	:white_check_mark:	:white_check_mark:
–max-unpack-megabytes=X	Use up to X megabytes of total RAM for chart edges and unpacking operations before cancelling a parse (default 1500).	:white_check_mark:	:white_check_mark:	:white_check_mark:
–max-words=X	ignore sentences with more than X words (default 70)	:white_check_mark:			0.9.26
–timeout=X	Use up to X seconds of time before cancelling a parse. Off by default.	:white_check_mark:	:white_check_mark:	:white_check_mark:
Undocumented options
-j	Reserved for experimental modes.
-s	Don’t unspecialize extra constraints implied by input EPs.			:white_check_mark:
-F	Show all potential PRED values associated to the input tokens by the lexicon and morphology subsystems.	:white_check_mark:
-P	Broken.
–packed-edge-ids	Show internal edge IDs instead of sanitized ones. Can be useful for debugging.	:white_check_mark:		:white_check_mark:
–show-gen-chart	With -l and -e, browse the chart after attempting generation.			:white_check_mark:
–maxent=model.mem	Read model.mem and use it for disambiguation.	:white_check_mark:		:white_check_mark:
–tnt-model=/…/path	Invoke TNT for tagging, using the given model.	:white_check_mark:
–tnt-max-tags=N	Allow TNT to suggest up to N tags per word.	:white_check_mark:
–transfer-config=file.txt	Only enable transfer rules whose names are listed in file.txt (one per line).		:white_check_mark:

Last update: 2024-04-04 by John Carroll [edit]