evaluate-distance

Synopsis

evaluate-distance <target> <source> [<output>] [options]

Description

Evaluate distance between two given point sets. With increased verbosity (see evaluate-distance -v), the mean and standard deviation of the measured distances (verbosity level >=1) and the individual distance for each target point is reported (verbosity level >=2).

Arguments

target

Target point set/surface.

source

Source point set/surface.

output

Output point set/surface with point data array of measured distances. (default: none)

Command options

-mask-name <name>

Name of input mask. (default: none)

-mask-erosion <n>

Number of iterations of mask erosions. (default: 0)

-mask-dilation <n>

Number of iterations of mask dilations. (default: 0)

-pad-value, -padding-value <value>

Floating point value for points with zero mask value. (default: NaN)

-undef-value, -undefined-value <value>

Value for undefined distance measures, e.g., normal does not intersect source. (default: NaN)

-nan-value <value>

Set both -pad-value and -undef-value to the specified value.

-dist-name, -name, -array <name>

Name of output point data array or column header. (default: Distance)

-digits, -precision <n>

Number of digits after the decimal point to print/write. (default: 5)

-table [<name>|stdout|cout|print]

Write statistics of distance measure in table format to named output file. When <name> is ‘stdout’, ‘cout’, or ‘print’, print table to standard output stream. (default: off)

-append, -noappend

Whether to append row to existing -table file. If table file exists, skip header and write measurements only. (default: off)

-header, -noheader

When -table given, write table header before row of measurements. (default: on)

-delim, -delimiter, -sep, -separator <str>

Column separator used for table of measured point distances. (default: t)

-point

Evaluate minimum distance to closest point. (default for point clouds)

-cell

Evaluate minimum distance to closest surface point. (default for surface meshes)

-normal

Evaluate minimum distance along surface normal.

-index

Evaluate distance between points with identical index, e.g., pairs of fiducial markers.

-hausdorff

Report Hausdorff distance. (default: off)

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.

-revision

Print revision (or version) number only and exit.

-h, -help

Print help and exit.