Data Recording

Main PageMotive DocumentationData Recording

Page Scope

Once the capture volume is calibrated and all markers are placed, you are now ready to capture Takes. In this page, we will cover key concepts and tips that are important for the recording pipeline. For real-time tracking applications, you can skip this page and read through the Data Streaming page.

Live Mode and Edit Mode


There are two different modes in Motive: Live mode and Edit mode. You can toggle between two modes from the Control Deck or by using the (Shift + ~) hotkey.

Live Mode

The Live mode is mainly used when recording new Takes or when streaming a live capture. In this mode, all of the cameras are continuously capturing 2D images and reconstructing the detected reflections into 3D data in real-time.
Motive in Live Mode.

Edit Mode

The Edit Mode is used for playback of captured Take files. In this mode, you can playback, or stream, recorded data. Also, captured Takes can be post-processed by fixing mislabeling errors or interpolating the occluded trajectories if needed.
Motive in Edit Mode

Info2.png

Tip: Prime series cameras will illuminate in blue when in live mode, in green when recording, and turned-off in edit mode. See more at Camera Status Indicators

Recording


Recording in Motive is triggered from the Control Deck when in the Live mode, and the recorded data

Control Deck

In Motive, capture recording is controlled from the Control Deck. In the Live mode, new Take name can be assigned in the name box or you can just simply start the recording and let Motive automatically generate new names on the fly. You can also create empty Takes in the Data Management pane for a better organization. To start the capture, select Live mode and click the recording button (red). In the control deck, record time and frames are displayed in (Hour:Minute:Second:Frames).

Info2.png

Tip: For Skeleton tracking, always start and end the capture with a T-pose or A-pose, so that the skeleton assets can be redefined from the recorded data as well.

ControlDeckLabeled Live 30.png

Recorded Data Management

In Motive, all of the recorded capture files are managed through the Data pane. Each capture will be saved in a Take (TAK) file, which can be played back in the Edit mode later. Related Take files can be grouped within session folders. Simply create a new folder in the desired directory and load the folder onto the Data pane. Currently selected session folder is indicated with the flag symbol (SelectedFolder.png), and all newly recorded Takes will be saved in this folder.


DataManagementPane Overview.png


Info2.png

Tip: Efficient ways of managing Takes


  1. Always start by creating session folders for organizing related Takes. (e.g. name of the tracked subject).
  2. Plan ahead and create a list of captures in a text file or a spreadsheet, and you can create empty takes by copying and pasting the list into the Data Management pane (e.g. walk, jog, run, jump).
  3. Once pasted, empty Takes with the corresponding names will be imported.
  4. Select one of the empty takes and start recording. The capture will be saved with the corresponding name.
  5. If the capture was unsuccessful, simply record the same Take again and another one will be recorded with a incremented suffix added at the end of the given Take name (e.g. walk_001, walk_002, walk_003). The suffix format is defined in the Application Settings.
  6. When captured successfully, select another empty Take in the list and capture the next one.


DataManagementPane ImportingFromText.png

Recorded Data Types

When a capture is first recorded, both 2D data and real-time reconstructed 3D data is saved onto the Take. For more details on each data type, refer to the Data Types page.

  • 2D data: The recorded Take file includes just the 2D object images from each camera.
  • 3D data: The recorded Take file also includes reconstructed 3D marker data in addition to 2D data.

Marker Types in Motive


Throughout capture, you might recognize that there are different types of markers that appear in the 3D perspective view. In order to correctly interpret the tracking data, it is important to understand the differences between these markers. There are three different displayed marker types: markers, rigid body markers, and bone (or skeleton) markers.

Unlabeled and Labeled

Marker data, labeled or unlabeled, represent the 3D positions of markers. These markers do not present rigid body or skeleton solver calculations but locate the actual marker position calculated from the camera data. These markers are represented as a solid sphere in the viewport. By default, unlabeled markers are colored in white, and labeled markers will have colors that reflect the color setting in the rigid body or the corresponding bone.

Unlabeled Marker Labeled Marker (RB) Rigid Body Solve Skeleton Solve
DataRecording Unlabeled2 30.png
DataRecording RBLabeled 30.png
DataRecording RBSolve 30.png
DataRecording SKLModelMarker 30.png

Info2.png

Labeled Marker Colors:

  • Colors of the unlabeled markers can be changed from the Application Settings.
  • Colors of the rigid body labeled markers can be changed from the properties of the corresponding asset.
  • Colors of the markers can be changed from the Constraints XML file if needed.

Asset Model Markers: Rigid Body Markers and Bone Markers

Asset model marker option enabled under viewport options.

Rigid body markers or skeleton bone markers are referred to as Asset Model Markers. They appear as transparent spheres within a rigid body, or a skeleton, and each sphere reflect the position that a rigid body, or a skeleton, expects to find a 3D marker. When the asset definitions are created, it is assumed that the markers are fixed at the same location and does not move over the course of capture.

In order to view asset model markers, both the Asset Model Markers visual aid option in the viewport and the Asset Model Markers property on the corresponding asset must be enabled. This is enabled by default for skeleton assets but this must be enabled for rigid bodies to view them. When the rigid body solver or skeleton solver are tracking from the 3D markers, the marker reconstructions and asset model marker positions will closely align in the viewport.

For rigid body assets, when their asset definition is created, it expects the markers to be fixed in the same location and the object does not deform over the course of capture. Each rigid body is given a acceptable deflection property value. As long as the actual marker position is within the allowable deflection from the asset model marker position, the marker will be labeled. For skeleton assets, as the body segments are not perfectly rigid, some amount of offset from the model marker position is allowed.

Asset Model Marker (RB) Aligned and Labeled Asset Model Marker (SKL)
DataRecording AssetModelUnlabeled 30.png
DataRecording AlignedAndLabeled 30.png
DataRecording SKLModelMarker 30.png

Back: Create Assets

Next: Data Types