This information is for Vicon Shogun 1.7. For up-to-date help, see the latest Shogun documentation.

Vicon Shogun banner


Finds and selects keys that deviate over a tolerance between the active clip and another clip. Both clips must have a key at each frame for the comparison to be done.

This is useful when comparing the results of an editing operation with the second figure clip.

Functional area

Data retrieval

Command syntax


findDeviantKeys compareClip tolerance length [-ranges] [-primaryOnly] [-selectRanges] [-noFeedback] [-positionOnly] [-rotationOnly]


compareClipstringyesName of the clip to compare with.
tolerancefloatyesValue in millimeters that key values must be deviant to be selected.
lengthintegeryesNumber of consecutive frames that keys must be deviant to be selected.


NameFlag argumentsArgument typeExclusive toComments
ranges0Restricts the search to the selected time ranges. The default is to search the entire animation range.
primaryOnly0Restricts the search to the primary selected node. The default is to search all selected nodes.
selectRanges0Specifies that the ranges of the deviant keys should be selected as well.
noFeedback0Set this flag to skip writing the results of the operation to the log
positionOnly0primaryOnly, selectRangesCheck position deviance only, ignoring rotational deviance
rotationOnly0ranges, selectRangesCheck rotational deviance only, ignoring positional deviance

Return value


Returns the number of deviant keys


// Import a file and create a second figure
loadFile "C:/temp/myFile.c3d" -i -createSecondFig;

// Select and filter the head markers using the current filter settings
selectRange -all;filter;

// Now select the keys that deviate from the second figure clip
// by at least 5 mm over at least 10 consecutive keys. Also select the deviant ranges.
findDeviantKeys myFilec3d_2fg 5 10 -selectRanges;
// Do something with those keys/ranges!

Additional information

Related commands