NAME

gfsmarith - Perform an elementary arithmetic operation on automaton weights


SYNOPSIS

gfsmarith [OPTIONS] FSMFILE

 Arguments:
    FSMFILE  Stored binary gfsm file
 Options
    -h       --help            Print help and exit.
    -V       --version         Print version and exit.
    -cFILE   --rcfile=FILE     Read an alternate configuration file.
    -zLEVEL  --compress=LEVEL  Specify compression level of output file.
    -FFILE   --output=FILE     Specifiy output file (default=stdout).
 Operator Selection
    -E       --exp             Real exponentiation
    -L       --log             Real logarithm
    -mFLOAT  --multiply=FLOAT  Real multiplication by WEIGHT
    -aFLOAT  --add=FLOAT       Real addition of WEIGHT
    -p       --positive        Set real negative weights to zero
             --times=FLOAT     Semiring multiplication by WEIGHT
             --plus=FLOAT      Semiring addition of WEIGHT
             --sr-positive     Set semiring-negative weights to semiring-zero
 Weight Selection
    -A       --no-arcs         Exclude arc weights (default: include)
    -f       --no-finals       Exclude final weights (default: include)
    -Z       --zero            Include semiring-zero weights (default: exclude)
 State & Label Selection
    -i       --initial         Select only initial state and its arcs/finality
    -sID     --state=ID        Select only state ID and its arcs/finality (default=all)
    -lLO     --lower=LO        Select only arcs with lower-label LO (default=any)
    -uHI     --upper=HI        Select only arcs with upper-label HI (defualt=any)


DESCRIPTION

Perform an elementary arithmetic operation on automaton weights


ARGUMENTS

FSMFILE

Stored binary gfsm file

If unspecified, standard input will be read


OPTIONS

--help , -h

Print help and exit.

Default: '0'

--version , -V

Print version and exit.

Default: '0'

--rcfile=FILE , -cFILE

Read an alternate configuration file.

Default: 'NULL'

See also: CONFIGURATION FILES.

--compress=LEVEL , -zLEVEL

Specify compression level of output file.

Default: '-1'

Specify zlib compression level of output file. -1 (default) indicates the default compression level, 0 (zero) indicates no zlib compression at all, and 9 indicates the best possible compression.

--output=FILE , -FFILE

Specifiy output file (default=stdout).

Default: '-'

Operator Selection

--exp , -E

Real exponentiation

Default: '0'

--log , -L

Real logarithm

Default: '0'

--multiply=FLOAT , -mFLOAT

Real multiplication by WEIGHT

Default: '0'

--add=FLOAT , -aFLOAT

Real addition of WEIGHT

Default: '0'

--positive , -p

Set real negative weights to zero

Default: '0'

--times=FLOAT

Semiring multiplication by WEIGHT

Default: '0'

--plus=FLOAT

Semiring addition of WEIGHT

Default: '0'

--sr-positive

Set semiring-negative weights to semiring-zero

Default: '0'

Weight Selection

--no-arcs , -A

Exclude arc weights (default: include)

Default: '0'

--no-finals , -f

Exclude final weights (default: include)

Default: '0'

--zero , -Z

Include semiring-zero weights (default: exclude)

Default: '0'

State & Label Selection

--initial , -i

Select only initial state and its arcs/finality

Default: '0'

--state=ID , -sID

Select only state ID and its arcs/finality (default=all)

Default: '-1'

--lower=LO , -lLO

Select only arcs with lower-label LO (default=any)

Default: '-1'

--upper=HI , -uHI

Select only arcs with upper-label HI (defualt=any)

Default: '-1'


CONFIGURATION FILES

Configuration files are expected to contain lines of the form:

    LONG_OPTION_NAME    OPTION_VALUE

where LONG_OPTION_NAME is the long name of some option, without the leading '--', and OPTION_VALUE is the value for that option, if any. Fields are whitespace-separated. Blank lines and comments (lines beginning with '#') are ignored.

No configuration files are read by default.


ADDENDA

About this Document

Documentation file auto-generated by optgen.perl version 0.05. Translation was initiated on Thu Feb 15 17:41:26 CET 2007 as:

   /usr/local/bin/optgen.perl -l --nocfile --nohfile -F gfsmarith gfsmarith.gog


BUGS AND LIMITATIONS

Note that the --plus and --times operations are sensitive to the semiring associated with the stored FSM file, while the --add and --multiply operations have the usual real-number interpretations, regardless of the automaton semiring.


ACKNOWLEDGEMENTS

Perl by Larry Wall.

Getopt::Gen by Bryan Jurish.


AUTHOR

Bryan Jurish <moocow@ling.uni-potsdam.de>


SEE ALSO

the gfsmutils manpage