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

Was this helpful?

Export as PDF
  1. Theia3D Documentation
  2. Theia3D Dropdown Menus
  3. Tools Menu

Format Sony Multicam

PreviousOrganize VideosNextAssign Calibration Files

Last updated 17 days ago

Was this helpful?

Format Sony Multicam

The Format Sony Multicam tool is alternative approach to organizing video data recorded using a Sony RX0 II camera system, rather than using the tool. This tool can be used to quickly organize a dataset based on the video timecodes rather than the C000# trial IDs appended upon downloading, which is particularly useful for cases where the C000# trial IDs are misaligned between cameras for the same trial recording.

To use this tool, the raw video data must be recorded using the Sony RX0 II camera system, and should be downloaded using the options: Add the Camera Label (prefix) and Do not add the Shooting Date/Time. The raw video files must be accompanied by a data specficic CSV file, which can have any name, however it must be the only .csv file within the directory alongside the video files. The data spec .csv file must have a header row of: Trial,SubjectId,Type,Action,CalibrationId. Each subsequent row should contain the relevant information under each header column that corresponds to the trial.

For example, a data collection consisting of the following recordings in this order:

  • subject 1, walk

  • subject 1, run

  • subject 2, walk

  • subject 2, run

  • calibration

  • subject 3, walk

  • subject 3, run

would require a data specific CSV as follows:

Trial,SubjectId,Type,Action,CalibrationId
1,N/A,Calibration,N/A,N/A
2,S0001,Motion,Walk,1
3,S0001,Motion,Run,1
4,S0002,Motion,Walk,1
5,S0002,Motion,Run,1
6,N/A,Calibration,N/A,N/A
7,S0003,Motion,Walk,2
8,S0003,Motion,Run,2
/Chessboard
    /Calibration
        /001
            /[cam ID folders]
            /…
        /002
            /…
    /S0001
        /Walk
            /001
            /…
        /Run
            /001
            /…
    /S0002
        /Walk
            /001
            /…
        /Run
            /001
            /…
    /S0003
        /Walk
            /001
            /…
        /Run
            /001
            /…

After successful formatting of the data, an additional file changelog.csv is created which documents the mapping of raw video files to the organized file structure.

Data specific CSV notes:

  • Header row is required.

  • As shown, calibration trials should have N/A for SubjectID, Action, and CalibrationId column entries.

  • CalibrationId does not impact the organized data structure.

If your video data and CSV file meet these requirements, you can use the Format Sony Multicam tool by clicking on the tool in the dropdown. A dialog with these requirements must be acknowledged, as shown below.

When prompted, select the directory containing your raw video files and CSV file, which will be organized into a data structure meeting the Theia3D specification. Continuing with the above example dataset, the resulting data structure would be:

Tools Menu
Video Data
Organize Videos