LogoLogo
WebsiteSupportDownloadsForumsQuick LinksContact Us
v3.2
v3.2
  • OptiTrack Documentation
  • WHAT'S NEW
    • What's New in Motive 3.2
  • QUICK START GUIDES
    • Quick Start Guide: Getting Started
    • Quick Start Guide: Prime Color Camera Setup
    • Quick Start Guide: Precision Capture
    • Quick Start Guide: Tutorial Videos
    • Quick Start Guide: Active Marker Tracking
    • Quick Start Guide: Outdoor Tracking Setup
  • HARDWARE
    • Cameras
      • Ethernet Cameras
        • PrimeX 120
        • PrimeX 41
        • PrimeX 22
        • PrimeX 13
        • PrimeX 13W
        • SlimX 13
        • Prime Color
        • VersaX 22
        • VersaX 41
        • VersaX 120
      • USB Cameras
        • Slim 3U
        • Flex 13
        • Flex 3
        • V120:Duo
        • V120:Trio
        • Adjusting Global Origin for Tracking Bars
    • Prepare Setup Area
    • Camera Mount Structures
    • Camera Placement
    • Ethernet Camera Network Setup
      • General Overview and Specs
      • Windows 10 Network Settings
      • Cabling and Load Balancing
      • Switch Configuration for PrimeX 120
      • NETGEAR ProSafe GSM7228S: Disabling the Broadcast Storm Control
      • White/Blacklisting Cameras
    • USB Camera System Setup
      • USB Camera Network Overview and Specs
      • V120:Duo and Trio Setup
      • Tracking Bar Coordinate System
        • Transforming Coordinate System: Global to Local
    • Aiming and Focusing
    • Camera Status Indicators
  • MOTIVE
    • Installation and License Activation
    • Motive Basics
    • Calibration
      • .mcal XML Calibration Files
      • Continuous Calibration
      • Continuous Calibration (Info Pane)
      • Calibration Squares
    • Markers
    • Assets
      • Gizmo Tool: Translate, Rotate, and Scale
    • Rigid Body Tracking
      • Aligning Rigid Body Pivot Point with a Replicated 3D Model
    • Skeleton Tracking
    • Trained Markersets
    • IMU Sensor Fusion
    • Data Recording
      • Data Types
    • Labeling
    • Data Editing
    • Data Export
      • Data Export: BVH
      • Data Export: C3D
      • Data Export: CSV
      • Data Export: FBX
      • Data Export: TRC
    • Data Streaming
    • Camera Video Types
    • Audio Recording
    • Motive HotKeys
    • Measurement Probe Kit Guide
    • Motive Batch Processor
    • Reconstruction and 2D Mode
  • MOTIVE UI PANES
    • Settings
      • Settings: General
      • Settings: Assets
      • Settings: Live Pipeline
      • Settings: Streaming
      • Settings: Views
      • Settings: Mouse and Keyboard
      • Settings: Audio
    • Assets Pane
    • Builder Pane
    • Constraints Pane
      • Constraints XML Files
    • Calibration Pane
    • Data Pane
    • Devices Pane
    • Edit Tools Pane
    • Graph View Pane
    • Info Pane
    • Labels Pane
    • Log Pane
    • Probe Pane
    • Properties Pane
      • Properties Pane: Camera
      • Properties Pane: Force Plates
      • Properties Pane: NI-DAQ
      • Properties Pane: OptiHub2
      • Properties Pane: Rigid Body
      • Properties Pane: Skeleton
      • Properties Pane: Take
      • Properties Pane: Trained Markerset
      • Properties Pane: eSync2
    • Status Panel
    • Toolbar/Command Bar
    • Control Deck
    • Viewport
  • PLUGINS
    • OptiTrack Blender Plugin
      • OptiTrack Blender Plugin
    • OptiTrack Unreal Engine Plugin
      • Unreal Engine: OptiTrack Live Link Plugin
        • Quick Start Guide: Real-Time Retargeting in Unreal Engine with Live Link Content
        • Unreal Editor for Fortnite (UEFN): OptiTrack Plugin for Live Link Hub
        • Unreal Engine: Live Link Camera Stream Setup
        • Live Link Content: Active Puck Static Meshes
      • Unreal Engine: MotionBuilder Workflow
      • Unreal Engine: HMD Setup
      • Unreal Engine VCS Inputs
    • OptiTrack Unity Plugin
      • Unity: HMD Setup
    • OptiTrack OpenVR Driver
    • OptiTrack MATLAB Plugin
    • Autodesk Maya
      • Autodesk Maya: OptiTrack Insight VCS Plugin
    • Autodesk MotionBuilder
      • Autodesk MotionBuilder Plugin
      • Autodesk MotionBuilder: OptiTrack Skeleton Plugin
      • Autodesk MotionBuilder: OptiTrack Optical Plugin
      • Autodesk MotionBuilder: OptiTrack Insight VCS Plugin
      • Autodesk MotionBuilder: Timecode Data
    • OptiTrack Peripheral API
    • External Plugins
      • Houdini 19 Integration
  • ACTIVE COMPONENTS
    • Active Components Hardware
      • Active Puck
      • Wired AnchorPuck
      • CinePuck
      • Wired CinePuck
      • BaseStation
      • Information for Assembling the Active Tags
      • Manus Glove Setup
    • Configuration
      • Active Batch Programmer
      • Active Hardware Configuration: PuTTY
      • Active Component Firmware Compatibility
    • Active Marker Tracking
      • Active Finger Marker Set
  • SYNCHRONIZATION
    • Synchronization Hardware
      • External Device Sync Guide: eSync 2
      • External Device Sync Guide: OptiHub2
    • Synchronization Setup
    • OptiTrack Timecode
  • VIRTUAL PRODUCTION
    • Unreal Engine: OptiTrack InCamera VFX
    • Entertainment Marker Sets
    • PrimeX 41
  • MOVEMENT SCIENCES
    • Movement Sciences Hardware
      • General Motive Force Plate Setup
      • AMTI Force Plate Setup
      • Bertec Force Plate Setup
      • Kistler Force Plate Setup
      • Delsys EMG Setup
      • NI-DAQ Setup
      • Multiple Device Setup
    • Movement Sciences Marker Sets
      • Biomechanics Marker Sets
      • Biomech (57)
      • Rizzoli Marker Sets
    • For Visual3D Users
    • Prime Color Camera Setup
      • Prime Color Setup: Required Components
      • Prime Color Setup: Hardware Setup
      • Prime Color Camera Setup: Camera Settings
      • Prime Color Camera Setup: Prime Color FS Calibration
      • Prime Color Setup: Data Recording / Export
      • Prime Color Camera Setup: FAQ / Troubleshooting
      • Prime Color Camera Setup: Windows Network Settings
  • VIRTUAL REALITY
    • VR Plugins
      • VR Unreal Engine
        • OptiTrack Unreal Engine Plugin
        • Unreal Engine: OptiTrack Live Link Plugin
          • UE5.1 Live Link Retarget External Workaround
        • Unreal Engine VCS Inputs
      • VR Unity
        • OptiTrack Unity Plugin
      • VR OpenVR
        • OptiTrack OpenVR Driver
    • VR HMD Setup
      • Unreal Engine: HMD Setup
      • Unity: HMD Setup
      • Manually Calibrating the HMD Pivot Point
      • Sync Configuration with an HTC Vive System
    • SlimX 13
    • Active Marker Tracking
      • Active Finger Marker Set
    • Synchronization Hardware
      • External Device Sync Guide: eSync 2
      • External Device Sync Guide: OptiHub2
  • ANIMATION
    • Autodesk Maya
      • Autodesk Maya: OptiTrack Insight VCS Plugin
    • Autodesk MotionBuilder
      • Autodesk MotionBuilder Plugin
      • Autodesk MotionBuilder: OptiTrack Skeleton Plugin
      • Autodesk MotionBuilder: OptiTrack Optical Plugin
      • Autodesk MotionBuilder: OptiTrack Insight VCS Plugin
      • Autodesk MotionBuilder: Timecode Data
  • ROBOTICS
    • MoCap4ROS2 Setup
    • OptiTrack Robot Applications
    • Outdoor Tracking Setup
  • DEVELOPER TOOLS
    • Developer Tools Overview
    • Camera SDK
      • Class: cCameraModule
      • Class: cUID
    • Motive API
      • Motive API: Quick Start Guide
      • Motive API Overview
      • Motive API: Function Reference
      • Motive API Camera Calibration
    • NatNet SDK
      • NatNet 4.1
      • NatNet: Class/Function Reference
      • NatNet: Creating a Managed (C sharp) Client Application
      • NatNet: Creating a Native (C++) Client Application
      • NatNet: Data Types
      • NatNet: Matlab Wrapper
      • NatNet: Migration to NatNet 3.0 libraries
      • NatNet: Remote Requests/Commands
      • NatNet: Sample Projects
      • NatNet: Unicast Data Subscription Commands
      • Latency Measurements
    • VRPN Sample
    • Peripheral API: Glove Devices
  • SKELETON MARKER SETS
    • Full Body
      • Baseline (41)
      • Core (50)
      • Biomech (57)
      • Conventional (39)
    • Full Body + Fingers
      • Baseline + Passive Fingers (49)
      • Baseline + Active Fingers (57)
      • Core + Passive Fingers (54)
      • Core + Active Fingers (62)
    • Upper
      • Baseline Upper (25)
      • Conventional Upper (27)
    • Lower
      • Baseline Lower (20)
      • Helen Hayes Lower (19)
      • Conventional Lower (16)
    • Hand and Fingers
      • Left/Right Hand (4) Active
      • Left/Right Hand (10) Active + Passive
      • Active Finger Marker Set
    • Glove Device Setup
      • Manus Glove Setup
      • StretchSense Glove Setup
    • Rizzoli Marker Sets
    • Entertainment Marker Sets
    • Rigid Body Skeleton Marker Set
  • GENERAL TROUBLESHOOTING
    • Licensing Troubleshooting
    • Windows 11 Optimization for Realtime Applications
    • Network Troubleshooting
    • Troubleshooting Q&A
    • Running Motive on High DPI Displays
    • Firewall Settings
