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
  • Trained Markerset Properties
  • General Properties
  • Visuals
  • Bones (Advanced Setting)
  • Smoothing and Damping
  • Attaching and Modifying Geometry (Advanced Setting)

Was this helpful?

Export as PDF
  1. MOTIVE UI PANES
  2. Properties Pane

Properties Pane: Trained Markerset

An in-depth look at the properties available for Trained Markersets.

PreviousProperties Pane: TakeNextProperties Pane: eSync2

Last updated 1 year ago

Was this helpful?

Trained Markerset properties determine how the corresponding asset is tracked and displayed in the . This page covers the properties specific to Trained Markersets. For general information on using and customizing the Properties pane, see the page. For detailed descriptions of properties for other asset types or devices, please see the following pages:

Trained Markerset Properties

Select a Trained Markerset asset in the or in the , and the corresponding properties will be listed under the . These properties can be modified both in Live and Edit mode. Default creation properties are listed under the .

Advanced Settings

Use the Edit Advanced option to customize which settings are in the Advanced Settings category and which appear in the standard view, to show only the settings that are needed specifically for your capture application.

General Properties

The following items are available in the General Properties section. Properties are Standard unless noted otherwise.

Asset Name

Enter a custom name for the Trained Markerset. The default name is "Markerset." The Asset Name can also be changed by right-clicking the Trained Markerset in the Assets pane.

Enable

Enables or Disables tracking of the selected asset. A disabled Trained Markerset will not be tracked, and its data will not be included in the exported or streamed tracking data or displayed in the 3D Viewport.

  • Select Markers -> Hide for Disabled Assets.

Notes

An optional text field for storing additional information about the Rigid Body. The data in the Notes field is not included when exporting the asset to a CSV file.

Minimum Markers to Boot

Sets the minimum number of markers that must be tracked and labeled in order for the asset to be booted or first tracked.

Minimum Markers to Continue

Sets the minimum number of markers that must be tracked and labeled in order for the asset to continue to be tracked after the initial boot.

Asset Scale (Advanced Setting)

Increase or decrease the size of the Trained Markerset bone by scaling the asset. By default, the Asset Scale is set to 100%.

Deflection Ratio (Advanced Setting)

Allows the asset to deform more or less to accommodate markers that don't fit the model. High values will allow assets to fit onto markers that don't match the model as well.

Visuals

The following items are available in the Visuals section. Properties are Standard unless noted otherwise.

Geometry (Advanced Setting)

Attach a valid geometric model to the Trained Markerset to display in the the 3D Viewport. Sphere, box, cylinder, and bone segment shapes are built-in; to use your own geometric model, select Custom Model. This will open the Attached Geometry field.

Attached Geometry

The Attached Geometry field becomes available whenever Custom Model is selected for the Rigid Body geometry.

Bone Major Axis (Advanced Setting)

Set the axis with which the bone should be aligned. The coordinate at the end of the bone is expected to be on this axis.

Default Bone Length (Advanced Setting)

Set the offset (in mm) from the bone to the end effector, along the major axis, for bones that do not have child bones.

Bone Diameter (Advanced Setting)

Set the diameter of the bone (in mm).

Label

IMU State

This property is not applicable to Trained Markersets.

Visual

Display the marker sticks and bone constraint lines in the 3D Perspective View.

Color

Set the color of the selected Trained Markerset in the 3D Perspective View. Click the box to bring up the color picker:

Bones

The shape of the bones indicates whether the asset is solved or unsolved:

Bones Color

Set the color of the bone(s) in the 3D Perspective View.

Bone Degrees of Freedom (Advanced Setting)

Display degrees of freedom, position and orientation, for each bone.

Marker Constraints

Show the Marker Constraints as transparent spheres on the Trained Markerset. Marker Constraints are the expected marker locations according to the Rigid Body solve.

Marker to Constraint Lines (Advanced Setting)

Show lines between labeled Trained Markerset markers and corresponding expected marker locations. This helps to visualize the offset distance between actual marker locations and the Marker Constraints.

Bone to Constraint Line (Advanced Setting)

Display a dotted line to connect each Marker Constraint to the Trained Markerset bone.

Bones (Advanced Setting)

To view and update properties for a specific bone, select just the bone in the 3D Viewport.

Bone Name

An editable field that shows the name of the selected bone. When more than one bone is selected, the field will display Mixed.

This field does not display if the Trained Markerset does not have any bones.

