LogoLogo
WebsiteResource HubDownloadBook a DemoContact Support
Theia Apollo - v2024
Theia Apollo - v2024
  • Theia3D Documentation
    • Theia3D Documentation
    • Welcome to Theia3D
    • Keyboard Shortcuts
    • Getting Started
      • System Requirements
      • Installation
      • License Activation
      • Startup Window
      • Theia3D Basics
    • 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
    • Batch Processing
      • Theia3D Batch Application
      • File Menu
      • Help Menu
      • Settings
      • Trials
      • Preferences
    • Camera System Requirements
    • Sony Camera Package
      • Components
      • System Setup
      • Collecting Data with the System
  • Troubleshooting
    • Troubleshooting Documentation
    • Error Messages
      • Input directory has no mp4 or avi files.
      • Videos not formatted properly
      • Only [#] videos found.
      • Videos not the same length.
      • Unsupported video codec detected
      • Unable to load calibration.
      • Required camera parameter groups not present
      • Qualisys calibration has inconsistent FOV
      • Data not loaded
      • Camera extrinsics optimization step 3 failed
      • Unable to construct a continuous volume from overlapping chessboard frames
      • Track people not complete
      • Abnormally high tracking errors
      • Invalid video
    • 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 2 months 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 spec .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 spec .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