Powered by GitBook
On this page
  • Tracking Data Export
  • Export Settings
  • Tracking Data Export Steps
  • File Formats
  • Camera Calibration Export
  • Export Assets Definition
  • Analog Data Export
  • Common Axis Conventions
  • Custom Axis
  • Reference Video Export
  • Video Export General Options
  • Video Export Overlay Options
  • Audio Export
  • Export Skeleton Marker Labels
  • Export Device Info

Was this helpful?

Export as PDF
  1. MOTIVE

Data Export

PreviousData EditingNextData Export: BVH

Last updated 2 months ago

Was this helpful?

Various types of files, including the tracking data, can be exported out from Motive. This page provides information on what file formats can be exported from Motive and instructions on how to export them.

Tracking Data Export

Once captures have been recorded into Take files and the corresponding 3D data have been reconstructed, tracking data can be exported from Motive in various file formats.

Exporting Tracking Data

If the recorded Take includes Rigid Body or Skeleton trackable assets, make sure all of the Rigid Bodies and Skeletons are Solved prior to exporting. The solved data will contain positions and orientations of each Rigid Body and Skeleton. If changes have been made to either the Rigid Body or Skeleton, you will need to solve the assets again prior to exporting.

Please note that if you have Assets that are unsolved and just wish to export reconstructed Marker data, you can toggle off Rigid Body and Skeleton Bones from the Export window (see image below).

