--- title: "Troubleshoot subject calibration" canonical: "https://help.vicon.com/space/ShogunLive121/1253212299/Troubleshoot%20subject%20calibration" format: markdown --- This troubleshooting section covers the following aspects of creating and calibrating a subject in Shogun Live. > Macro (toc) > Macro (scroll-pagebreak) ## A-pose booting ### My subject doesn't pass the A-pose detection stage Look in the log for an explanation as to why the A-pose cannot be detected or why it has been rejected. - Are any markers reported as missing? If yes: - Is the correct skeleton template being used? - Are all the required markers are attached to the subject? - Does the subject calibration volume include all the reconstructions? - **Reminder**: Missing markers will glow red. - Does the subject also seem to have labeling issues? If yes: - If labeling clusters are attached to the subject, have you created them in Shogun? Have you verified that the labeling clusters you have created are selected? - Is the subject standing in a valid A-pose? A valid A-pose assumes that the subject: - Stands straight - Has their feet pointing forward (ie, the feet are not splayed) - Has their palms pointing to the floor - Poses their arms at an angle of 45 degrees from the trunk - Poses their arms in such a way that they lie in the plane of the torso. - Are there any joints reported as out-of-range? If yes: - Is the A-pose valid (see the above criteria)? - Is the A-pose still rejected after you've completed all the previous checks? If yes: - In the **Tracking **panel, on the **Setup** tab ensure the advanced options are displayed > Macro (inline-media-image) . - Go to the **Subject Calibration** section, increase the value for **A-Pose Joint Range Threshold** (default value: 1.25) to 1.75 and check if this solves the issue. Note that subjects who cannot stand in an A-pose as well as small subjects usually require the higher threshold. If you don't need a higher threshold, use the default value. Use the joint coverage information in the Subject Calibration Feedback Panel to find any joints that cannot be found. The panel also displays how many markers are visible. For more information on joint coverage, see **Subject Calibration Feedback** in [Create a subject](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212380). > ![Joint coverage shown in Shogun Live 3D View and Subject Calibration Feedback panel.](media://73a0196a-1cc9-47a1-8c53-053c0e57d732) > Macro (scroll-pagebreak) ### The system says "Awaiting boot" This message means that the A-pose has been detected and successfully sent to the tracker subsystem. However the tracker subsystem is unable to label the subject from the current pre-calibrated skeleton. - Is the subject standing in a valid A-pose? - Does the subject calibration volume correctly exclude marker reconstructions that are not related to the subject under consideration? ## Subject calibration ### Calibration of the solving skeleton is jittery During live subject calibration, jittery refinements of the solving skeleton may occur with some subjects. Jittery refinements are unimportant as long as the subject obtained at the end of the calibration process is correct. ### The result of the solving skeleton calibration looks bad Capture a new ROM and ask the subject to: - Spend more time moving the legs, waist and arms first. Make sure that the motion includes all the joint capabilities. For example, lunging is not sufficient to calibrate the legs. Think of side motion as well and, if possible, intermediate poses obtained by rotating the thigh joints. - Remember that the more time that is spent on these limbs, the more frames the optimization process receives. - Avoid a ROM where legs are constantly static and only move in a limited way at the end of the ROM. Still observing issues? - Report the problem to [Vicon Support](mailto:support@vicon.com), with relevant data. In addition to helping to find a solution to your issue, your input also helps to improve solving skeleton calibration in future releases. - Use Shogun Post’s AutoSkeleton feature to obtain a new solving skeleton. Issues with the solving skeleton do not affect the labeling process during live subject calibration, so you can directly re-use the labeled ROM from Shogun Live for AutoSkeleton. ### The labeling clusters won’t attach to the subject Ensure at least 10 calibration frames are collected. Shogun only collects these frames if the ROM includes some motion. ### During subject re-calibration, the labeling clusters were detached from the subject This is expected behavior at the start of the re-calibration process. At least 10 calibration frames must be collected before labeling clusters are re-attached to the subject. This is not possible unless the ROM includes some motion. > Macro (scroll-pagebreak) > Macro (anchor) ### Shogun Live 1.7 and later – issues with custom skeletons earlier than VST 3.6 To use custom skeletons created in versions of Shogun earlier than 1.7 that use a VST that is earlier than 3.6: - Ensure that the VST version number is set to 3.6 or later. To set the version number for an older file, see [Upgrade a 3.5 subject to 3.6](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212299/Troubleshoot+subject+calibration#UpgradeVST) or watch the Vicon video: > Macro (inline-media-image) [How do I update my pipeline to use VST 3.6 skeletons?](https://www.youtube.com/watch?v=6NsNm9NdIy8) - Ensure that the custom skeleton is derived from a supplied Shogun template. - We recommend you keep the statistics intact for human skeletons. For each joint and target, import these fields from new templates: - MEAN - COVARIANCE - RANGE-CENTERING-STATE - RANGE - TPOSE-MEAN - TPOSE-COVARIANCE - Statistics generally remain appropriate if joint pre-rotations are not significantly changed. Also note that legacy skeletons are supported if: - VST version number is set to 3.6 or later (see above) - Statistics are updated using one of the new templates :check_mark: **Tip**: Correct population statistics are key to labeling quality. Manually changing the population statistics may result in labeling failures as well as booting failures across live subject calibration and the normal processing graph. Legacy skeletons may struggle to boot in Shogun Live if statistics are not updated. > Macro (scroll-pagebreak) ##### > Macro (anchor) Upgrade a 3.# subject to 3.7 To upgrade a subject that uses a custom skeleton saved in versions of Shogun earlier than 1.10, do one of the following: - **Use the Export preferences in Shogun Post:** - Import the VST into Shogun Post, and in the **Preferences** dialog, select the **Export** tab. - In the **File Format** field, select the required option (*.vst or *.vsk). - In the **Format options** area, change the **Version** to **3.7 [Shogun 1.10]** and close the dialog. - Export the file. - **Use a text editor:** - In a text editor, open the VST file and change the VERSION to 3.7. > Macro (anchor) ### Extreme poses of the actor's neck results in suboptimal neck solve In some cases, the Live calibration for the neck may not produce the required results for some extreme poses made by the actor. **To produce the best results for the neck solve:** 1. Use Shogun Post’s AutoSkeleton feature to obtain a new solving skeleton. See [Use Auto-Skeleton (marker-based mocap only)](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736922) in *Getting more from Vicon Shogun Post*. 2. Run the *CreateNeckConstraintSetup.hsl* script. For more information, see [Adjust neck constraints for better solving in extreme neck poses](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738145) in *Getting more from Vicon Shogun Post.* **To load your updated subject:** 1. At the top of the **Tracking** panel, click the **Import Subject **button. 2. Navigate to the location of the updated subject *.vsk* file. The default file path for subject files is: *C:\Users\Public\Documents\Vicon\Subjects* 3. Click **Open**. Your subject now uses the updated constraints.