---
name: "hfst-substitute"
section: "1"
platform: "linux"
package: "hfst"
version: "3.16.2-1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/hfst-substitute"
---

# hfst-substitute(1)

\=Relabel transducer arcs

## NAME

hfst-substitute - =Relabel transducer arcs

## SYNOPSIS

**hfst-substitute** \[*OPTIONS*...\] \[*INFILE*\]

## DESCRIPTION

Relabel transducer arcs

### Common options:

- **-h**, **--help**

  Print help message

- **-V**, **--version**

  Print version info

- **-v**, **--verbose**

  Print verbosely while processing

- **-q**, **--quiet**

  Only print fatal erros and requested output

- **-s**, **--silent**

  Alias of **--quiet**

### Input/Output options:

- **-i**, **--input**=*INFILE*

  Read input transducer from INFILE

- **-o**, **--output**=*OUTFILE*

  Write output transducer to OUTFILE

### Relabeling options:

- **-f**, **--from-label**=*FLABEL*

  replace FLABEL

- **-t**, **--to-label**=*TLABEL*

  replace with TLABEL

- **-T**, **--to-transducer**=*TFILE*

  replace with transducer read from TFILE

- **-F**, **--from-file**=*LABELFILE*

  read replacements from LABELFILE

- **-R**, **--in-order**

  keep the order of the replacements (with **-F**)

### Input options:

- **-C**, **--do-not-convert**

  require that transducers in TFILE and INFILE have the same type

### Transient optimisation schemes:

- **-9**, **--compose**

  compose substitutions when possible

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.

## EXAMPLES

-

  hfst-substitute -i tr.hfst -o tr\_relabeled.hfst -f 'a' -t 'A'

-

  relabel all symbols 'a' with 'A'

-

  hfst-substitute -i tr.hfst -o tr\_relabeled.hfst -f 'a:b' -t 'A:B'

-

  relabel all arcs 'a:b' with 'A:B'

-

  hfst-substitute -i tr.hfst -o tr\_relabeled.hfst -f 'a:b' -T repl.hfst

-

  replace all arcs 'a:b' with transducer repl.hfst

## REPORTING BUGS

Report bugs to \<hfst-bugs@helsinki.fi\> or directly to our bug tracker at: \<https://github.com/hfst/hfst/issues\>

hfst-substitute home page: \<https://github.com/hfst/hfst/wiki/HfstSubstitute\>\
 General help using HFST software: \<https://github.com/hfst/hfst/wiki\>

## COPYRIGHT

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.