fstrelabel(1)

📦
version 1.8.5 · 5 versions
, in ubuntu stonking

💖 fstrelabel(1) — User Commands 💖

okay bestie, welcome to fstrelabel, section 1 of the manual, and she is THAT girl. she relabels FSTs. that's the whole job. she does it beautifully. 🦋

🌸 NAME 🌸

fstrelabel — relabel an FST 💅

✨ SYNOPSIS ✨

fstrelabel [OPTIONS] [in.fst [out.fst]]

🎀 DESCRIPTION 🎀

so basically, fstrelabel relabels the input and/or the output labels of an FST. that's it. that's the vibe. it takes an FST, it swaps out labels for other labels, and it hands you back an FST. iconic behaviour, no notes. 👑

💅 OPTIONS 💅

first, the house rules, and they apply to every single boolean in this list:

Boolean options accept either true or false as a value, or the implicit value true if neither value is specified.

so like, --fst_align alone means --fst_align=true. you don't gotta spell it out. we love a low-effort queen. 🫶

  • --allow_negative_labels[=BOOLEAN] — let negative labels exist. ngl bestie, not recommended — it may cause conflicts. Default: false.
  • --fst_align[=BOOLEAN] — write FST data aligned where appropriate. Default: false.
  • --fst_compat_symbols[=BOOLEAN] — require symbol tables to match when appropriate. Default: true.
  • --fst_default_cache_gc[=BOOLEAN] — turn on garbage collection of the cache. Default: true.
  • --fst_default_cache_gc_limit=N — set the cache byte size that triggers garbage collection. Default: 1048576.
  • --fst_error_fatal[=BOOLEAN] — if true, FST errors are fatal. otherwise, returned objects get flagged as bad. 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 (e.g., 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 brief usage information. Default: false.
  • --isymbols=FILENAME — set the input label symbol table. Default: "".
  • --osymbols=FILENAME — set the output label symbol table. Default: "".
  • --relabel_ipairs=FILENAME — when using numeric labels, the input relabel pairs.
  • --relabel_isymbols=FILENAME — when using SymbolTables, the input symbol set to relabel to.
  • --relabel_opairs=FILENAME — when using numeric labels, the output relabel pairs.
  • --relabel_osymbols=FILENAME — when using SymbolTables, the output symbol set to relabel to.
  • --save_relabel_ipairs=FILENAME — save input relabel pairs to file. Default: do not save.
  • --save_relabel_opairs=FILENAME — save output relabel pairs to file. Default: do not save.
  • --tmpdir=PATHNAME — set the temporary directory to use. Default: /tmp.
  • --unknown_isymbol=STRING — input symbol to use to relabel OOVs. Default: OOVs are errors.
  • --unknown_osymbol=STRING — output symbol to use to relabel OOVs. Default: OOVs are errors.
  • --v[=N] — set the verbosity level. Default: 0.

🫶 SEE ALSO 🫶

the whole girl group, fr fr — go read these too:

that's the whole page bestie, you ate that 🍓✨ this one's from OpenFst 1.8.5, dated Mar 2026, and no cap it's a real one. go relabel something iconic. 💖🌈💅

📦 where this page comes from