Export Settings

In the export dialog window, the frame rate, the measurement scale and type (meters, centimeters or millimeters), the Axis convention, and the frame range of exported data can be configured. Additional export settings are available for each export file formats. Read through below pages for details on export options for each file format:

Tracking Data Export Steps

Exporting a Single Take

Step 3. On the export dialogue window, select a file format and configure the corresponding export settings.

  • To export the entire frame range, set Start Frame and End Frame to Take First Frame and Take Last Frame.

  • To export a specific frame range, set Start Frame and End Frame to Start of Working Range and End of Working Range.

Step 4. Click Save.

Working Range:

The working range (also called the playback range) is both the view range and the playback range of a corresponding Take in Edit mode. Only within the working frame range will recorded tracking data be played back and shown on the graphs. This range can also be used to output specific frame ranges when exporting tracking data from Motive.

The working range can be set from the following places:

  • In the navigation bar of the Graph View pane, you can drag the handles on the scrubber to set the working range.

Exporting Multiple Takes

Step 2. Right-click on the selected Takes and click Export Tracking Data from the context menu.

Step 3. An export dialogue window will display to batch export tracking data.

Step 4. Select the desired output format and configure the corresponding export settings.

Step 5. Select frame ranges to export under the Start Frame and the End Frame settings. You can either export entire frame ranges or specified frame ranges on all of the Takes. When exporting specific ranges, desired working ranges must be set for each respective Takes.

  • To export entire frame ranges, set Start Frame and End Frame to Take First Frame and Take Last Frame.

  • To export specific frame ranges, set Start Frame and End Frame to Start of Working Range and End of Working Range.

