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
  • Recommendations:
  • Recording Lens Calibrations:

Was this helpful?

Export as PDF
  1. Theia3D Documentation
  2. Data Collection

Recording Intrinsic Lens Calibrations

PreviousData Collection PrinciplesNextRecording Extrinsic Chessboard Calibrations

Last updated 16 days ago

Was this helpful?

Intrinsic lens calibration trials are used to determine parameters associated with the camera lenses and are used to correct for distortion and other visual effects. Lens calibration trials are required for all camera systems that make use of a chessboard calibration method, except for Sony RX0-ii cameras. Users with wand calibration-capable systems (e.g. Qualisys Miqus, Vicon FLIR Blackfly S systems) are not required to complete lens calibration unless they are planning to use the chessboard calibration method.

Lens calibrations must be performed at least once per video resolution that will be used to record movement data, and any time the lenses or focal lengths change. If you intend on collecting data at 1080p, 720p, and 540p, you will need to record separate lens calibration trials at each of those resolutions.

Adjusting the aperture and focus of OptiTrack Prime Color cameras using the dials on their lenses does not necessitate new lens calibrations.

Recommendations:

  • Record lens calibration trials at a relatively low frame rate (20-30 Hz) to reduce file size and processing time.

  • Keep the chessboard as flat as possible during the calibration trial.

  • Use a computer monitor facing the person performing the calibration to provide visual feedback during the calibration.

  • Move slowly and deliberately to prevent chessboard blur.

  • Lens calibrations can be performed for smaller groups or individual cameras and merged afterwards. If you are finding it challenging to calibrate all at once, try recording separate groups.

Recording Lens Calibrations:

  1. Place all cameras side by side on a desk or table, facing the same direction and capturing as similar views as possible. It is generally easier to calibrate the lenses with the cameras in 'landscape' orientation.

  2. Stand at a distance where the chessboard occupies approximately 1/4 of the camera views.

  3. Begin the recording.

  4. Slowly move the chessboard in a systematic grid pattern, covering the entire field of view for every camera. Ensure the chessboard goes slightly beyond every edge of every camera field of view, and every corner.

  1. Take a step back, and repeat Step 4., covering the camera fields of view again.

  2. While covering the field of view, angle the chessboard slightly in multiple directions, varying its orientation throughout.

  3. When you are confident that the entire field of view has been covered for all cameras, end the recording.

To process intrinsic lens calibrations, see .

Lens Calibration
Example pattern of chessboard movement during lens calibration. Repeat or retrace this movement as required or maximize complete coverage of the camera view(s).