Skip to main content
Version: 18.0

Formations

Formations are a bit different from spatial and temporal constraints. While spatial and temporal constraints exist to model the physical realities of components in a system, formations exist to model relationships in the system that don't fall within those boundaries.

Formations are defined by the following fields:

Field
Type
Description
ComponentsAn array of component UUIDsA set of unique UUIDs (corresponding to components that exist within the plex) that are grouped under this formation.
NameStringThe name for these formations. Usually indicates the purpose or function of the group.
UUIDUUIDThe unique identifier for the formation.

Formations can label subplexes within a plex, label individual OEM pieces of hardware (e.g. labeling a single Intel RealSense device), or group together components that share some common function (e.g. grouping a stereo pair of cameras together).

Some formations can be used by MetriCal to generate unique kinds of metrics after calibration. These are identified purely through the formation's name field. For example, MetriCal currently understands the following formation kinds:

  • "stereo_pair": This denotes that two cameras are part of a stereo pair. This also tells MetriCal to compute stereo rectification metrics after a calibration is complete.