table of contents
- Tumbleweed 3.17.3-1.1
- Leap-16.0
- Leap-15.6
| HFST-FST2STRINGS(1) | User Commands | HFST-FST2STRINGS(1) |
NAME¶
hfst-fst2strings - =Display the strings recognized by a transducer
SYNOPSIS¶
hfst-fst2strings [OPTIONS...] [INFILE]
DESCRIPTION¶
Display the strings recognized by a transducer
Common options:¶
- -h, --help
- Print help message
- -V, --version
- Print version info
- -v, --verbose
- Print verbosely while processing
- -q, --quiet
- Only print fatal erros and requested output
- -s, --silent
- Alias of --quiet
- --colour[=WHEN]
- Print in colour WHEN:
- --color[=WHEN]
- always, never, auto (default)
Fst2strings options:¶
- -n, --max-strings=NSTR
- print at most NSTR strings
- -N, --nbest=NBEST
- print at most NBEST best strings
- -r, --random=NRAND
- print at most NRAND random strings
- -c, --cycles=NCYC
- follow cycles at most NCYC times
- -w, --print-weights
- display the weight for each string
- -S, --print-separator
- print separator "--" after each transducer
- -e, --epsilon-format=EPS
- print epsilon as EPS
- -X, --xfst=VARIABLE
- toggle xfst compatibility option VARIABLE
Path filters:¶
- -b, --beam=B
- reject output string with weight more than B away from the weight of the best output string
- -l, --max-in-length=MIL
- reject input string longer than MIL
- -L, --max-out-length=MOL
- reject output string longer than MOL
- -p, --in-prefix=OPREFIX
- input string must begin with IPREFIX
- -P, --out-prefix=OPREFIX
- output string must begin with OPREFIX
- -u, --in-exclude=IXSTR
- input string must not contain IXSTR
- -U, --out-exclude=OXST
- output string must not contain OXSTR
If OUTFILE or INFILE is missing or -, standard streams will be used. Format of result depends on format of INFILE If all NSTR, NBEST and NCYC are omitted, all possible paths are printed: NSTR, NBEST and NCYC default to infinity. NBEST overrides NSTR and NCYC NRAND overrides NBEST, NSTR and NCYC B must be a non-negative float If EPS is not given, default is empty string. Numeric options are parsed with strtod(3). Xfst variables supported are { obey-flags, print-flags, print-pairs, print-space, quote-special }.
EXAMPLES¶
- hfst-fst2strings lexical.hfst
- generates all forms of lexical.hfst
- hfst-fst2strings -P "cat<n>" -c 0 lexical.hfst
- generates paradigm for cat<n> without following cycles
Known bugs:¶
- Does not work correctly for hfst optimized lookup format.
REPORTING BUGS¶
Report bugs to <hfst-bugs@helsinki.fi> or directly to our bug tracker at: <https://github.com/hfst/hfst/issues>
hfst-fst2strings home page:
<https://github.com/hfst/hfst/wiki/HfstFst2Strings>
General help using HFST software:
<https://github.com/hfst/hfst/wiki>
COPYRIGHT¶
Copyright © 2017 University of Helsinki, License GPLv3: GNU
GPL version 3 <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO
WARRANTY, to the extent permitted by law.
| April 2026 | HFST |