Step 6. Click Save.

Motive Batch Processor:

File Formats

Motive exports reconstructed 3D tracking data in various file formats and exported files can be imported into other pipelines to further utilize capture data. Available export formats include CSV, C3D, FBX, BVH, and TRC. Depending on which options are enabled, exported data may include reconstructed marker data, 6 Degrees of Freedom (6 DoF) Rigid Body data, or Skeleton data. The following chart shows what data types are available in different export formats:

Tracking Data Type
CSV
C3D
FBX
BVH
TRC

Reconstructed 3D Marker Data

•

•

•

•

6 Degrees of Freedom Rigid Body Data

•

•

Skeleton Data

•

•

•

•

•

CSV and C3D exports are supported in both Motive Tracker and Motive Body licenses. FBX, BVH, and TRC exports are only supported in Motive Body.

Camera Calibration Export

Export Assets Definition

When an asset definition is exported to a MOTIVE user profile, it stores marker arrangements calibrated in each asset, and they can be imported into different takes without creating a new one in Motive. Note that these files specifically store the spatial relationship of each marker, and therefore, only the identical marker arrangements will be recognized and defined with the imported asset.

To export the assets, go to the File menu and select Export Assets to export all of the assets in the Live-mode or in the current TAK file(s). You can also use File → Export Profile to export other software settings including the assets.

Analog Data Export


Recorded NI-DAQ analog channel data can be exported into C3D and CSV files along with the mocap tracking data. Follow the tracking data export steps outlined above and any analog data that exists in the TAK will also be exported.

CSV Export: When exporting tracking data into CSV, additional CSV files will be exported for each of the NI-DAQ devices in a Take. Each of the exported CSV files will contain basic properties and settings at its header, including device information and sample counts. The voltage amplitude of each analog channel will be listed. Also, mocap frame rate to device sampling ratio is included since analog data is usually sampled at higher sampling rates.

Common Axis Conventions

Motive uses a different coordinate system than the system used in common biomechanics applications. To update the coordinate system to match your 3D analysis software during export, select the appropriate Axis Convention from the Export window.

  • For CSV, BVH, TRC formats, select Entertainment, Measurement, or Custom

  • For C3D format, select Visual 3D/Motion Monitor, MotionBuilder, or Custom

FBX formats do not include the option to change the Axis Convention.

Custom Axis

Select the Custom axis convention to open up the X/Y/Z axis for editing. This creates a drop-down menu next to each axis that allows you to change it.

Click the curved arrow to the right of the field to reset the axis to its previous value, or to make your selection the default option.

Reference Video Export

Reference Video Type: Only compressed MJPEG reference videos or color camera videos can be recorded and exported from Motive. Export for raw grayscale videos is not supported.

