.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH HFST-SUBSTITUTE "1" "August 2018" "HFST" "User Commands"
.SH NAME
hfst-substitute \- =Relabel transducer arcs
.SH SYNOPSIS
.B hfst-substitute
[\fI\,OPTIONS\/\fR...] [\fI\,INFILE\/\fR]
.SH DESCRIPTION
Relabel transducer arcs
.SS "Common options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help message
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version info
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Print verbosely while processing
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Only print fatal erros and requested output
.TP
\fB\-s\fR, \fB\-\-silent\fR
Alias of \fB\-\-quiet\fR
.SS "Input/Output options:"
.TP
\fB\-i\fR, \fB\-\-input\fR=\fI\,INFILE\/\fR
Read input transducer from INFILE
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,OUTFILE\/\fR
Write output transducer to OUTFILE
.SS "Relabeling options:"
.TP
\fB\-f\fR, \fB\-\-from\-label\fR=\fI\,FLABEL\/\fR
replace FLABEL
.TP
\fB\-t\fR, \fB\-\-to\-label\fR=\fI\,TLABEL\/\fR
replace with TLABEL
.TP
\fB\-T\fR, \fB\-\-to\-transducer\fR=\fI\,TFILE\/\fR
replace with transducer read from TFILE
.TP
\fB\-F\fR, \fB\-\-from\-file\fR=\fI\,LABELFILE\/\fR
read replacements from LABELFILE
.TP
\fB\-R\fR, \fB\-\-in\-order\fR
keep the order of the replacements
(with \fB\-F\fR)
.SS "Input options:"
.TP
\fB\-C\fR, \fB\-\-do\-not\-convert\fR
require that transducers in TFILE and INFILE
have the same type
.SS "Transient optimisation schemes:"
.TP
\fB\-9\fR, \fB\-\-compose\fR
compose substitutions when possible
.PP
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.
.SH EXAMPLES
.IP
hfst\-substitute \-i tr.hfst \-o tr_relabeled.hfst \-f 'a' \-t 'A'
.IP
relabel all symbols 'a' with 'A'
.IP
hfst\-substitute \-i tr.hfst \-o tr_relabeled.hfst \-f 'a:b' \-t 'A:B'
.IP
relabel all arcs 'a:b' with 'A:B'
.IP
hfst\-substitute \-i tr.hfst \-o tr_relabeled.hfst \-f 'a:b' \-T repl.hfst
.IP
replace all arcs 'a:b' with transducer repl.hfst
.SH "REPORTING BUGS"
Report bugs to <hfst\-bugs@helsinki.fi> or directly to our bug tracker at:
<https://github.com/hfst/hfst/issues>
.PP
hfst\-substitute home page:
<https://kitwiki.csc.fi/twiki/bin/view/KitWiki//HfstSubstitute>
.br
General help using HFST software:
<https://kitwiki.csc.fi/twiki/bin/view/KitWiki//HfstHome>
.SH COPYRIGHT
Copyright \(co 2017 University of Helsinki,
License GPLv3: GNU GPL version 3 <http://gnu.org/licenses/gpl.html>
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.