HFST-FST2FST(1)

🌸 HFST-FST2FST(1) 🌸

okay bestie, welcome to the hfst-fst2fst page from the HFST manual — it's a User Commands one, and it's literally the glow-up station for your transducers ✨

---

💖 NAME 💖

hfst-fst2fst — converts transducers between binary formats 🦋

---

✨ SYNOPSIS ✨

hfst-fst2fst [OPTIONS...] [INFILE]

---

🎀 DESCRIPTION 🎀

So basically: it converts transducers between binary formats. That's the whole vibe. You hand it a transducer, it hands you back a transducer in a different binary format. iconic behavior, no notes 💅

🌈 Common options: 🌈

• -h, --help — prints the help message, your lil cheat sheet 🫶
• -V, --version — prints version info, so you know what era of HFST you're living in
• -v, --verbose — prints stuff verbosely while it's processing, so it yaps the whole time 💬
• -q, --quiet — only prints fatal erros and requested output. yes, that's "erros" — we keep the original spelling, it's part of the lore 😭
• -s, --silent — alias of --quiet, same energy, different letter 🤫

🧚 Input/Output options: 🧚

• -i, --input=INFILE — reads the input transducer from INFILE
• -o, --output=OUTFILE — writes the output transducer to OUTFILE

👑 Conversion options: 👑

• -f, --format=FMT — writes the result in FMT format
• -b, --use-backend-format — writes the result in implementation format, without any HFST wrappers (raw, unfiltered, main character energy)
• -S, --sfst — writes output in (HFST's) SFST implementation
• -F, --foma — writes output in (HFST's) foma implementation
• -x, --xfsm — writes output in native xfsm format
• -t, --openfst-tropical — writes output in (HFST's) tropical weight (OpenFST) implementation
• -l, --openfst-log — writes output in (HFST's) log weight (OpenFST) implementation
• -O, --optimized-lookup-unweighted — writes output in the HFST optimized-lookup implementation
• -w, --optimized-lookup-weighted — writes output in optimized-lookup (weighted) implementation
• -Q --quick — when converting to optimized-lookup, doesn't try hard to compress. low effort, on purpose, we respect it 🙈

---

okay so, housekeeping stuff:

If OUTFILE or INFILE is missing or is -, standard streams will be used. 🫧

The format of the result depends on the format of INFILE. FMT must be the name of a format usable by libhfst, i.e. one of the following:

{ foma, openfst-tropical, openfst-log, sfst, xfsm
       optimized-lookup-weighted, optimized-lookup-unweighted }

⚠️ heads up bestie: note that xfsm format is always written in native format without HFST wrappers. no wrapping, no bow, just the format itself 🎁

---

🐛 REPORTING BUGS 🐛

Found a bug? Tell the devs, they wanna know fr fr:

• Report bugs to <hfst-bugs@helsinki.fi> or directly to our bug tracker at: <https://github.com/hfst/hfst/issues>
• hfst-fst2fst home page: <https://github.com/hfst/hfst/wiki/HfstFst2Fst>
• 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. (fr fr, no warranty, read it and weep 😭)

---

and that's the whole page, babe 💖 stay slay, convert responsibly, and remember: this was HFST, dated August 2018, from the HFST era of the manual 👑✨