Table Of Contents



match-points <target> <source> [options]


Writes for each point in a target point set its corresponding point in the source point set. The found correspondences can be either written to an output point set with indices and difference vectors stored as point data, or a text file listing for each target point index the index of the corresponding source point.



Target point set.


Source point set.

Command options

-dofin <file>

Target point set transformation. (default: none)


Find the closest point in the source data set. (default)


Find the closest cell point in the source data set.

-cor <name>

Name of correspondence type, e.g., ‘closest point’, ‘closest cell’.

-corpar <name> <value>

Set parameter of chosen correspondence type.

-feature <name> [<weight>]

Use named point data as feature. (default: spatial coordinates)

-corin <file>

Read correspondences from text file which lists on each line the indices of corresponding target and source points.

-corout <file>

Write indices of corresponding points to text file.

-output <file>

Write point set of corresponding points.


Add a vertex cell for each point.


Add displacement vectors from corresponding output points to input target points. (default: off)


Store indices of corresponding points as point data. Indices are cell indices in case of -closest-cell.


Copy input point data to output point set. (default: off)


Copy input cell data to output point set. (default: off)

-compress, -nocompress

Whether to compress XML VTK file data. (default: on)


Write legacy VTK file in binary format. (default)


Write legacy VTK file in ASCII format.

Standard options

-v, -verbose [n]

Increase/Set verbosity of output messages. (default: 0)

-debug [level]

Increase/Set debug level for output of intermediate results. (default: 0)

-version [major.minor]

Print version and exit or set version to emulate.


Print revision (or version) number only and exit.

-h, -help

Print help and exit.

Terminal options

-color, -nocolor

Enable/disable colored output. (default: off)

Parallelization options

-threads <n>

Use maximal <n> threads for parallel execution. (default: automatic)