Parent

The Parent bone is the first bone in a Bone Chain. This property shows which bone in the Trained Markerset is the parent of the currently selected bone. When the selected bone is the root of the chain, or if there is no bone chain, the Parent field will display the name of the Trained Markerset asset.

When more than one bone is selected, the field will display Mixed.

Children

A Child bone connects to the parent bone in a Bone Chain. This property shows which bone in the Trained Markerset is the child to the currently selected bone. When the selected bone is the end of the chain, or if there is no bone chain, the Child field will display None.

Segment Type

Used for Skeleton and Trained Markerset assets to identify bone segments. The list includes all standard skeleton segments and is not required.

Rotation Order

Euler angle rotation order used for calculating the bone hierarchy.

Rotation Offset

Enter values along one of the axis to reorient the coordinate axis of the selected bone.

Translation Offset

Enter values along one of the axis to move the selected bone.

Smoothing and Damping

Smoothing

Apply double exponential smoothing to translation and rotation of the Trained Markerset. Increasing this setting may help smooth out noise in the Trained Markerset tracking, but excessive smoothing can introduce latency. The default value is 0 (disabled).

Forward Prediction

Compensate for system latency when tracking the corresponding Trained Markerset by predicting its movement into the future. Please note that using higher values may impact the tracking stability. The default value is 0 (disabled).

Translation Damping (Advanced)

When needed, you can damp down translational tracking of the selected bone on the selected axis.

Rotation Damping (Advanced)

You can also damp down rotational tracking of the selected bone.

Rotation Damping Axis (Advanced)

When using Rotation Damping, select whether to apply changes to a selected axis or to all.

Attaching and Modifying Geometry (Advanced Setting)

Geometry (Advanced Setting)

Attach a valid geometric model to the Trained Markerset to display in the the 3D Viewport. Sphere, box, cylinder, and bone segment shapes are built-in; to use your own geometric model, select Custom Model. This will open the Attached Geometry field.

Attached Geometry

The Attached Geometry field becomes available whenever Custom Model is selected for the Rigid Body geometry.

Click the folder to the right of the field to browse to the OBJ or FBX file to replace the Rigid Body. Properties configured in the corresponding MTL files alongside the OBJ file will be loaded as well.

Geometry Settings

Whenever a geometric model is attached, settings to adjust the scale, location, and orientation (Pitch, Yaw, and Roll) are available.

Geometry Tips and Examples

If you are exporting an OBJ file from Maya, make sure the Ambient Color setting is set to white upon export. If this color is set to black, it will remove textures when the Trained Markerset is deselected.

The Properties pane contains advanced settings that are hidden by default. To access these settings, click the button in the top right corner.

To hide the markers associated with a disabled asset in the :

Click to open the Visuals menu.

See the section for information on Geometry settings.

Display the Trained Markerset name in the . When selected, a small label will appear over the asset.

Bones are optional for Trained Markersets and are when needed. The Bones property toggles on the display of a visual of any bones present in the Markerset in the 3D Viewport.

Bones are optional for Trained Markersets and are added manually when needed. Please refer to the page for instructions on adding bones and creating Bone Chains.

3D Viewport
3D Perspective View
Trained Markersets
Attaching and Modifying Geometry
Trained Markerset
3D Viewport
Properties Pane
Properties: Take
Properties: Rigid Body
Properties: Skeleton
Properties: Camera
Properties: eSync
Properties: Force Plates
Properties: NI-DAQ
Assets pane
Properties pane
Assets Settings
added manually
3D viewport
A Trained Markerset with standard properties displayed.
Properties Pane: Trained Markerset Visuals.
Geometry Options for Trained Markersets.
Choosing a color.
Unsolved Bone in a Trained Markerset.
Solved Bone in a Trained Markerset.
Bone Properties for a Trained Markerset that does not have bones.
Bone Properties for a Trained Markerset with a single bone and no bone chains.
Bone Properties for a Trained Markerset bone that is the Parent in a bone chain.
Bone Properties for a Trained Markerset bone that is the Child in a bone chain.
Geometry Options for Trained Markersets.
Attach a Custom Geometry Model.
Geometry Settings in the Properties Pane.
Geometry Properties for a standard Cylinder object attached to a bone in a Trained Markersets.
Common Material Attributes in Maya with Ambient Color selected.
Attached Geometry models with Ambient color set to Black (left) or White (right).