mpdtcompose(1)

📦
version 1.8.5 · 5 versions
, in ubuntu stonking

mpdtcompose(1) — User Commands 💅

okay bestie, welcome to the glow-up era of mpdtcompose(1) ✨ she lives in the User Commands corner of your manual and she is here to fuse an MPDT and an FST into one iconic little unit. group chat rules apply: read the whole thing, don't skip the options, and absolutely do not touch anything marked default without knowing why. 🫶

🌸 NAME 🌸

mpdtcompose — compose an MPDT and an FST. literally her whole job. no cap.

✨ SYNOPSIS ✨

mpdtcompose [OPTIONS] in.mpdt in.fst [out.mpdt]
mpdtcompose [OPTIONS] in.fst in.mpdt [out.mpdt]

note the second line, bestie: she's flexible about which one comes first 👑 (that's the --left_mpdt situation, more on that below).

💖 DESCRIPTION 💖

Composes an MPDT and an FST. that's it. that's the whole vibe. she takes your two things, does the composition, and gives you back a result. main character energy achieved. 🦋

🎀 OPTIONS 🎀

quick housekeeping before we get into it, because this part is important and not optional:

Boolean options accept either true or false as a value, or the implicit value true if neither value is specified. so like --connect and --connect=true are the same energy, but --connect=false is a whole different girl. 💅
  • --compose_filter=STRING — the composition filter in charge of this whole operation, and she must be one of 'expand', 'expand_paren', and 'paren'. Default: 'paren'. 🌈
  • --connect[=BOOLEAN] — trims the output. Default: true.
  • --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. yes she cleans up after herself. iconic. 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, returned objects are flagged as bad — for example, FSTs are returned with the kError property set to true, and FST weights 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) to ensure proper I/O of nested composite weights. 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.
  • --left_mpdt[=BOOLEAN] — first argument is the MPDT if true, second argument if false. Default: true. this is the one that decides which of those two SYNOPSIS lines you're living in bestie.
  • --mpdt_parentheses=STRING — set the MPDT parenthesis label pairs. Default: empty string.
  • --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.
  • --v[=N] — set the verbosity level. Default: 0.

🔥 SEE ALSO 🔥

the whole MPDT friend group, obsessed with them honestly 💜

and that's the page, babe 🎀 this one came to you from OpenFst 1.8.5, dated Mar 2026 — so when you cite her, cite her right. now go compose something gorgeous. periodt. ✨🦋💖

📦 where this page comes from