pdtcompose(1)

💖 pdtcompose(1) 💖

okay bestie, welcome to pdtcompose, a lil User Commands girlie from the OpenFst 1.8.5 era. she's here to smash a PDT and an FST together into one iconic combo. let's get into it 🫶

---

🌸 NAME 🌸

pdtcompose — compose a PDT and an FST ✨

---

🦋 SYNOPSIS 🦋

pdtcompose [OPTIONS] in.pdt in.fst [out.pdt]
pdtcompose [OPTIONS] in.fst in.pdt [out.pdt]

notice how she takes them in either order? yeah. queen behavior. 👑

---

🎀 DESCRIPTION 🎀

Composes a PDT and an FST.

that's it. that's the whole vibe. she takes your pushdown transducer and your regular transducer, matches them up, and gives you the composed result. no cap. 💅

---

✨ OPTIONS ✨

okay so first the rules of the house, listen up:

Boolean options accept either true or false as a value, or the implicit value true if neither value is specified. so like, --connect alone = --connect=true. slay.

---

• --compose_filter=STRING — the composition filter, bestie. it's one of 'expand', 'expand_paren', and 'paren'. Default: 'paren'. 🌈
• --connect[=BOOLEAN] — trims the output. Default: true. clean it up, periodt. ✂️
• --fst_align[=BOOLEAN] — writes FST data aligned where appropriate. Default: false.
• --fst_compat_symbols[=BOOLEAN] — requires symbol tables to match when appropriate. Default: true. no mismatched tables on her watch. 🚫
• --fst_default_cache_gc[=BOOLEAN] — enables garbage collection of the cache. Default: true. she cleans up after herself, unlike some people 😭
• --fst_default_cache_gc_limit=N — sets the cache byte size that triggers 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. > bestie this one is literally life or death for your run, read it twice 💀
• --fst_field_separator=STRING — sets the characters used as a separator between printed fields. Default: " ". (yes that's the default, exactly as written, don't come for me)
• --fst_read_mode=STRING — sets the default file reading mode for mappable files, either "read" or "map". Default: "read".
• --fst_verify_properties[=BOOLEAN] — verifies fst properties queried by TestProperties. Default: false.
• --fst_weight_parentheses=STRING — sets 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 — sets the character separator between printed composite weights. Default: comma.
• --help[=BOOLEAN] — shows usage information. Default: false. the classic. 🆘
• --helpshort[=BOOLEAN] — shows brief usage information. Default: false.
• --left_pdt[=BOOLEAN] — first argument is the PDT if true, second argument if false. Default: true. this is the whole "which one goes first" situation, and she's letting you decide 🫶
• --pdt_parentheses=STRING — sets the PDT parenthesis label pairs.
• --save_relabel_ipairs=FILENAME — saves input relabel pairs to file. Default: do not save.
• --save_relabel_opairs=FILENAME — saves output relabel pairs to file. Default: do not save.
• --tmpdir=PATHNAME — sets the temporary directory to use. Default: /tmp. 🗂️
• --v[=N] — sets the verbosity level. Default: 0. crank it up if you want the tea ☕

---

👀 SEE ALSO 👀

fstcompose(1), pdtexpand(1), pdtinfo(1), pdtreplace(1), pdtreverse(1), pdtshortestpath(1)

the whole squad fr fr 💜

---

and that's the page, bestie!! this manual page is brought to you by OpenFst 1.8.5, dated Mar 2026. go compose something iconic ✨💅🌸 no cap, you got this. 💖