NAME

     lt-proc — lexical processor for Apertium

SYNOPSIS

     lt-proc [-a | -b | -o | -c | -d | -e | -g | -h | -p | -s | -t | -v | -h | -z | -w] [-W] [-N -N] [-L -N]
             [-i icx_file] fst_file [input_file [output_file]]

DESCRIPTION

     lt-proc is the application responsible for providing the four lexical processing functionalities:

     •   morphological analyser (option -a)

     •   lexical transfer (option -n)

     •   morphological generator (option -g)

     •   post-generator (option -p)

     It accomplishes these tasks by reading binary files containing a compact and efficient representation of
     dictionaries (a class of finite-state transducers called augmented letter transducers).  These files are
     generated by lt-comp(1).

     It is worth mentioning that some characters (‘[’, ‘]’, ‘$’, ‘^’, ‘/’, ‘+’) are special chars used for
     format and encapsulation.  They should be escaped if they have to be used literally, for instance:
     ‘[’...‘]’ are ignored and the format of a linefeed is ‘^...$’.

OPTIONS

     -a, --analysis
             Tokenizes the text in surface forms (lexical units as they appear in texts) and delivers, for each
             surface form, one or more lexical forms consisting of lemma, lexical category and morphological
             inflection information.  Tokenization is not straightforward due to the existence, on the one hand,
             of contractions, and, on the other hand, of multi-word lexical units.  For contractions, the system
             reads in a single surface form and delivers the corresponding sequence of lexical forms.  Multi-
             word surface forms are analysed in a left-to-right, longest-match fashion.  Multi-word surface
             forms may be invariable (such as a multi-word preposition or conjunction) or inflected (for
             example, in es, “echaban de menos”, “they missed”, is a form of the imperfect indicative tense of
             the verb “echar de menos”, “to miss”).  Limited support for some kinds of discontinuous multi-word
             units is also available.  Single-word surface forms analysis produces output like the one in these
             examples:

             “cantar” → “^cantar/cantar<vblex><inf>$” or “daba” →
             “^daba/dar<vblex><pii><p1><sg>/dar<vblex><pii><p3><sg>$”.

     -b, --bilingual
             Does lexical transference, attaching queues of morphological symbols not specified in the
             dictionaries.  As the analysis mode, supports multiple lexical forms in the target language for a
             given lexical form in the source language.  Works typically with the output of
             apertium-pretransfer(1).

     -o, --surf-bilingual
             As with -b, but takes input from apertium-tagger(1) -p, with surface forms, and if the lexical form
             is not found in the bilingual dictionary, it outputs the surface form of the word.

     -c, --case-sensitive
             Use the literal case of the incoming characters

     -d, --debugged-gen
             Morphological generation with all the stuff

     -e, --decompose-compounds
             Try to treat unknown words as compounds, and decompose them.

     -w, --dictionary-case
             Use the case information contained in the lexicon, instead of the surface case (only applied in
             analysis mode).

     -g, --generation
             Delivers a target-language surface form for each target-language lexical form, by suitably
             inflecting it.

     -n, --non-marked-gen
             Morphological generation (like -g) but without unknown word marks (asterisk ‘*’).

     -b, --tagged-gen
             Morphological generation (like -g) but retaining part-of-speech tags.

     -p, --post-generation
             Performs orthographical operations such as contractions and apostrophations.  The post-generator is
             usually dormant (just copies the input to the output) until a special alarm symbol contained in
             some target-language surface forms wakes it up to perform a particular string transformation if
             necessary; then it goes back to sleep.

     -s, --sao
             Input processing is in orthoepikon (previously sao) annotation system format:
             http://orthoepikon.sf.net.

     -t, --transliteration
             Apply a transliteration dictionary

     -i icx_file, --ignored-chars icx_file
             Ignores characters specified in the file icx_file

     -z, --null-flush
             Flush output on the null character

     -C, --careful-case
             Use dictionary case if present, else surface

     -N, --analyses
             Output no more than N analyses (if the transducer is weighted, the N best analyses)

     -L, --weight-classes
             Output no more than N best weight classes (where analyses with equal weight constitute a class)

     -W, --show-weights
             Print final analysis weights (if any)

     -v, --version
             Display the version number.

     -h, --help
             Display this help.

FILES

     input_file
             The input compiled dictionary.

SEE ALSO

     apertium(1), apertium-tagger(1), lt-comp(1), lt-expand(1)

COPYRIGHT

     Copyright © 2005, 2006 Universitat d'Alacant / Universidad de Alicante.  This is free software.  You may
     redistribute copies of it under the terms of the GNU General Public License:
     https://www.gnu.org/licenses/gpl.html.

BUGS

     Many... lurking in the dark and waiting for you!