LogoLogo
WebsiteSupportDownloadsForumsQuick LinksContact Us
v3.1
v3.1
  • OptiTrack Documentation
  • WHAT'S NEW
    • What's New in Motive 3.1
  • 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
      • 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
      • 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
      • Duo 3 and Trio 3 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
      • 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 Streaming Client 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
    • 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
  • 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: Using the 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
    • 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
    • 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
  • Labeling Overview
  • Marker Labels
  • Monitoring Labels
  • Labeling Methods
  • Auto-label
  • Auto-labeling Steps
  • Rename Labels
  • Manual Labeling
  • Labels pane
  • Quick Label Mode
  • Quick Label Mode Steps
  • Tips for Labeling Skeletons
  • Labeling Workflows
  • 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

This page covers the basics of marker labels in Motive and outlines a sample labeling workflow.

PreviousData TypesNextData Editing

Last updated 1 year ago

Was this helpful?

Labeling Overview

Marker Labels

Marker labels are software tags assigned to identify trajectories of reconstructed 3D markers so they can be referenced for tracking individual markers, Rigid Bodies, Skeletons, or Trained Markersets. Labeled trajectories can be exported individually or combined together to compute positions and orientations of the tracked objects.

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, Skeleton, or Trained Markerset markers using calibrated asset definitions. Motive uses the unique marker placement stored in the Asset definition to identify an asset and applies its associated marker labels automatically. This occurs both in real-time and post-processing.

Auto-label

As noted above, Motive stores information about Rigid Bodies, Skeletons, and Trained Markersets in asset definitions, which are recorded when the assets are created. Motive's auto-labeler uses asset definitions to label a set of reconstructed 3D trajectories that resemble the 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 are saved in the recorded TAKES. Running the auto-labeler again in post-processing will label the Rigid Body and Skeleton markers again from the 3D data.

Auto-labeling Steps

From the Data pane

  1. Right-click to open the context menu.

  2. Click reconstruct and auto-label to process the selected Takes. This pipeline creates a new set of 3D data and auto-labels the markers that match the corresponding asset definitions.

Be careful when reconstructing a Take again either by Reconstruct or Reconstruct and Auto-label. These processes overwrite the 3D data, discarding any post-processing edits on trajectories and marker labels.

Rename Labels

  • The Labels pane displays marker labels for either the selected asset or all markers in the Take.

To change a marker label:

  • Right-click the label and select Rename, or

  • Click twice on the label name to open the field for editing.

We recommend using the single asset view rather than -All- when relabeling markers from the Constraints pane.

To switch assets:

  • When -All- is selected in the Constraints pane, the marker labels include the asset name as a prefix, e.g., Bat_marker1. Delete the prefix if updating labels from this view.

  • The Labels pane does not include the asset name prefix when -All- is selected.

Manual Labeling

Labels pane

  • Shows the labels involved in the Take and their corresponding percentage of occluded gaps values. If the trajectory has no gaps (100% complete), no number is shown.

  • Labels are color-coded to note the label's status in the current frame of 3D data. Assigned marker labels are shown in white, while labels without reconstructions and unlabeled reconstructions that are not in the current frame are shown in magenta.

Quick Label Mode

The Quick Label mode allows you to tag labels with single-clicks in the 3D Viewport and is a handy way to reassign or modify marker labels throughout the capture.

Quick Label Mode Steps

  1. Select the asset to label, either from the Assets Pane, the 3D Viewport, or from the asset selection drop-down list in the Labels pane.

  2. This will display all of the asset's markers and their corresponding percentage gap.

  3. Select the Label Range:

    • All or Selected: Assign labels to a selected marker for all, or selected, frames in a capture.

    • Spike or Fragment: Apply labels to a marker within the frame range bounded by trajectory gaps and spikes (erratic change).

    • Swap Spike or Fragment: Apply labels only to spikes created by labeling swaps.

  4. Select a label from the Labels pane. The label name will display next to the pointed finger until a marker is selected in the 3D Viewport, assigning the label to that marker.

  5. The Increment Options setting determines how the Quick Label mode should behave after a label is assigned.

    • Do Not Increment keeps the same label attached to the cursor.

    • Go To Next Label automatically advances to the next label in the list, even if it is already assigned to a marker in the current frame. This is the default option.

    • Go To Next Unlabeled Marker advances to the next label in the list that is not assigned to a marker in the current frame.

  6. When you are done, toggle back to normal Select Mode using either Hotkey: D or the Mouse Actions menu.

