---
title: "Troubleshooting labeling skeleton templates"
canonical: "https://help.vicon.com/space/Nexus212/11239578/Troubleshooting%20labeling%20skeleton%20templates"
format: markdown
---
If your labeling skeleton template does not automatically label your subject, review the following symptoms and recommendations.

> Macro (scroll-only)
> 
> > Macro (toc)

#### I have run the subject calibration operation, but cannot see the subject being fitted to the markers.

- Have all the markers in your labeling skeleton template been identified?  
For the subject calibration to succeed, all the markers specified in the template must be identified in the **3D Perspective** view. To see if you have successfully done this:
  - On the **Subjects** tab in the **Resources** pane, expand the relevant subject's node.
  - Expand the **Markers** sub node.  
Each marker in the labeling skeleton is displayed. Markers that have not been identified yet will be shown in gray text, whereas identified markers will be shown in black.
  - Label any unidentified markers.

- Is the subject's name under the subject node on the **Subjects** tab shown in red?  
The red color indicates that something is missing and that the labeling skeleton is incomplete. The reasons for this could be that either the labeling skeleton is not yet fully developed, for example, if links are missing between segments; or the required subject measurements have not been defined. If the subject name is displayed in red, review these procedures:
  - [Create the skeletal structure](https://vicon-help.atlassian.net/wiki/spaces/Nexus212/pages/11247789) (custom labeling skeleton templates only)
  - [Save a custom labeling skeleton template](https://vicon-help.atlassian.net/wiki/spaces/Nexus212/pages/11248303) (custom labeling skeleton templates only)
  - Specify measurements for a subject, as described in [Create a new subject from a template](https://vicon-help.atlassian.net/wiki/spaces/Nexus212/pages/11249927)in the *Vicon Nexus User Guide*.
- Is the **Subjects** display enabled in the view **Options**?
  - Press F7, or from the **Window** menu choose **Options**.
  - Below **General View Options**, ensure that **Subjects** is selected.

#### My subject calibrated, but it fails to automatically label in Live mode.

- Is the **Processing Output level** set to at least the **Labels** level?
  - In the **System Resources** pane, select **Local Vicon System**.
  - In the **Properties** section, make sure the **Processing Output level** parameter in the **General** section is set to **Labels** or **Kinematic Fit**.
- Is the correct subject selected?
  - On the **Subjects Resources** tab, make sure that the subject you created and calibrated is the only subject selected.
- Is the correct labeling skeleton template still attached to the subject?
  - On the **Subjects Resources** tab, check that the required labeling skeleton template name (on the right of the subject name, in parentheses) is still displayed.
- Is the **entrance threshold** for **Labeling completeness** set too high?  
The **Labeling completeness: entrance threshold** parameter specifies the proportion of markers that Vicon Nexus must recognize to start labeling. If it is set too high, labeling may fail altogether. Aim to achieve a balance between setting it too low (which may result in mis-labeling when the subject first enters the volume) or too high (which may result in failure to label due to Nexus not recognizing sufficient markers for labeling to start). The default value is 0.85.
  - In the **System Resources** pane, select **Local Vicon System**.
  - In the **Properties** pane, go to the **Labeling** section and lower the **Labeling completeness: entrance threshold** value.

- Did the subject calibration pipeline operation succeed?
  - Sometimes the subject calibration pipeline operation will fail, as indicated by a red X instead of a green check mark by the pipeline operation name in the **Pipeline Tools** pane.  
If it has failed, check the **Communications** pane **Log** tab for information as to why the failure occurred. Troubleshoot any error, and run the subject calibration pipeline again.
- You can help the auto labeling routine distinguish right from left by introducing asymmetry into your maker placement, for example, by placing one thigh marker higher than the other.

#### My subject calibrated but is not labeling well in Live mode.

Labeling problems are often caused by tracking skeleton problems so it is often worth reviewing the data used for calibration. If you have followed the recommended workflow, and labeling is not working well, try the following steps:

1. Try recalculating the subject statistics for the type of activity performed by the subject. For example, try manually labeling a trial of the subject performing the relevant activity, then running a **Calculate Skeleton Joint & Marker Statistics** pipeline operation to recalculate statistics for this particular subject, instead of using the defaults.
2. Try a full functional calibration, by capturing a ROM trial, manually labeling it, and running a **Functional Skeleton Calibration** pipeline operation. Note that this may take some time.
3. Open the **Options** dialog box (F7) and select **Subjects**. In the **Properties** pane on the right, select **Draw Covariances**.

If there are small covariance ellipsoids, this indicates that the calibration will produce good labeling. Large covariance ellipsoids may indicate that labeling quality may be unsatisfactory. Larger than expected covariance ellipsoids may be due to a poor subject calibration. This can be caused by the existence of an incorrect label in the calibration trial, or a need for further optimization of the labeling skeleton template.