HFST-SUBSTITUTE(1)

💅 hfst-substitute — the girlies' guide to hfst-substitute(1)

okay bestie, pull up a chair because this is a User Commands classic and it's about to be your new fave. this is hfst-substitute(1), and no cap, it does exactly one iconic thing and does it well. 🎀

---

✨ NAME ✨

hfst-substitute — =Relabel transducer arcs 💖

(yes, the = is in the original, we do not question the ancestors, we simply respect them 👑)

---

✨ SYNOPSIS ✨

hfst-substitute [OPTIONS...] [INFILE]

---

✨ DESCRIPTION ✨

Relabel transducer arcs. that's the whole vibe. you feed it a transducer, you tell it what to change and what to change it to, and it hands you back a transducer with the arcs relabeled. obsessed. 🌸

🫶 Common options:

• -h, --help — Print help message. your emotional support flag fr fr.
• -V, --version — Print version info. in case you need to know exactly which era of HFST you're living in.
• -v, --verbose — Print verbosely while processing. she talks through it, and honestly? we love that for her.
• -q, --quiet — Only print fatal erros and requested output. (that typo is heritage, bestie, don't touch it 💀)
• -s, --silent — Alias of --quiet. same energy, different name. main character but undercover.

🦋 Input/Output options:

• -i, --input=INFILE — Read input transducer from INFILE. bring her in 💜
• -o, --output=OUTFILE — Write output transducer to OUTFILE. send her out into the world ✨

💅 Relabeling options:

• -f, --from-label=FLABEL — replace FLABEL. this is the thing you're hunting for.
• -t, --to-label=TLABEL — replace with TLABEL. this is the glow-up you're giving it.
• -T, --to-transducer=TFILE — replace with transducer read from TFILE. not a label, a whole entire transducer. it's giving upgrade.
• -F, --from-file=LABELFILE — read replacements from LABELFILE. bulk mode. efficient queen. 🍓
• -R, --in-order — keep the order of the replacements (with -F). respect the queue, periodt.

🌈 Input options:

• -C, --do-not-convert — require that transducers in TFILE and INFILE have the same type. she does NOT want to do conversions today. 🙈

⭐ Transient optimisation schemes:

• -9, --compose — compose substitutions when possible. speedrun strats, iykyk.

---

If OUTFILE or INFILE is missing or -, standard streams will be used. Format of result depends on format of INFILE. LABEL must be a symbol name in single arc in transducer, or colon separated pair defining an arc. If TFILE is specified, FLABEL must be a pair. LABELFILE is a 2 column tsv file where col 1 is FLABEL and col 2 gives TLABEL specifications.

like, read that twice, it's load-bearing bestie 😭

---

✨ EXAMPLES ✨

hfst-substitute -i tr.hfst -o tr_relabeled.hfst -f 'a' -t 'A'

relabel all symbols 'a' with 'A' — the little letters get the big letter treatment 🔥

hfst-substitute -i tr.hfst -o tr_relabeled.hfst -f 'a:b' -t 'A:B'

relabel all arcs 'a:b' with 'A:B' — pair goes in, pair comes out, symmetric slay 💖

hfst-substitute -i tr.hfst -o tr_relabeled.hfst -f 'a:b' -T repl.hfst

replace all arcs 'a:b' with transducer repl.hfst — full arc replacement, we're not playing around 💅

---

✨ REPORTING BUGS ✨

found something cursed? don't suffer in silence, tell the devs 🫶

Report bugs to <hfst-bugs@helsinki.fi> or directly to our bug tracker at: <https://github.com/hfst/hfst/issues>

• hfst-substitute home page: <https://github.com/hfst/hfst/wiki/HfstSubstitute>
• 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. (no cap, there is genuinely no warranty, she's free and she's honest about it 💀)

---

and that's the whole page, bestie! 🎀 this drop is from the HFST squad, August 2018 edition — go relabel something gorgeous. bye babes 💖✨🦋