Description

Sets the labeling subject calibration options. Replaces deprecated command calibrateCharacterOptions.

The subject calibrator can adjust parameter values (affecting constraints and bones using parameters), preferred pose, joint range, and marker covariance.

The -calibrationMode flag allows the number of those properties that will be altered to be set. The importance of the rest importance, constraint offsets, and bone parameters, can also be specified. For instance, if you know the bone lengths of the skeleton to be calibrated are already very accurate (either due to manual setup or a previous calibration) you may decide to either not calibrate bone length by adding the -calibrationMode "markersOnly" option or you may put a high importance on the bone lengths so they are not greatly changed by setting the segment importance higher.

Functional area

Labeling

Command syntax

Syntax

calibrateLabelingSubjectOptions [-jointImportance float] [-markerImportance float] [-segmentImportance float] [-quality string] [-activeFrames integer] [-calibrationMode string] [-jointStatsMode string] [-autoSaveVsk boolean] [-autoSavePreCalHDF boolean] [-overwriteRangeTemplates boolean] [-showCovariance boolean] [-restoreDefaultSettings]

Arguments

None

Flags

Name	Flag args	Argument type	Excl to	Comments
`jointImportance`	1	float	—	Specifies the strength of the jointImportance during the calibration.
`markerImportance`	1	float	—	Specifies the importance of the constraint parameters during the calibration.
`segmentImportance`	1	float	—	Specifies the importance of the bone parameters during the calibration.
`quality`	1	string	—	Speed vs. quality tradeoff. Options are: fast, normal, accurate.
`activeFrames`	1	integer	—	Specifies how many frames the calibrator samples. The default is 150. The minimum is 100. This number of frames is only for part of the calibration. Other parts of the calibration sample more frames and cannot be adjusted.
`calibrationMode`	1	string	—	Specifies what the calibrator will change; everything (full), markersOnly, or preferred pose, joint range, and marker covariance (statsOnly).
`jointStatsMode`	1	string	—	Has options for setting how joint statistics are used.
`autoSaveVsk`	1	boolean	—	When set to true, a VSK file is automatically saved to disk after calibration is complete.
`autoSavePreCalHDF`		boolean		Saves an HDF of the scene before calibration.
`overwriteRangeTemplates`		boolean
`showCovariance`	1	boolean		When set to true, labeling constraint covariance is automatically displayed after calibration.
`restoreDefaultSettings`	0	—	—	Resets the options to their default settings.

Return value

void

Examples

// Given a skeleton setup with already good bone lengths set the
// calibrator options so the bones will not be altered during
// calibration. 
calibrateLabelingSubjectOptions -calibrationMode "markersOnly";
 
// Now calibrate the selection
calibrateLabelingSubject;

Additional information

Related commands

Browser not supported