LogoLogo
WebsiteSupportDownloadsForumsQuick LinksContact Us
v3.0
v3.0
  • OptiTrack Documentation
  • WHAT'S NEW
    • What's New in Motive 3.0
    • Unreal Engine: OptiTrack InCamera VFX
  • 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 41
        • PrimeX 22
        • PrimeX 13
        • PrimeX 13W
        • SlimX 13
        • Prime Color
      • USB Cameras
        • Slim 3U
        • Flex 13
        • Flex 3
        • Duo 3
        • Trio 3
        • 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
      • NETGEAR ProSafe GSM7228S: Disabling the Broadcast Storm Control
      • White/Blacklisting Cameras
    • USB Camera System Setup
    • Aiming and Focusing
    • Camera Status Indicators
  • MOTIVE
    • Installation and Activation
    • Motive Basics
    • Calibration
      • Continuous Calibration
      • 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
    • 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: eSync2
    • Status Panel
    • Toolbar/Command Bar
    • Control Deck
    • Viewport
  • PLUGINS
    • OptiTrack Unreal Engine Plugin
      • Unreal Engine: OptiTrack Live Link Plugin
        • UE5.1 Live Link Retarget External Workaround
      • Unreal Engine: OptiTrack Streaming Client Plugin
      • Unreal Engine: HMD Setup
      • Unreal Engine: MotionBuilder Workflow
      • Unreal Engine VCS Inputs
    • OptiTrack Unity Plugin
      • Unity: HMD Setup
    • OptiTrack OpenVR Driver
    • 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
      • 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
      • Active Marker Tracking: IMU Setup
  • 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 10 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: OptiTrack Streaming Client Plugin
        • 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
      • Active Marker Tracking: IMU Setup
    • 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
    • PrimeX 22
    • Outdoor Tracking Setup
  • DEVELOPER TOOLS
    • Developer Tools Overview
    • NatNet SDK
      • NatNet 4.0
      • 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: RebroadcastMotiveData Sample
      • NatNet: Remote Requests/Commands
      • NatNet: Sample Projects
      • NatNet: Unicast Data Subscription Commands
      • Latency Measurements
    • Motive API
      • Motive API: Quick Start Guide
      • Motive API Overview
      • Motive API: Function Reference
      • Motive API Camera Calibration
    • Camera SDK
  • 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
    • Network Troubleshooting
    • Authenticating Cameras Without an Internet Connection
    • Troubleshooting Q&A
    • Running Motive on High DPI Displays
    • Firewall Settings
Powered by GitBook
On this page
  • Labeling: Basic Concept
  • Labeling Methods
  • Auto-label
  • Auto-labeling Steps
  • Marker Sets
  • Labels pane
  • QuickLabel Mode
  • Labeling using the QuickLabel Mode
  • General Labeling Steps
  • Using Combined Reconstruction and Auto-label Pipeline
  • Using Standalone Reconstruction Pipeline and Auto-label Pipeline Separately
  • Labeling Error Fix

Was this helpful?

Export as PDF
  1. MOTIVE

Labeling

PreviousData TypesNextData Editing

Last updated 2 years ago

Was this helpful?

This page provides basic description of marker labels and instructions on labeling workflow in Motive.

Labeling: Basic Concept

Marker Label

Marker labels are basically software name tags that are assigned to trajectories of reconstructed 3D markers so that they can be referenced for tracking individual markers, Rigid Bodies, or Skeletons. Motive identifies marker trajectories using the assigned labels. Labeled trajectories can be exported individually, or combined together to compute positions and orientations of the tracked objects. In most applications, all of the target 3D markers will need to be labeled in Motive. There are two methods for labeling markers in Motive: auto-labeling and manual labeling, and both labeling methods will be covered in this page.

Monitoring Labels

Labeled or unlabeled trajectories can be identified and resolved from the following places in Motive:

Labeling Methods

There are two approaches to labeling markers in Motive:

  • Auto-label pipeline: Automatically label sets of Rigid Body markers and Skeleton markers using calibrated asset definitions.

Auto-label

Rigid body and Skeleton asset definitions contain information of marker placements on corresponding assets. This is recorded when the assets are first created, and the auto-labeler in Motive uses them to label a set of reconstructed 3D trajectories that resemble marker arrangements of active assets. Once all of the markers on active assets are successfully labeled, corresponding Rigid Bodies and Skeletons get tracked in the 3D viewport.

The auto-labeler runs in real-time during Live mode and the marker labels get saved onto the recorded TAKs. Running the auto-labeler again in post-processing will basically attempt to label the Rigid Body and Skeleton markers again from the 3D data.

Auto-labeling Steps

From Data pane

  1. Right-click to bring up the context menu

  2. Click reconstruct and auto-label' to process selected Takes. The this pipeline will create a new set of 3D data and auto-label the markers from it.

  3. This will label all the markers that matches the corresponding asset definition.

Marker Sets

Marker Set is a list of labels, or marker names, that can be manually assigned to unlabeled markers. This can be created when there is a need to label individual markers in the scene that are not associated with a Rigid Body nor a Skeleton asset.

