MetriCal Command: Plex MST

Usage

Plex MST - CLI Example

metrical plex mst [OPTIONS] [PLEX_OR_RESULTS_PATH]

Plex MST - Manifest Example

command = "plex-mst"
input-plex = "input.json"
output-plex = "{{auto}}"

Purpose

metrical plex mst converts the constraint graph(s) within a Plex into their Minimum Spanning Tree (MST) representations. The MST is the minimal set of constraints that keeps all components connected, chosen to minimize overall uncertainty (as measured by the covariance of each spatial constraint).

By default, plex mst computes the MST for both spatial and temporal constraints. Use --kind to limit the operation to one or the other.

This is the Plex-level equivalent of metrical shape mst, which operates on post-calibration results. Use metrical plex mst when you want to prune the constraint graph of a raw Plex before calibration.

Examples

Convert both spatial and temporal constraints to MST form

metrical plex mst input.json -o output.json

Convert only spatial constraints to MST form

metrical plex mst --kind spatial input.json -o output.json

Convert from stdin

cat input.json | metrical plex mst --kind temporal > output.json

Arguments

[PLEX_OR_RESULTS_PATH]

The path to the input Plex. If omitted, MetriCal will read the Plex from stdin.

Options

Global Arguments

As with every command, all global arguments are supported (though not all may be used).

--kind [KIND]

Which constraint graph(s) to convert to MST form. If omitted, both spatial and temporal constraints are converted. Possible values:

• spatial: Convert only the spatial constraint graph.
• temporal: Convert only the temporal constraint graph.

-o, --output [OUTPUT]

The path to output the resulting Plex. If omitted, MetriCal will write the Plex to stdout.