HFST-STRINGS2FST(1)

✨ hfst-strings2fst ✨

okay bestie, so this is the manual page for hfst-strings2fst 💖 it's a User Command, it lives in the HFST family, and it's about to be your new fave.

---

🌸 NAME 🌸

hfst-strings2fst — =Compile string pairs and pair-strings into transducer(s)

(yes the = is literally in there, no I did not add it, we keep it 💅)

---

🎀 SYNOPSIS 🎀

hfst-strings2fst [OPTIONS...] [INFILE]

---

🦋 DESCRIPTION 🦋

Compile string pairs and pair-strings into transducer(s). that's the whole vibe. you feed it strings, it hands you back a transducer (or several), no cap.

🌈 Common options:

• -h, --help — print the help message, aka the "wait what does this do" button
• -V, --version — print version info, so you know exactly which era of this software you're living in
• -v, --verbose — print verbosely while processing, she's chatty and that's iconic
• -q, --quiet — only print fatal erros and requested output (yes, "erros", that's the manpage's own spelling, we're leaving it 💀)
• -s, --silent — alias of --quiet, same energy, different letter

🌟 Input/Output options:

• -i, --input=INFILE — read input strings from INFILE
• -o, --output=OUTFILE — write output transducer to OUTFILE

💜 String and format options:

• -f, --format=FMT — write result in FMT format
• -j, --disjunct-strings — disjunct all strings instead of transforming each string into a separate transducer
• --norm — divide each weight by sum of all weights (only does anything with option -j)
• --log — take negative natural logarithm of each weight
• --log10 — take negative 10-based logarithm of each weight
• -p, --pairstrings — input is in pairstring format
• -S, --has-spaces — input has spaces between symbols/symbol pairs
• -e, --epsilon=EPS — interpret string EPS as epsilon
• -m, --multichar-symbols=FILE — strings that must be tokenized as one symbol

---

🫶 housekeeping, bestie, listen up: If OUTFILE or INFILE is missing or -, standard streams will be used. the classic. FMT can be { foma, openfst-tropical, openfst-log, sfst, optimized-lookup-weighted, optimized-lookup-unweighted }. six options, all gorgeous. If EPS is not defined, the default representation of @0@ is used. Option --norm precedes option --log. order matters, don't be chaotic. The FILE of option -m lists all multichar-symbols, each symbol on its own line. Backslash '\' may be used to escape ':', tab and itself. For any other symbol x, '\x' means x literally, i.e. is the same as 'x'. The weight of a string can be given after the string separated by a tabulator. ⚠️ The weight cannot be zero. like, at all. zero is not the move here.

---

🔥 EXAMPLES 🔥

honestly these are so satisfying to look at:

echo "cat:dog" | hfst-strings2fst

create cat:dog fst 💅

echo "c:da:ot:g" | hfst-strings2fst -p

same as pairstring ✨

echo "c:d a:o t:g" | hfst-strings2fst -p -S

same as pairstring with spaces 🌸

echo "c a t:d o g" | hfst-strings2fst -S

same with spaces 🦋

---

🙈 REPORTING BUGS 🙈

found something cursed? Report bugs to <hfst-bugs@helsinki.fi> or directly to our bug tracker at: <https://github.com/hfst/hfst/issues> — they genuinely wanna hear it, fr fr.

• hfst-strings2fst home page: <https://github.com/hfst/hfst/wiki/Strings2Fst>
• 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. (read it again. no warranty. she said what she said.)

---

and that's the whole page, bestie 💖 this was the HFST hfst-strings2fst(1) manual, dated August 2018, from the HFST project — go forth and compile those string pairs, you absolute main character 🎀✨🦋