\

Labels pane

QuickLabel Mode

Labeling using the QuickLabel Mode

  1. Under the drop-down menu in the Labels pane, select an asset you wish to label.

  2. All of the involved markers will be displayed under the columns.

  3. From the label list, select unlabeled or mislabeled markers.

Hiding Marker Labels

General Labeling Steps

Labeling Tips

  • When working with Skeleton assets, label the hip segment first. The hip segment is the main parent segment, top of the segments hierarchy, where all other child segments are associated to. Manually assigning hip markers sometimes help the auto-labeler to label the entire asset.

Using Combined Reconstruction and Auto-label Pipeline

Step 4. Select an asset that you wish to label.

Step 5. From the label columns, Click on a marker label that you wish to re-assign.

Step 6. Inspect behavior of a selected trajectory and its labeling errors and set the appropriate labeling settings (allowable gap size, maximum spike and applied frame ranges).

Step 7. Switch to the QuickLabel mode (Hotkey: D).

Step 9. When all markers have been labeled, switch back to the Select Mode.

Using Standalone Reconstruction Pipeline and Auto-label Pipeline Separately

Step 1. Start with 2D data of a captured Take with model assets (Skeletons and Rigid Bodies).

Step 3. Examine the reconstructed 3D data, and inspect the frame range where markers are mislabeled.

Step 5. Unlabel all trajectories you want to re-auto-label.

Step 6. Auto-Label the Take again. Only the unlabeled markers will get re-labeled, and all existing labels will be kept the same.

Step 7. Re-examine the marker labels. If some of the labels are still not assigned correctly from any of the frames, repeat the steps 3-6 until complete.

Labeling Error Fix

The general process for resolving labeling error is:

  1. Identify the trajectory with the labeling error.

  2. Determine if the error is a swap, an occlusion, or unlabeled.

  3. Resolve the error with the correct tool.

  • Swap: Use the Swap Fix tool ( Edit Tools ) or just re-assign each label ( Labels panel ).

    • When manually labeling markers to fix swaps, set appropriate settings for the labeling direction, max spike, and selected range settings.

  • Occlusion: Use the Gap Fill tool ( Edit Tools ).

  • Unlabeled: Manually label an unlabeled trajectory with the correct label ( Labels panel ).

Solved Data: After editing marker data in a recorded Take, corresponding must be updated.

: From the 3D viewport, check the Marker Labels in the visual aids option to view marker labels for selected markers.

: The Labels pane lists out all of the marker labels and corresponding percentage gap for each label. The color of the label also indicates whether if the label is present or missing at the current frame.

: For frames where the selected label is not assigned to any markers, the timeline scrubber gets highlighted in red. Also, the tracks view of this pane provides a list of labels and their continuity in a captured Take.

Manual Label: Manually label individual markers using the .

For tracking Rigid Bodies and Skeletons, Motive can use the to automatically label associated markers both in real-time and post-processing. The auto-labeler uses references assets that are enabled, or assets that are checked in the , to search for a set of markers that matches with the definition and assign pre-defined labels throughout the capture.

There are times, however, when it is necessary to manually label a section or all of a trajectory, either because the markers of a Rigid Body or a Skeleton were misidentified (or unidentified) during capture or because individual markers need to be labeled without using any tracking assets. In these cases, the in Motive is used to perform manual labeling of individual trajectories. Manual labeling workflow is supported only in post-processing of capture when a Take file (TAK) has been loaded with 3D data as its playback type. In case of only capture, the Take must be Reconstructed first in order to assign, or edit, the marker labels in its 3D data. This manual labeling process, along with is typically referred to as post processing of mocap data.

Select Takes from the

Note: Be careful when reconstructing a Take again either by Reconstruct or Reconstruct and Auto-label, because it will overwrite the 3D data and any post-processing edits on trajectories and marker labels will be discarded. Also, for Takes involving Skeleton assets, the recorded Skeleton marker labels, which were intact during the live capture, may be discarded, and reconstructed markers may not be auto-labeled again if the Skeletons are never in well-trackable poses throughout the captured Take. This is another reason why you want to start a capture with a calibration pose (e.g. ).

Labels in the Marker Set, Rigid Body, and Skeleton assets are managed using the Constraints pane. Please refer to the to see how to add and/or modify marker labels. Once the labels are added, the Labels pane can be used to assign them onto markers.

Read more at page.

The is used to assign, remove, and edit marker labels in the . The Tracks View under the can be used in conjunction with the Labels pane to monitor which markers and gaps are associated. The Labels pane is also used to examine the number of occluded gaps in each label, and it can be used along with the for complete post-processing.

Using the Labels pane, you can assign marker labels for each asset (Marker Set, Rigid Body, and Skeleton) via the QuickLabel Mode . The Labels pane also shows a list of labels involved in the Take and their corresponding percent completeness values. The percent completeness values indicate frame percentages of a Take for which the trajectory has been labeled. If the trajectory has no gaps (100% complete), no number will be shown. You can use this pane together with the to quickly locate gaps in a trajectory.

