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
  • Clear Workspace
  • Load Video Data
  • Load Calibration File
  • Load Workspace
  • Save Workspace
  • Save Calibration
  • Save Model
  • Save Skeleton Poses
  • Save CMZ (Open in Visual3D)
  • Save Video Overlay
  • Save 3D View

Was this helpful?

Export as PDF
  1. Theia3D Documentation
  2. Theia3D Dropdown Menus

File Menu

PreviousTheia3D Dropdown MenusNextAnalyze Menu

Last updated 16 days ago

Was this helpful?

Clear Workspace

Shortcut: Ctrl + F4

Clear all loaded data and analysis results.


Load Video Data

Shortcut: Ctrl + O

Load video files (MP4 or AVI) for analysis. To load the videos, browse to and select the folder containing the videos. The structure of this folder must conform to the format described in .


Load Calibration File

Shortcut: Ctrl + Shift + O

Load the camera calibrations for analysis. To load the calibrations, browse to and select the file containing the calibrations for all of the cameras. The calibration file must conform to the format described in .


Load Workspace

Open a previously saved workspace. To load the workspace, browse to and select the directory containing the workspace files (AVI, T3D, P3D).


Shortcut: Ctrl + S

Save the videos, camera calibration, and analysis results in the current workspace to a directory in a format that can be opened by Theia3D. Select the frames to include in the workspace and press the Save button. Browse to the desired save location and enter the name of the directory that will be created to store the workspace files. To overwrite the current workspace, use the dialog to select a .t3d file in the existing workspace folder. Note that this only overwites the results (T3D and P3D files) and leaves the videos untouched. In this case, all frames in the workspace must be saved. It is not possible to save to an existing workspace folder other than the currently open one.

‍


Save the current calibration. To save the calibration browse to the desired save location and enter the desired filename.


Save the scaled 3D model. To save the scaled model browse to the desired save location and enter the desired filename. Note that if multiple people are tracked a separate model will be saved for each of them. The files are automatically named as filename_personID.tmb, where personid is automatically assigned.


Shortcut: Ctrl + Shift + S, 1

For C3D files there is an option to Save multi-subject C3D. If this option is selected, two C3D files will be created - one with the unfiltered pose and one with the filtered pose. Both files will contain all tracked subjects. If the multi-subject option is not selected, separate files will be created for each tracked subject.

‍

‍

For JSON files the user can select which tracked individuals and which frames of the trial to include in the output file. The JSON output files are easily readable in a text editor or used as input for a custom analysis script.

‍

With the desired options selected, press the Save button, browse to the save location and enter the filename. The person ID and filtered tag are appended to the filename as needed.


Opens the pose data for all tracked people in Visual3D.

Note: The filtered poses are loaded into Visual3D, and the path to the Visual3D executable must be set correctly in the settings dialog. We strongly recommend an active support agreement for Visual3D, as it is frequently updated to support the latest Theia model changes.


Shortcut: Ctrl + Shift + S, 2

Note:

  • Individual 2D view overlays can be saved as videos by Ctrl + right-click on the 2D view to be saved.

  • The grid of all 2D view overlays can be saved as a single video by Ctrl + Shift + right-click in the 2D view area.


The 3D view can also be saved by Ctrl + right-clicking on the 3D viewer area.

Workspaces created using Theia3D v2023 or earlier versions are incompatible with subsequent versions of Theia3D (Apollo v2024 and Axiom v2025). Any such workspaces should be reproduced by re-analyzing the raw data using an updated version of Theia3D. If the raw data is no longer available, it can be extracted from the existing workspaces using the tool in Theia3D Batch.

Save Workspace

Save Calibration

Save Model

Save Skeleton Poses

Save the 3D pose of the tracked people. Select the person (or all people) and the frame range (or select the option to use the analysis frames) to save in the file. Files can be saved in C3D, FBX, or JSON format. The data included in the files is described in.

For FBX files there is an option to select the exported coordinate system. Preset options are available for common software programs or custom coordinate system can be defined. Saving an FBX file requires the to be used when solving the pose.

Save CMZ (Open in Visual3D)

Save Video Overlay

Save each of the 2D view video overlays as an AVI file. The videos saved are identical to the overlays shown in Theia3D; therefore, you should modify the options that affect the 2D visualizations in the and before saving video overlays. Select the desired frame rate and the frame range (or select the option to use the analysis frames) of the videos and click the Save button. Browse to the desired save location and enter the desired filename. One video file will be saved for each overlay and the files are automatically named as filename_cameraID.avi.

Save 3D View

Save the 3D scene as an AVI video file. The video saved is identical to the 3D view shown in the 3D Viewer; therefore you should modify the options that affect the 3D visualizations in the and before saving before saving 3D View videos. Select the desired frame rate and the frame range of the videos and press the Save button. Browse to the desired save location and enter the desired filename.

Model Reference
full body model
Display Menu
Settings Menu
Display Menu
Settings Menu
Video Data
Camera Calibration
Convert Workspaces
Save Workspace
Save pose dialog for C3D files.
The save pose dialog for FBX files.
Save pose dialog for JSON files.
Save Videos dialog.
Save 3D View dialog.