Description

This command packs unlabeled trajectories.

Packing is the process of copying all of the data from one trajectory onto an "empty" area on another trajectory. This is useful when you have many small trajectories and are saving out C3D files, as C3D files are very inefficient when saving out files with many small trajectories.

Use packing on gap-less trajectories only, or when you don't wish to preserve the gaps in trajectories, because the unpacking process will treat each contiguous key range as a new trajectory.

Functional area

Data editing

Command syntax

Syntax

pack [-minGap integer] [-minDistance float] [-marker string]

Arguments

None

Flags

Name	Flag arguments	Argument type	Exclusive to	Comments
`minGap`	1	integer	—	Specifies the minimum amount of frames to leave between two trajectories. The default value is 1 if not specified.
`minDistance`	1	float	—	Specifies the minimum distance, in millimeters, between the end of one trajectory and the start of another trajectory to allow them to be packed next to each other. The default value is 0 millimeters if not specified.
`marker`	1	string	—	If specified, only this trajectory will be packed. Otherwise all selected unlabeled trajectories will be packed.

Return value

void

Examples

// This selects and packs unlabeled trajectories in the scene and
// ensures that there is a 1 frame gap between each packed trajectory,
// and that each trajectory is 100 mm away from the end of the previous
// trajectory
selectByName "_*" -type Marker;
pack -minGap 1 -minDistance 100;
 
// This packs only the unlabeled trajectory _5 onto one of the
// selected unlabeled trajectories.
// It uses default values for the rest of the options
pack -marker _5;

Additional information

Related commands

unpack