fstrandgen(1)

💫 fstrandgen(1) — the manual page, but make it cute 💫

okay bestie, pull up a chair 🫶 you're looking at fstrandgen(1), one of the User Commands in the OpenFst fam, and honestly? she's a vibe. she rolls the dice and hands you a random path through an FST. that's it. that's the whole job. no cap.

---

✨ NAME ✨

fstrandgen — generate random paths through an FST 🌈

---

✨ SYNOPSIS ✨

fstrandgen [OPTIONS] [in.fst [out.fst]]

---

💖 DESCRIPTION 💖

Generates random paths through an FST. literally just that. give her an FST, she gives you a random walk through it, main character energy only 👑

---

🎀 OPTIONS 🎀

quick note before we dive in: boolean options accept either true or false as a value, or they just implicitly mean true if you don't say anything at all. so like, no value = yes. periodt 💅

• --fst_align[=BOOLEAN] — write your FST data aligned wherever it makes sense to do so. Default: false.
• --fst_compat_symbols[=BOOLEAN] — require symbol tables to match when appropriate. Default: true.
• --fst_default_cache_gc[=BOOLEAN] — turn on garbage collection for the cache. yes she cleans up after herself 🧚 Default: true.
• --fst_default_cache_gc_limit=N — set the cache byte size that triggers that garbage collection. Default: 1048576.
• --fst_error_fatal[=BOOLEAN] — if true, FST errors are fatal. otherwise the returned objects just get flagged as bad instead. for example, FSTs come back with the kError property set to true, and FST weights get set so that Member() returns false. Default: true.
• --fst_field_separator=STRING — set the characters used as a separator between printed fields. Default: " ".
• --fst_read_mode=STRING — set the default file reading mode for mappable files, either "read" or "map". Default: "read".
• --fst_verify_properties[=BOOLEAN] — verify FST properties queried by TestProperties. Default: false.
• --fst_weight_parentheses=STRING — set the characters enclosing the first weight of a printed composite weight (think: pair weight, tuple weight, and derived classes) so nested composite weights do proper I/O. Must have size 0 (none) or 2 (open and close parenthesis). Default: no parentheses.
• --fst_weight_separator=CHARACTER — set the character separator between printed composite weights. Default: comma.
• --help[=BOOLEAN] — show usage information. Default: false.
• --helpshort[=BOOLEAN] — show the brief usage information. Default: false.
• --max_length=LENGTH — set the maximum path length. Default: 2147483647.
• --npath=INTEGER — set the number of paths to generate. Default: 1.
• --save_relabel_ipairs=FILENAME — save input relabel pairs to a file. Default: do not save.
• --save_relabel_opairs=FILENAME — save output relabel pairs to a file. Default: do not save.
• --seed=INTEGER — set the seed for the random number generator. Default: 1299100605.
• --select=TYPE — set the selection type, one of uniform, log_prob, and fast_log_prob. Default: uniform.
• --tmpdir=PATHNAME — set the temporary directory to use. Default: /tmp.
• --v[=N] — set the verbosity level. Default: 0.

---

🌸 SEE ALSO 🌸

the whole girl group, bestie, all of them:

fstarcsort(1), fstclosure(1), fstcompile(1), fstcompose(1), fstcompress(1), fstconcat(1), fstconnect(1), fstconvert(1), fstdeterminize(1), fstdifference(1), fstdisambiguate(1), fstdraw(1), fstencode(1), fstepsnormalize(1), fstequal(1), fstequivalent(1), fstinfo(1), fstintersect(1), fstinvert(1), fstisomorphic(1), fstlinear(1), fstloglinearapply(1), fstmap(1), fstminimize(1), fstprint(1), fstproject(1), fstprune(1), fstpush(1), fstrelabel(1), fstreplace(1), fstreverse(1), fstreweight(1), fstrmepsilon(1), fstshortestdistance(1), fstshortestpath(1), fstsymbols(1), fstsynchronize(1), fsttopsort(1), fstunion(1)

---

okay that's the whole page, you ate that 🍓 this one's from OpenFst 1.8.5, dated Mar 2026. go randomize something, bestie 💜🦋