.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH HFST-STRINGS2FST "1" "August 2018" "HFST" "User Commands"
.SH NAME
hfst-strings2fst \- =Compile string pairs and pair-strings into transducer(s)
.SH SYNOPSIS
.B hfst-strings2fst
[\fI\,OPTIONS\/\fR...] [\fI\,INFILE\/\fR]
.SH DESCRIPTION
Compile string pairs and pair\-strings into transducer(s)
.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=\fI\,INFILE\/\fR
Read input strings from INFILE
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,OUTFILE\/\fR
Write output transducer to OUTFILE
.SS "String and format options:"
.TP
\fB\-f\fR, \fB\-\-format\fR=\fI\,FMT\/\fR
Write result in FMT format
.TP
\fB\-j\fR, \fB\-\-disjunct\-strings\fR
Disjunct all strings instead of transforming
each string into a separate transducer
.TP
\fB\-\-norm\fR
Divide each weight by sum of all weights
(with option \fB\-j\fR)
.TP
\fB\-\-log\fR
Take negative natural logarithm of each weight
.TP
\fB\-\-log10\fR
Take negative 10\-based logarithm of each weight
.TP
\fB\-p\fR, \fB\-\-pairstrings\fR
Input is in pairstring format
.TP
\fB\-S\fR, \fB\-\-has\-spaces\fR
Input has spaces between symbols/symbol pairs
.TP
\fB\-e\fR, \fB\-\-epsilon\fR=\fI\,EPS\/\fR
Interpret string EPS as epsilon.
.TP
\fB\-m\fR, \fB\-\-multichar\-symbols\fR=\fI\,FILE\/\fR
Strings that must be tokenized as one symbol.
.PP
If OUTFILE or INFILE is missing or \-, standard streams will be used.
FMT can be { foma, openfst\-tropical, openfst\-log, sfst,
optimized\-lookup\-weighted, optimized\-lookup\-unweighted }.
If EPS is not defined, the default representation of @0@ is used.
Option \fB\-\-norm\fR precedes option \fB\-\-log\fR.
The FILE of option \fB\-m\fR lists all multichar\-symbols, each symbol
on its own line.
Backslash '\e' may be used to escape ':', tab and itself. For any
other symbol x '\ex' means x literally, i.e. is the same as 'x'.
The weight of a string can be given after the string separated
by a tabulator. The weight cannot be zero.
.SH EXAMPLES
.TP
echo "cat:dog" | hfst\-strings2fst
create cat:dog fst
.TP
echo "c:da:ot:g" | hfst\-strings2fst \-p
same as pairstring
.TP
echo "c:d a:o t:g" | hfst\-strings2fst \-p \-S
same as pairstring with spaces
.TP
echo "c a t:d o g" | hfst\-strings2fst \-S
same with spaces
.SH "REPORTING BUGS"
Report bugs to <hfst\-bugs@helsinki.fi> or directly to our bug tracker at:
<https://github.com/hfst/hfst/issues>
.PP
hfst\-strings2fst home page:
<https://github.com/hfst/hfst/wiki/Strings2Fst>
.br
General help using HFST software:
<https://github.com/hfst/hfst/wiki>
.SH COPYRIGHT
Copyright \(co 2017 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.