LogoLogo
WebsiteResource HubDownloadBook a DemoContact Support
Theia Axiom - v2025
Theia Axiom - v2025
  • Theia3D Documentation
    • What's New
    • Theia3D Documentation
    • Welcome to Theia3D
    • Keyboard Shortcuts
    • Getting Started
      • System Requirements
      • Installation
      • License Activation
      • Startup Window
      • Theia3D Basics
      • Camera Setup Tips
      • Tutorial Videos
    • Data Collection
      • Data Collection Principles
      • Recording Intrinsic Lens Calibrations
      • Recording Extrinsic Chessboard Calibrations
      • Recording Extrinsic Object Calibrations
    • Theia3D Interface
    • Theia3D Dropdown Menus
      • File Menu
      • Analyze Menu
      • Display Menu
      • Results Menu
      • Calibration Menu
        • Check Calibration
        • Lens Calibration
        • Chessboard Calibration
        • Object Calibration
        • Adjust Calibration
      • Tools Menu
        • Check Synchronization
        • Organize Videos
        • Format Sony Multicam
        • Assign Calibration Files
        • Modify People IDs
        • Toggle Views
        • Display Video Metadata
        • Enhance Videos
      • Settings Menu
        • Settings Menu
        • Analysis Preferences
        • Rendering Preferences
        • Setup Preferences
      • Help Menu
    • Theia Model Description
      • Default Model Description
      • Full Body Model Description
      • Separate Arm and Head Model Description
    • Data Formats
      • Video Data
      • Calibration Files
      • Theia3D Workspaces
      • C3D Files
      • FBX Files
      • JSON Files
      • Video Overlays
    • Theia3D Batch
      • Theia3D Batch Interface
      • Setting Up a Batch
      • File Menu
      • Help Menu
      • Settings
      • Trials
      • Preferences
      • Batch Processing Outputs
    • Camera System Requirements
    • Sony Camera Package
      • Components
      • System Setup
      • Data Collection
  • Troubleshooting
    • Troubleshooting Documentation
    • Error Messages
      • License Errors
        • License Activation Failed
      • Organize Data Errors
        • Input directory has no mp4 or avi files
      • Load Video Data Errors
        • Videos not formatted properly
        • Only [#] videos found
        • Videos are not the same length
        • Unsupported video codec detected
        • Invalid video
      • Load Calibration File Errors
        • Unable to load calibration
        • Required camera parameter groups not present
      • Load Workspace Errors
        • Selected folder does not contain a valid Theia workspace
        • Incompatible workspace
      • Calibration Errors
        • Camera extrinsics optimization step 3 failed
        • Unable to detect chessboard in overlapping frames for all cameras
        • Too few chessboards detected (<25)
        • Field of view coverage insufficient (<60%)
      • Movement Trial Processing Errors
        • Track people not complete
        • Abnormally high tracking errors
    • Visible Issues
      • Coordinate system is out of place in one camera view
      • Coordinate system is in different positions and/or orientations in all camera viewse
      • Coordinate system is in an incorrect but consistent position and/or orientation in all views
      • Skeleton is consistently outside the body
      • Skeleton is momentarily incorrect
      • Skeleton is incomplete
      • Skeleton is completely missing
      • Skeleton is jittery
    • Sony Troubleshooting
      • Initialization Issues
      • Unstable Connection
    • Other Issues
Powered by GitBook

Links

  • About
  • Terms of Use
  • Privacy Policy

Resources

  • Download
  • FAQ
  • Blog
On this page
  • Explanation
  • Possible Solutions

Was this helpful?

Export as PDF
  1. Troubleshooting
  2. Visible Issues

Skeleton is incomplete

PreviousSkeleton is momentarily incorrectNextSkeleton is completely missing

Last updated 17 days ago

Was this helpful?

Explanation

In general, the 3D skeleton appears to be incomplete when one independent part of the kinematic chain cannot be tracked. The body parts that are able to disappear will depend on the joint constraints you have selected in the Analysis section of the , and the cause of their disappearance can vary.

For example, when Seperate Arm and Head is not selected, the shoulder joint is modelled with 3 degrees of freedom (DOF), allowing full rotational freedom but no translation of the upper arm relative to the torso. Therefore, if one of the arms cannot be tracked, then the entire left arm + torso + right arm chain will disappear. However, if Seperate Arm and Head model is selected the shoulder joint is modelled with 6 DOF, allowing the arms to be tracked independently of the torso. This allows any of the left arm/torso/right arm segments to be tracked, even if one of the other segments cannot be tracked.

There are several reasons why a body segment may disappear in a processed movement trial:

  1. The Smoothing Frequency is set too low.

If the Smoothing Frequency is set too low, it is possible for the moving body part(s) to be detected as an outlier and excluded from the tracking. This typically occurs when the movement is very fast and the Smoothing Frequency is set relatively low.

  1. The body segment is not sufficiently visible to be tracked reliably.

If the body segment is occluded or otherwise difficult to discern in the videos due to poor lighting, dark clothing, a challenging pose, or other factors, it may not be possible to track the segment reliably and it will disappear.

Possible Solutions

Some possible solutions for incomplete skeleton tracking are as follows:

  1. Increase the Smoothing Frequency.

If the cause of the incomplete skeleton is a low Smoothing Frequency resulting in the body segment being detected as an outlier, try increasing the Smoothing Frequency to allow the movement to be tracked. After adjusting the Smoothing Frequency in the , you only need to run the analysis step to view the updated pose results.

  1. Use the tool to improve the video quality.

If the videos are too dark or not properly white-balanced, they may be improved using the Enhance Videos tool. This can improve the visibility of body segments and improve tracking quality. After adjusting these settings, you will need to use the button to perform all analysis steps.

  1. Improve the quality of the data recorded by your camera system.

If the data quality is insufficient to be able to clearly see all body segments, try improving the quality of the data collected by your camera system. You may need to make adjustments such as increasing the amount of ambient light, increasing the camera resolution, selecting appropriate frame rate and exposure settings, or moving the cameras closer to the participant to capture them with higher resolution.

Preferences window
Preferences window
Enhance Videos
Solve Skeleton
Run Analysis