Troubleshooting labeling skeleton templates

If your labeling skeleton template does not automatically label your subject, review the following symptoms and recommendations.

Symptoms and recommendations

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:
  
  1. On the Subjects tab in the Resources pane, expand the relevant subject's node.
  2. 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.
  3. 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 (custom labeling skeleton templates only)
  • Save a custom labeling skeleton template (custom labeling skeleton templates only)
  • Specify measurements for a subject, as described in Create a new subject from a template in the Vicon Nexus User Guide.
• Is the Subjects display enabled in the view Options?
  
  1. Press F7, or from the Window menu choose Options.
  2. 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?
  1. In the System Resources pane, select Local Vicon System.
  2. 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.
  
  1. In the System Resources pane, select Local Vicon System.
  2. 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.