Difference between revisions of "Data Export"

Line 6: Line 6:
 
[[Image:DataExport_ExportPanel.png|thumb|400 px|Tracking data export dialogue window in Motive. CSV export is selected and corresponding options are displayed.]]
 
[[Image:DataExport_ExportPanel.png|thumb|400 px|Tracking data export dialogue window in Motive. CSV export is selected and corresponding options are displayed.]]
  
Motive exports reconstructed 3D tracking data in various file formats, and exported files can be imported into other pipelines to further utilize capture data. Supported formats include CSV, C3D, FBX, BVH, and TRC. To export a tracking data, select a Take to export and open the export dialog window, which can be accessed from ''File → Export Tracking Data'' or ''right-click on a Take → Export Tracking data'' from the [[Project Pane]]. From the export dialog window, frame rate, measurement scale, and frame range of exported data can be configured. Frame ranges can also be specified by selecting a frame region in the [[Timeline Pane]] before exporting a file. In the export dialog window, corresponding export options are available for each file format. Depending on which options are enabled, exported data may include reconstructed marker data, 6 Degree of Freedom (6 DoF) rigid body data, or skeleton data from a selected Take. The following chart shows what data types are associated in different export 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. Supported formats include CSV, C3D, FBX, BVH, and TRC. To export tracking data, select a Take to export and open the export dialog window, which can be accessed from ''File → Export Tracking Data'' or ''right-click on a Take → Export Tracking data'' from the [[Project Pane]]. From the export dialog window the frame rate, measurement scale, and frame range of exported data can be configured. Frame ranges can also be specified by selecting a frame range in the [[Timeline Pane]] before exporting a file. In the export dialog window, corresponding export options are available for each file format. Depending on which options are enabled, exported data may include reconstructed marker data, 6 Degree of Freedom (6 DoF) rigid body data, or skeleton data. The following chart shows what data types are available in different export formats.
  
Read through below pages for specific details on each export option:
+
Read through below pages for specific details on options for each format:
  
 
* [[Data Export: CSV]]
 
* [[Data Export: CSV]]
Line 50: Line 50:
 
{{Tip|'''TIP'''
 
{{Tip|'''TIP'''
  
* Exporting multiple Take files at a specific setting can also be done through utilizing a [[Motive Batch Processor]] script. For example, refer to FBXExporterScript.cs script found in MotiveBatchProcessor folder.
+
* Exporting multiple Take files with specific options can also be done through a [[Motive Batch Processor]] script. For example, refer to FBXExporterScript.cs script found in MotiveBatchProcessor folder.
  
 
* 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.}}
 
* 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.}}
Line 56: Line 56:
  
 
==Reference Video Export==
 
==Reference Video Export==
When there is a reference camera in a Take, the recorded reference video can be exported into an AVI file. The ''Export Video'' dialog window is located under the ''File tab''. At the bottom of the export dialog, the frame rate of the exported AVI file can be set to a full frame rate or down-sampled, half or quarter ratio, frame rate.
+
When there is a reference camera in a Take, the recorded reference video can be exported into an AVI file. The ''Export Video'' dialog window is located under the ''File tab''. At the bottom of the export dialog, the frame rate of the exported AVI file can be set to full frame rate or a down-sampled half or quarter ratio frame rate.
  
 
Read more about recording reference videos in [[Data Recording]] page.
 
Read more about recording reference videos in [[Data Recording]] page.
Line 66: Line 66:
  
 
==Camera Calibration Export==
 
