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.