Media Player: The exported videos may not be playable on Windows Media Player, please use a more robust media player (e.g. VLC) to play the exported video files.

Video Export General Options

Option
Description

Frame Resampling

Adjusts the frame rate of the exported video from full (every frame) to half, quarter, 1/8 or 1/16 of the original.

Start Frame

End Frame

Playback Rate

Sets the playback speed for the exported video. Options are Full Speed (default), half speed, quarter speed, and 1/8 speed.

Video Format

Reference videos can be exported into AVI files using either H.264 or MJPEG compression formats, or as individual JPEG files (JPEG sequence). The H.264 format will allow faster export of the recorded videos and is recommended.

Maximum File size (MB)

Sets the maximum size for video export files, in megabytes. Large videos will be separated into multiple files, which will not exceed the size value set here.

Dropped Frames

Determines how dropped frames will be handled in the video output. Last Frame (the default) will display the last good frame through the end of the video. Black Frame will replace each dropped frame with a black frame. Both of these options will preserve the original video length, whereas Drop Frame will truncate the video at the first dropped frame.

Naming Convention

Sets the naming convention for the video export. The Standard naming convention is Take_Name (Camera Serial Number) e.g., Skeleton_Walking (M21614). The Prefix Camera ID convention will include the number assigned to the camera in Motive at the beginning, followed by the Take name e.g., Cam_1_Skeleton_Walking. This latter option will also create a separate folder for each camera's AVI file.

Camera

Select the camera(s) for the video export: All reference cameras, or custom.

Video Export Overlay Options

Overlay options add layers of information to the exported video.

Overlay
Description

Time Data

Includes the frame reference number in the bottom left corner.

Cameras

Labels all cameras visible in the reference video with the Motive-assigned number.

Markers

Displays markers using the color scheme assigned in Motive.

Rigid Bodies

Shows the Rigid Body bone and constraints for all solved Rigid Bodies in the take.

Skeletons

Displays bones for all solved skeletons.

Markersets

Displays bones for all solved trained markersets.

Force Plates

Displays force plate(s) used in the take.

Marker Sticks

Displays the marker sticks for all solved assets used in the take.

Logo

Adds the OptiTrack logo to the top right corner of the video.

Audio Export

Export Skeleton Marker Labels

Sample Skeleton Label XML File

 <Asset version="1.0">
    <MarkerNames ReorderMarkers="true">
        <Marker name="NewHeadTop" oldName="HeadTop" />
        <Marker name="NewHeadFront" oldName="HeadFront" />
        <Marker name="NewHeadSide" oldName="HeadSide" />
        ...
        <Marker name="RToeIn" oldName="RToeIn" />
        <Marker name="RToeTip" oldName="RToeTip" />
        <Marker name="RToeOut" oldName="RToeOut" />
    </MarkerNames>
    <MarkerColors>
        <Marker name="WaistLFront" color="75 225 255" movable="false" />
        <Marker name="WaistRFront" color="225 75 255" movable="false" />
        <Marker name="WaistLBack" color="75 225 255" movable="false" />
        ...
        <Marker name="RToeIn" color="225 75 255" movable="false" />
        <Marker name="RToeOut" color="75 75 255" movable="false" />
        <Marker name="RHeel" color="225 75 255" movable="false" />
        <Marker name="RToeTip" color="0 150 0" movable="false" />
    </MarkerColors>
    <MarkerSticks>
        <MarkerStick origin="WaistLFront" end="WaistLBack" color="140 45 225" />
        <MarkerStick origin="WaistLFront" end="LThigh" color="110 210 240" />
        <MarkerStick origin="WaistRFront" end="WaistRBack" color="140 45 225" />
        ...
        <MarkerStick origin="RToeTip" end="RToeIn" color="60 210 60" />
        <MarkerStick origin="LToeTip" end="LToeOut" color="110 210 240" />
        <MarkerStick origin="RToeTip" end="RToeOut" color="60 210 60" />
    </MarkerSticks>
 </Asset>

Export Device Info

Cameras and other devices can now be exported to a CSV file. From the File menu, select Export Device Info...

