---
name: "pdtcompose"
section: "1"
platform: "linux"
package: "libfst-tools"
version: "1.8.4-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/pdtcompose"
---

# pdtcompose(1)

compose a PDT and an FST

## NAME

pdtcompose - compose a PDT and an FST

## SYNOPSIS

**pdtcompose** \[*OPTIONS*\] *in.pdt in.fst* \[*out.pdt*\]\
 **pdtcompose** \[*OPTIONS*\] *in.fst in.pdt* \[*out.pdt*\]

## DESCRIPTION

Composes a PDT and an FST.

## OPTIONS

Boolean options accept either *true* or *false* as a value, or the implicit value *true* if neither value is specified.

- **--compose\_filter=***STRING*

  **Composition filter, one of 'expand', 'expand\_paren', and 'paren'.** **Default: 'paren'.**

- **--connect\[=***BOOLEAN***\]**

  **Trim output.  Default: true.**

- **--fst\_align\[=***BOOLEAN***\]**

  **Write FST data aligned where appropriate.  Default: false.**

- **--fst\_compat\_symbols\[=***BOOLEAN***\]**

  **Require symbol tables to match when appropriate.  Default: true.**

- **--fst\_default\_cache\_gc\[=***BOOLEAN***\]**

  **Enable garbage collection of cache.  Default: true.**

- **--fst\_default\_cache\_gc\_limit=***N*

  **Set the cache byte size that triggers garbage collection.  Default: 1048576.**

- **--fst\_error\_fatal\[=***BOOLEAN***\]**

  **If true, FST errors are fatal.  Otherwise, returned objects are flagged as bad.** **For example, FSTs are returned with the** *kError* **property set to true, and** **FST weights set so that** *Member()* **returns false.  Default: true.**

- **--fst\_field\_separator=***STRING*

  **Set the characters used as a separator between printed fields.  Default:** **"	 ".**

- **--fst\_read\_mode=***STRING*

  **Set the default file reading mode for mappable files, either "read" or "map".** **Default: "read".**

- **--fst\_verify\_properties\[=***BOOLEAN***\]**

  **Verify fst properties queried by TestProperties.  Default: false.**

- **--fst\_weight\_parentheses=***STRING*

  **Set the characters enclosing the first weight of a printed composite weight** **(e.g., pair weight, tuple weight, and derived classes) to ensure proper I/O of** **nested composite weights.  Must have size 0 (none) or 2 (open and close** **parenthesis).  Default: no parentheses.**

- **--fst\_weight\_separator=***CHARACTER*

  **Set the character separator between printed composite weights.  Default: comma.**

- **--help\[=***BOOLEAN***\]**

  **Show usage information.  Default: false.**

- **--helpshort\[=***BOOLEAN***\]**

  **Show brief usage information.  Default: false.**

- **--left\_pdt\[=***BOOLEAN***\]**

  **First argument is the PDT if true, second argument if false.  Default: true.**

- **--pdt\_parentheses=***STRING*

  **Set the PDT parenthesis label pairs.**

- **--save\_relabel\_ipairs=***FILENAME*

  **Save input relabel pairs to file.  Default: do not save.**

- **--save\_relabel\_opairs=***FILENAME*

  **Save output relabel pairs to file.  Default: do not save.**

- **--tmpdir=***PATHNAME*

  **Set the temporary directory to use.  Default: /tmp.**

- **--v\[=***N***\]**

  **Set the verbosity level.  Default: 0.**

## SEE ALSO

*fstcompose***(1),** *pdtexpand***(1),** *pdtinfo***(1),** *pdtreplace***(1),** *pdtreverse***(1),** *pdtshortestpath***(1)**