For a given frame, all labels are color-coded. For each frame of 3D data, assigned marker labels are shown in white, labels without reconstructions are shown in red, and unlabeled reconstructions are shown in orange; similar to how they are presented in the .

See the page for detailed explanation on each option.

The QuickLabel mode allows you to tag labels with single-clicks in the view pane, and it is a handy way to reassign or modify marker labels throughout the capture. When the QuickLabel mode is toggled, the mouse cursor switches to a finger icon with the selected label name attached next to it. Also, when the display label option is enabled in the , all of assigned marker labels will be displayed next to each marker in the , as shown in the image below. Select the marker set you wish to label, and tag the appropriate labels to each marker throughout the capture.

When assigning labels using the Quick Label Mode, the labeling scope is configured from the labeling range settings. You can restrict the labeling operation to apply from the current frame backward, current frame forward, or both depending on the trajectory. You may also restrict labeling operations to apply the selected label to all frames in the Take, to a selected frame range, or to a trajectory 'fragment' enclosed by gaps or spikes. The fragment/spike setting is used by default and this best identifies mislabeled frame ranges and assigns marker labels. See the page for details on each feature.

Inspect the behavior of the selected trajectory and decide whether you want to apply the selected label to frames forward or frames backward or both. This option can be selected from on the Labels pane.

Switch to QuickLabeling Mode (Hotkey: D).

In the pane. Assign the selected label to a marker. If the Increment Option () is set under the Labels pane, the label selection in the Labels pane will automatically advance each time you assign them.

After assigning all labels, switch back to normal Select Mode .

If the marker labels are set to visible in the , Motive will show all of the marker labels when entering the QuickLabel mode. To hide all of the marker labels from showing up in the viewport, you can click on the visual aids option in the perspective view, and uncheck marker labels.

The following section provides the general labeling steps in Motive. Note that the labeling workflow is flexible and alternative approaches to the steps listed in this section could also be used. Utilize the auto-labeling pipelines in combination with the to best reconstruct and label the 3D data of your capture.

Use the to monitor occlusion gaps and labeling errors as you post-process capture Takes

When using the , choose the most appropriate labeling range settings (all, selected, spike, or fragment) to efficiently label selected trajectories.

can increase the speed of the workflow. Use Z and Shift+Z hotkeys to quickly find gaps in the selected trajectory.

Show/Hide Skeleton visibility under the visual aids options in the to have a better view on the markers when assigning marker labels.

Toggle Skeleton selectability under the selection option in the to use the Skeleton as a visual aid without it getting in the way of marker data.

Show/Hide Skeleton sticks and marker colors under the visual aids in the options for intuitive identification of labeled markers as you tag through Skeleton markers.

For Skeleton assets, the property can be utilized to display tracking errors on Skeleton segments.

Step 1. In the , Reconstruct and auto-label the take with all of the desired assets enabled.

Step 2. In the , examine the trajectories and navigate to the frame where labeling errors are frequent.

Step 3. Open the .

Step 8. On the , assign the labels onto the corresponding marker reconstructions by clicking on them.

Step 2. Reconstruct and Auto-Label, or just Reconstruct, the Take with all of the desired assets enabled under the . If you use reconstruct only, you can skip step 3 and 5 for the first iteration.

Step 4. Using the , manually fix/assign marker labels, paying attention to your label settings (direction, max gap, max spike, selected duration).

For more data editing options, read through the page.

Labels pane
Graph View pane
Labels pane
asset definitions
Assets pane
Data pane
T-pose
Constraints pane
Constraints pane
Labels pane
Labels pane
Labels pane
Graph View pane
Labels pane
Motive Hotkeys
Show Tracking Errors
Data pane
Graph View pane
Labels pane
Assets pane
Labels pane
Data Editing
Labeling Tutorial 2. Manual Labeling in Motive. This video is based on older version of Motive. There maybe a few differences in Motive 2.0, but the general workflow still remains the same.
Labels pane
3D data editing
Labels pane
Graph View pane
Editing Tools
Graph View pane
Solved Data
3D data
2D data
3D Perspective Viewport
3D View
perspective view
3D viewport
3D viewport
Perspective View
Perspective View
perspective view
perspective view
perspective view
Label QuickLabelMode.png
Label IncrementOptions 30.png
Label QuickLabelMode.png
Viewport16.png
Viewport16.png
labeling range settings
Label PointerMode.png
PerspectiveViewport5 30.png
Using the Graph View pane to view unlabeled trajectory gaps on labeled marker.
List of labeled markers for the selected Rigid Body (VCS) and unlabeled markers shown on the Labels pane. Click image to enlarge.
Active assets are checked on the Assets pane.
Performing Auto-labeling pipeline on a selected Take the Data pane.
Auto-labeled Rigid Body markers.
Auto-labeled Skeleton markers.
Auto-labeling a Take
Marker labels created in Constraints pane.
Use the Labels pane to quickly label markers. Click image to enlarge.
Re-labeling Skeleton markers using the QuickLabel Mode.
Hiding marker labels.
Labeling an unlabeled marker.