calibrateLabelingSubjectOptions
- Gisela Roberts
- Ben Stanley
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;