Uncheck Labels in the viewport Visuals if you do not wish to see them in Quick Label mode.

Tips for Labeling Skeletons

  • The hip bone is the main parent bone, top of the hierarchy, where all other child bones link to. Always label the hip segment first when working with skeletons. Manually assigning hip markers sometimes helps the auto-labeler to label the entire asset.

  • Enable the Quality Visual setting in the skeleton properties to graphically see:

    • When there are no markers contributing to a bone. The bone will appear red.

    • When a Degree of Freedom limit is reached. The bone will appear blue.

Labeling Workflows

The labeling workflow is flexible and alternative approaches to the steps in this section can also be used.

General Labeling Tips

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 the 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, Rigid Bodies, or Trained Markersets).

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 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 pane).

    • 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, select Marker Labels in the visual aids menu to show marker labels for selected markers.

: The Labels pane lists all the marker labels and corresponding percentage gap for each label. The label will turn magenta in the list if it is missing at the current frame.

: The timeline scrubber highlights in red any frames where the selected label is not assigned to a marker. The Tracks view provides a list of labels and their continuity in a captured Take.

Auto-labeling applies only to assets enabled with a checkmark in the .

Manual Label: Manually label individual markers using the . Use this workflow to give Rigid Bodies and Trained Markersets more meaningful labels.

Select the Take(s) from the .

Recorded Skeleton marker labels, which were intact during the live capture, may be discarded, and the reconstructed markers may not be auto-labeled correctly again if the Skeletons are never in well-trackable poses during the captured Take. This is another reason to always start a capture with a good (e.g., a T-pose).

Label names can be changed through the or the .

The displays marker labels for either the selected asset or all assets in the Take. Markers that are not part of an asset are not included.

Use the Assets pane or the 3D Viewport to select a different asset or click the button in the Constraints pane to unlock the asset selection drop-down.

There are times when it is necessary to manually label a section or all of a trajectory, either because the markers of a Rigid Body, Skeleton, or Trained Markerset 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.

The manual labeling workflow is supported only in post-processing of the 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 3D data.

This manual labeling process, along with , is typically referred to as post processing of mocap data.

The is used to assign, remove, and edit marker labels in the and is used along with the for complete post-processing.

By default, only labeled markers are shown. To see unlabeled markers, click the button in the upper right corner of the pane and select any layout option other than Labeled only.

Please see the page for a detailed explanation of each option.

The Tracks View under the can be used in conjunction with the Labels pane to quickly locate gaps in a trajectory to see which markers and gaps are associated.

Click the button and select any option other than Labeled Only to see unlabeled markers.

Inspect the behavior of the selected trajectory then use the Apply Labels drop-down list in the Labels pane Settings to apply the selected label to frames forward or frames backward or both. Click to display settings, if necessary.

Click the Mouse Actions button to switch to Quick Label Mode (Or use Hotkey: D). The cursor will change to a finger icon.

When the Visual Aids are set to display marker labels and Quick Label mode is toggled on, all of the labels for visible markers will appear in the 3D viewport.

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 Options 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.

Use the to monitor occlusion gaps and labeling errors during post-processing.

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

Set the Visual Aids for Markers in the perspective view to Hide for Disabled Assets then uncheck the box to the left of the asset name in the Assets pane when you are done labeling it to better focus on the remaining unlabeled assets.

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. In the , assign the labels to 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 the 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
Data pane
Constraints Pane
Labels Pane
Constraints pane
Labels pane
3D data editing
Labels pane
Graph View pane
Graph View pane
Motive Hotkeys
Data pane
Graph View pane
Labels pane
Assets pane
Labels pane
Data Editing
Assets pane
Labels pane
Editing Tools
Solved Data
3D data
2D data
3D viewport
Perspective View
3D Perspective Viewport
perspective view
perspective view
perspective view
calibration pose
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.
Marker Labels for a Rigid Body.
The Graph View pane shows unlabeled trajectory gaps on labeled marker.
List of labeled markers for the selected Rigid Body and unlabeled markers shown on the Labels pane.
Auto-labeled Rigid Body markers.
Auto-labeled Skeleton markers.
Auto-labeling a Take.
Marker labels in Constraints pane.
Marker labels in Labels pane.
Asset Selection unlocked in the Constraints Pane.
Use the Labels pane to quickly label markers. Click image to enlarge.
Re-labeling Skeleton markers using the Quick Label Mode.
Mouse Actions menu.
Quick Label Mode in the 3D Viewport.
Hiding marker labels.
Labeling an unlabeled marker.