==Camera Calibration Export==
Calibration definition of a selected take can be exported from the ''Export Camera Calibration'' under the ''File'' tab. Exported calibration files, CAL, 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 [[Hardware Setup|camera setup]] is maintained.
+
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 [[Hardware Setup|camera setup]] is maintained.
  
 
Read more about [[Calibration#Calibration Files|Calibration]].
 
Read more about [[Calibration#Calibration Files|Calibration]].
Line 72: Line 72:
  
 
==Export Assets Definition==
 
==Export Assets Definition==
Assets in a Take can be exported into Motive compatible TRA and SKL files. These files record calibrated spatial relationship of markers in each asset, and they are used to import the asset into different takes without creating a new one in Motive. Read more about assets in Motive from [[Assets and Labeling]] page.  
+
Assets in a Take can be exported into Motive compatible rigid body (TRA) and skeleton (SKL) definition files. These files record calibrated spatial relationship of markers in each asset, and they are used to import the asset into different takes without creating a new one in Motive. Read more about assets in Motive from the [[Assets and Labeling]] page.  
  
 
Rigid body definitions are exported as TRA files from the ''Export Rigid Body'' option under the ''File'' tab. When there are multiple rigid bodies in a Take, individual definitions can be exported by selecting a rigid body and clicking the ''Export Rigid Body'' from the context menu in the [[Project Pane#Take Context Menu|Project Pane]]. Likewise, skeleton definitions are exported as SKL files from the ''Export Skeleton'' option under the ''File'' tab, and individual definitions are exported through the ''Export Skeleton'' option located in the context menu from the [[Project Pane#Take Context Menu|Project Pane]].
 
Rigid body definitions are exported as TRA files from the ''Export Rigid Body'' option under the ''File'' tab. When there are multiple rigid bodies in a Take, individual definitions can be exported by selecting a rigid body and clicking the ''Export Rigid Body'' from the context menu in the [[Project Pane#Take Context Menu|Project Pane]]. Likewise, skeleton definitions are exported as SKL files from the ''Export Skeleton'' option under the ''File'' tab, and individual definitions are exported through the ''Export Skeleton'' option located in the context menu from the [[Project Pane#Take Context Menu|Project Pane]].
Line 78: Line 78:
  
 
{{Tip|'''TIP:'''  
 
{{Tip|'''TIP:'''  
Rigid body and Skeleton definitions can also be quickly copied into different take by dragging and dropping selected assets into a Take from the [[Project Pane]].}}
+
Rigid body and Skeleton definitions can also be quickly copied into different takes by dragging and dropping selected assets into a Take from the [[Project Pane]].}}
  
  
 
==Export Skeleton Marker Labels==
 
==Export Skeleton Marker Labels==
Skeletal marker labels can be exported as a XML file (example shown below) from the Export Skeleton dialog window. The XML files can be imported again to use the same marker labels when creating new skeletons.
+
Skeletal marker labels can be exported as a XML file (example shown below) from the Export Skeleton dialog window. The XML files can be imported again to use the stored marker labels when creating new skeletons.
  
  
Line 102: Line 102:
 
         <LDP1>LDP1</LDP1>
 
         <LDP1>LDP1</LDP1>
 
         <RDP1>RDP1</RDP1>
 
         <RDP1>RDP1</RDP1>
         <!--For renaming manually added markers: If the head has three markers, and you add a fourth marker manually, then add Head_4 line and modify its CUSTOM_NAME part: <Head_4>CUSTOM_NAME</Head_4>-->
+
         <!--For renaming manually added markers: If the head has three markers, and you add a fourth marker manually, then add a Head_4 line and modify its CUSTOM_NAME part: <Head_4>CUSTOM_NAME</Head_4>-->
 
         <!--Names of bones are: Head, Neck, Chest, Ab, Hip, LShoulder, LUArm, LFArm, LHand, RShoulder, RUArm, RFArm, RHand, LThigh, LShin, LFoot, LToe, RThigh, RShin, RFoot, RToe-->
 
         <!--Names of bones are: Head, Neck, Chest, Ab, Hip, LShoulder, LUArm, LFArm, LHand, RShoulder, RUArm, RFArm, RHand, LThigh, LShin, LFoot, LToe, RThigh, RShin, RFoot, RToe-->
 
     </MarkerNameMap>
 
     </MarkerNameMap>
 
  </SkeletonTemplate>
 
  </SkeletonTemplate>

Revision as of 20:23, 30 November 2015

Back to the Main PageBack to Motive Documentation


Tracking Data Export

Tracking data export dialogue window in Motive. CSV export is selected and corresponding options are displayed.

Motive exports reconstructed 3D tracking data in various file formats, and exported files can be imported into other pipelines to further utilize capture data. Supported formats include CSV, C3D, FBX, BVH, and TRC. To export tracking data, select a Take to export and open the export dialog window, which can be accessed from File → Export Tracking Data or right-click on a Take → Export Tracking data from the Project Pane. From the export dialog window the frame rate, measurement scale, and frame range of exported data can be configured. Frame ranges can also be specified by selecting a frame range in the Timeline Pane before exporting a file. In the export dialog window, corresponding export options are available for each file format. Depending on which options are enabled, exported data may include reconstructed marker data, 6 Degree of Freedom (6 DoF) rigid body data, or skeleton data. The following chart shows what data types are available in different export formats.

Read through below pages for specific details on options for each format:


Tracking Data Type CSV C3D FBX BVH TRC
Reconstructed 3D Marker Data
6 Degree of Freedom Rigid Body Data
Skeleton Data


TIP

  • Exporting multiple Take files with specific options can also be done through a Motive Batch Processor script. For example, refer to FBXExporterScript.cs script found in MotiveBatchProcessor folder.
  • 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.



Reference Video Export

When there is a reference camera in a Take, the recorded reference video can be exported into an AVI file. The Export Video dialog window is located under the File tab. At the bottom of the export dialog, the frame rate of the exported AVI file can be set to full frame rate or a down-sampled half or quarter ratio frame rate.

Read more about recording reference videos in Data Recording page.


Audio Export

When a recorded capture contains audio data, an audio file can be exported through the Export Audio option that appears when right-clicking on a Take from the Project Pane.


Camera Calibration Export

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 camera setup is maintained.

Read more about Calibration.


Export Assets Definition

Assets in a Take can be exported into Motive compatible rigid body (TRA) and skeleton (SKL) definition files. These files record calibrated spatial relationship of markers in each asset, and they are used to import the asset into different takes without creating a new one in Motive. Read more about assets in Motive from the Assets and Labeling page.

Rigid body definitions are exported as TRA files from the Export Rigid Body option under the File tab. When there are multiple rigid bodies in a Take, individual definitions can be exported by selecting a rigid body and clicking the Export Rigid Body from the context menu in the Project Pane. Likewise, skeleton definitions are exported as SKL files from the Export Skeleton option under the File tab, and individual definitions are exported through the Export Skeleton option located in the context menu from the Project Pane.


TIP: Rigid body and Skeleton definitions can also be quickly copied into different takes by dragging and dropping selected assets into a Take from the Project Pane.



Export Skeleton Marker Labels

Skeletal marker labels can be exported as a XML file (example shown below) from the Export Skeleton dialog window. The XML files can be imported again to use the stored marker labels when creating new skeletons.


Sample Skeleton Label XML File

<SkeletonTemplate version="1.0">
    <MarkerNameMap ReorderMarkers="true">
        <LIAS>LIAS</LIAS>
        <RIAS>RIAS</RIAS>
        <LIPS>LIPS</LIPS> 
        <RIPS>RIPS</RIPS>
        <LFTC>LFTC</LFTC>
        <RFTC>RFTC</RFTC>       
        ...
        <RFAX>RFAX</RFAX>
        <RFM5>RFM5</RFM5>
        <RFM1>RFM1</RFM1>
        <RFCC>RFCC</RFCC>
        <LDP1>LDP1</LDP1>
        <RDP1>RDP1</RDP1>
    </MarkerNameMap>
</SkeletonTemplate>