fst-infl(1)

💖 fst-infl — ok bestie, it's the morphological analysers 💖

Like, hi?? Welcome to the manual page for fst-infl(1) — yes that's the manual section one, we're doing this properly. This is the group chat where fst-infl, fst-infl2 and fst-infl3 all hang out, and they're all morphological analysers. Grab a strawberry 🍓 and let's go.

✨ NAME ✨

fst-infl, fst-infl2, fst-infl3 — morphological analysers. That's it, that's the whole name section, three icon sisters 💅

🌸 SYNOPSIS 🌸

fst-infl [ options ] file [ input-file [ output-file ] ]
fst-infl2 [ options ] file [ input-file [ output-file ] ]
fst-infl3 [ options ] file [ input-file [ output-file ] ]

Three programs, one shape, no notes. Slay.

💅 OPTIONS 💅

Bestie, listen, there are a LOT of these, and every single one matters, so no skimming. Periodt.

• -t file — read an alternative transducer from file and use it if the main transducer fails to find an analysis. And ooh, the plot twist: if you iterate this option, you get a whole cascade of transducers being tried one after another until one of them finds an analysis. It's giving backup besties 🫶
• -b — print surface and analysis symbols. (fst-infl2 only)
• -n — print multi-character symbols without the enclosing angle brackets. (fst-infl only)
• -d — the analyses get symbolically disambiguated: it returns only analyses with a minimal number of morphemes. But heads up, this option requires that morpheme boundaries are marked with the tag <X>. If no <X> tag shows up in the analysis string, then the program (basically) counts the number of multi-character symbols consisting entirely of upper-case characters and uses that count for disambiguation. That second heuristic was developed for the German SMOR morphology, iykyk. (This option is only available with fst-infl2 and fst-infl3.)
• -e n — if no regular analysis is found, do robust matching and print analyses with up to n edit errors. The set of edit operations currently includes replacement, insertion and deletion, and each operation currently has a fixed error weight of 1. (fst-infl2 only)
• -% f — disambiguates the analyses statistically and prints the most likely analyses with at least f % of the total probability mass of the analyses. The transducer weights are read from a file obtained by appending .prob to the name of the transducer file. Those weight files are created with fst-train. (fst-infl2 only)
• -p — print the probability of each analysis. (fst-infl2 only)
• -c — use this one if the transducer was compiled on a computer with a different endianness. Like, real example: you have a transducer which was compiled on a Sparc computer and you want to use it on a Pentium — you need this option. (fst-infl2 only)
• -q — suppress status messages. Quiet queen behaviour 🤫
• -h — print usage information. The classic.

🦋 DESCRIPTION 🦋

fst-infl is a morphological analyser. The first argument is the name of a file which was generated by fst-compiler. The second argument is the name of the input file. The third argument is the output file. If the third argument is missing, output is directed to stdout. And if the second argument is missing, as well, input is read from stdin. So like, no arguments beyond the file? It'll just vibe with your terminal. 🎀

fst-infl2 is similar to fst-infl but it needs a transducer in compact format (see the man pages for fst-compiler and fst-compact). And here's the tea: fst-infl2 is implemented differently from fst-infl and usually much faster. Speed demon energy 🔥

fst-infl3 is also similar to fst-infl but it needs a transducer in lowmem format (see the man pages for fst-compiler and fst-lowmem). fst-infl3 accesses the transducer on disc rather than reading it into memory. It starts very fast and needs very little memory, but it is slower than fst-infl2. Trade-offs, bestie, we all have them 💀

fst-infl reads the transducer which is stored in the argument file. Then it reads the input file line by line. Each line is analysed with the transducer and all resulting analyses are printed (see also the man pages for fst-mor).

😭 BUGS 😭

No bugs are known so far. Not me being suspicious about that, but okay, we love a clean record ✨

🌈 SEE ALSO 🌈

• fst-compiler
• fst-mor

👑 AUTHOR 👑

Helmut Schmid, Institute for Computational Linguistics, University of Stuttgart, Email: schmid@ims.uni-stuttgart.de, This software is available under the GNU Public License.

Okay that's the whole page, you made it, I'm so proud of you 🥹💜 This was the fst-infl(1) manual, dated November 2004 — yes, a vintage icon, we stan a legacy queen — and that's the fst-infl(1) footer energy, mwah 💋