.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.4.
.TH HFST-LOOKUP "1" "December 2015" "HFST" "User Commands"
.SH NAME
hfst-lookup \- =perform transducer lookup (apply)
.SH SYNOPSIS
.B hfst-lookup
[\fIOPTIONS\fR...] [\fIINFILE\fR]
.SH DESCRIPTION
perform transducer lookup (apply)
.SS "Common options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help message
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version info
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Print verbosely while processing
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Only print fatal erros and requested output
.TP
\fB\-s\fR, \fB\-\-silent\fR
Alias of \fB\-\-quiet\fR
.SS "Input/Output options:"
.TP
\fB\-i\fR, \fB\-\-input\fR=\fIINFILE\fR
Read input transducer from INFILE
.TP
\fB\-o\fR, \fB\-\-output\fR=\fIOUTFILE\fR
Write output to OUTFILE
.HP
\fB\-p\fR, \fB\-\-pipe\-mode\fR[=\fISTREAM\fR] Control input and output streams
.SS "Lookup options:"
.TP
\fB\-I\fR, \fB\-\-input\-strings\fR=\fISFILE\fR
Read lookup strings from SFILE
.TP
\fB\-O\fR, \fB\-\-output\-format\fR=\fIOFORMAT\fR
Use OFORMAT printing results sets
.TP
\fB\-e\fR, \fB\-\-epsilon\-format\fR=\fIEPS\fR
Print epsilon as EPS
.TP
\fB\-F\fR, \fB\-\-input\-format\fR=\fIIFORMAT\fR
Use IFORMAT parsing input
.TP
\fB\-x\fR, \fB\-\-statistics\fR
Print statistics
.TP
\fB\-X\fR, \fB\-\-xfst\fR=\fIVARIABLE\fR
Toggle xfst VARIABLE
.TP
\fB\-c\fR, \fB\-\-cycles\fR=\fIINT\fR
How many times to follow input epsilon cycles
.TP
\fB\-b\fR, \fB\-\-beam\fR=\fIB\fR
Output only analyses whose weight is within B from
the best analysis
.TP
\fB\-t\fR, \fB\-\-time\-cutoff\fR=\fIS\fR
Limit search after having used S seconds per input
(currently only works in optimized\-lookup mode
.TP
\fB\-P\fR, \fB\-\-progress\fR
Show neat progress bar if possible
.PP
If OUTFILE or INFILE is missing or \-, standard streams will be used.
Format of result depends on format of INFILE
OFORMAT is one of {xerox,cg,apertium}, xerox being default
IFORMAT is one of {text,spaced,apertium}, default being text,
unless OFORMAT is apertium
VARIABLEs relevant to lookup are {print\-pairs,print\-space,
quote\-special,show\-flags,obey\-flags}
Input epsilon cycles are followed by default INT=5 times.
Epsilon is printed by default as an empty string.
B must be a non\-negative float.
S must be a non\-negative float. The default, 0.0, indicates no cutoff.
If the input contains several transducers, a set containing
results from all transducers is printed for each input string.
.PP
STREAM can be { input, output, both }. If not given, defaults to {both}.
If input file is not specified with \fB\-I\fR, input is read interactively line by
line from the user. If you redirect input from a file, use \fB\-\-pipe\-mode\fR=\fIinput\fR.
\fB\-\-pipe\-mode\fR=\fIoutput\fR is ignored on non\-windows platforms.
.SS "Todo:"
.IP
For optimized lookup format, only strings that pass flag diacritic checks
are printed and flag diacritic symbols are not printed.
Support VARIABLE 'print\-space' for optimized lookup format
.SS "Known bugs:"
.IP
\&'quote\-special' quotes spaces that come from 'print\-space'
.SH "REPORTING BUGS"
Report bugs to <hfst\-bugs@helsinki.fi> or directly to our bug tracker at:
<https://sourceforge.net/tracker/?atid=1061990&group_id=224521&func=browse>
.PP
hfst\-lookup home page:
<https://kitwiki.csc.fi/twiki/bin/view/KitWiki//HfstLookup>
.br
General help using HFST software:
<https://kitwiki.csc.fi/twiki/bin/view/KitWiki//HfstHome>
.SH COPYRIGHT
Copyright \(co 2010 University of Helsinki,
License GPLv3: GNU GPL version 3 <http://gnu.org/licenses/gpl.html>
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.