HFST-PMATCH2FST(1)

📦
version 3.17.1 · 2 versions
  • 3.17.1 · debian bookworm, debian trixie, nixos 26.05, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 3.17.3 · nixpkgs unstable
, in debian bookworm, debian trixie, nixos 26.05, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 hfst-pmatch2fst — NAME 💖

okay so bestie, meet hfst-pmatch2fst — that's the star of this page, and the whole manual is filed under HFST-PMATCH2FST(1) in case you need to cite it in your group chat ✨

It compiles regular expressions into transducer(s). That's the vibe. That's the whole job. Periodt 💅

📜 SYNOPSIS 📜

hfst-pmatch2fst [OPTIONS...] [INFILE]

✨ DESCRIPTION ✨

It compiles regular expressions into transducer(s). Iconic behaviour, no notes 💖

Heads up: this is the (Experimental version). So like, it's giving "main character energy but still in beta" 🧚

🎀 Common options:

  • -h, --help — print the help message, the classic "pls explain urself" move 🫶
  • -V, --version — print version info, so you know exactly which era of this software you're dealing with ⭐
  • -v, --verbose — print verbosely while processing, aka it tells you everything it's doing, and honestly? we love a chatty king 👑
  • -q, --quiet — only print fatal erros and requested output (yes, "erros" — that's literally what it says in here, typo and all 🙈)
  • -s, --silent — this one is just an alias of --quiet, same energy, different name 🦋

🍓 Input/Output options:

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

🌸 String and format options:

  • -e, --epsilon=EPS — map EPS as zero 🎀
  • --flatten — compile in all RTNs 🌈
  • --cosine-distances — when compiling Like() operations, include cosine distance info 📐

lowkey important deets, bestie: if OUTFILE or INFILE is missing or is -, standard streams will be used. If EPS is not defined, the default representation of 0 is used.

and uh… Weights are currently not implemented. so don't come for me about weights, they're simply not on the menu 😭

🔥 EXAMPLES 🔥

the moment you've all been waiting for, the demo, the serve:

echo "Define TOP
       UppercaseAlpha Alpha* LC({professor}) EndTag(ProfName);" |
       hfst-pmatch2fst

This creates a matcher that tags "professor Chomsky" as "professor <ProfName>Chomsky</ProfName>". ate, honestly 👑

🐛 REPORTING BUGS 🐛

Found a bug? First of all, relatable, second of all, report it! Report bugs to <hfst-bugs@helsinki.fi> or directly to our bug tracker at: <https://github.com/hfst/hfst/issues> 💌

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. (that's the dramatic part, bestie — NO WARRANTY, all caps, they meant it 💀)

and that's a wrap, bestie! this little love letter to hfst-pmatch2fst comes to you from the HFST fam, dated August 2018 🌸 go forth and compile ur regular expressions into transducers, ily, mwah 💖✨

📦 where this page comes from