The CSV file includes the device serial number and name.

  • For Cameras, the name is pre-defined and includes the camera model and serial number.

  • For all other devices, Motive will export the product serial number along with the name assigned in the device's properties. If no name is entered, the field will be left blank.

is required to export Marker data, is required when exporting Markers labeled from Assets, and is required prior to exporting Assets.

Step 1. Open and select a Take to export from the . The selected Take must contain reconstructed 3D data.

Step 2. Under the File tab on the command bar, click File → Export Tracking Data. This can also be done by right-clicking on a selected Take from the and clicking Export Tracking Data from the context menu.

You can also use the navigation controls on the Graph View pane to zoom in or zoom out on the frame ranges to set the working range. See: page.

Start and end frames of a working range can also be set from the when in the Edit mode.

Step 1. Under the , shift + select all the Takes that you wish to export.

Exporting multiple Take files with specific options can also be done through a script. For example, refer to the FBXExporterScript.cs script found in the MotiveBatchProcessor folder.

A calibration definition of a selected take can be exported from the Export Camera Calibration under the File tab. Exported calibration (CAL) files contain camera positions and orientations in 3D space, and they can be imported in different sessions to quickly load the calibration as long as the is maintained.

Read more about calibration files under the page.

Assets can be exported into the Motive user profile (.MOTIVE) file if it needs to be re-imported. The is a text-readable file that contains various configuration settings in Motive, including the asset definitions.

C3D Export: Both mocap data and the analog data will be exported onto a same C3D file. Please note that all of the analog data within the exported C3D files will be logged at the same sampling frequency. If any of the devices are captured at different rates, Motive will automatically resample all of the analog devices to match the sampling rate of the fastest device. More on C3D files:

When there is an MJPEG reference camera or a color camera in a Take, its recorded video can be exported into an AVI file or into a sequence of JPEG files. The Export Video option is located under the File menu, or you can also right-click on a TAK file from the and export from there. Read more about recording reference videos on the page.

Start frame of the exported data. You can set it to the recorded first frame of the exported Take (the default option), to the start of the working range (or scope range), as configured under the or in the , or select Custom to enter a specific frame number.

End frame of the exported data. You can set it to the recorded end frame of the exported Take (the default option), to the end of the working range (or scope range), as configured under the of in the , or select Custom to enter a specific frame number.

When a recorded capture contains audio data, an audio file can be exported through the Export Audio option on the File menu or by right-clicking on a Take from the .

Skeletal marker labels for Skeleton assets can be exported as XML files (example shown below) from the . The XML files can be imported again to use the stored marker labels when creating new Skeletons.

For more information on Skeleton XML files, read through the page.

Data Export: CSV
Data Export: C3D
Data Export: FBX
Data Export: BVH
Data Export: TRC
Data pane
Data pane
Graph View pane
Control Deck
Data pane
Motive Batch Processor
camera setup
Calibration
https://www.c3d.org/
Data pane
Data Recording
Data pane
Data pane
Skeleton Tracking
Control Deck
Graph View pane
Control Deck
Graph View pane
Reconstruction
Auto-label
Solving
user profile
Save As a CSV file, Specific settings shown, and Rigid Body Bones and Skeleton and Markerset Bones highlighted.
Tracking data export dialogue window in Motive. CSV export is selected, and corresponding General options are displayed.
Make sure all Rigid Bodies are solve prior to export.
Working range (48 ~ 345) shown on the navigation bar at the bottom of the Graph View pane.
Export Calibration window.
Exporting Assets into the User Profile.
Exporting user profile that includes assets. This dialogue window is from the Export Profile As... option.
C3D export setting for applications using z-up right-handed coordinate systems.
Edit the X/Y/Z axis directly using the Custom Axis Convention option.
Reset or Set as Default.
Export video dialog window - General Options.
Overlay options for reference video exports.
Exporting Skeleton marker XML template from the Asset Pane (left) or the Constraints Pane (right).
Export Device Info from the File menu (left) with resulting CSV file (right).
Properties pane for a Force Plate asset.