LogoLogo
WebsiteSupportDownloadsForumsQuick LinksContact Us
v3.3
v3.3
  • OptiTrack Documentation
  • WHAT'S NEW
    • What's New in Motive 3.3
  • 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
        • VersaX 22
        • VersaX 41
        • VersaX 120
      • 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
      • .mcal XML Calibration Files
      • 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 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
    • OptiTrack MATLAB Plugin
    • 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
      • Wired AnchorPuck
      • CinePuck
      • Wired 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 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
    • VRPN Sample
    • 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
  • Overview
  • Hardware Setup
  • Required Components
  • Active Marker Options
  • Wiring the Components
  • Configuration
  • Motive Settings
  • Live Pipeline Solver Tab - Trajectorizer Section
  • Views 3D Tab - Markers Section
  • Camera Settings
  • Camera Exposure
  • IR LEDs
  • Active Devices in Motive
  • BaseStations
  • Active Tags
  • Active Markers in Motive
  • Active Labels
  • Active Tags in Rigid Bodies
  • Troubleshooting

Was this helpful?

Export as PDF
  1. ACTIVE COMPONENTS

Active Marker Tracking

Instructions to setup and use the OptiTrack active marker solution.

PreviousActive Component Firmware CompatibilityNextActive Finger Marker Set

Was this helpful?

Overview

The OptiTrack Active Tracking solution allows synchronized tracking of active LED markers using an OptiTrack camera system. Consisting of a and one or more active devices such as the "users choice" that can be integrated in to any object, the which can act as its own single Rigid Body, or the , designed to support Virtual Production and broadcast studios.

The BaseStation emits RF signals to the active markers, allowing precise synchronization between camera exposure and illumination of the LEDs. Each active marker is uniquely labeled in Motive, allowing more stable Rigid Body tracking since active markers will never be mislabeled and unique marker placements are no longer required for distinguishing multiple Rigid Bodies.

To configure assets that contain active tags and an Inertial Measurement Unit (IMU) such as Pucks and CinePucks, please refer to the article .

Notes:

  • This guide is for only. Third-party IR LEDs will not work with the instructions provided on this page.

  • This solution is supported only with Ethernet camera systems (Slim 13E or Prime series cameras). USB camera systems are not supported.

  • Active Tracking works with Motive versions 2.x or 3.1 and above. It is not available in version 3.0.

  • This guide covers active component firmware versions 1.0 and above, which includes all active components that were shipped after September 2017. For active components shipped prior to September 2017, please see the page for more information about firmware compatibility.

Hardware Setup

Required Components

BaseStation

  • Emits radio frequency signals to synchronize the active markers.

  • Powered by PoE, connected directly via Ethernet cable to one of the switches in the camera network.

  • Please see the page for product specifications and more information.

Active Marker Options

Active Tags

  • Connects to a USB power source to illuminate the active LEDs.

  • Receives RF signals from the Base Station and synchronizes illumination of the connected active LED markers accordingly.

  • LEDs come in bundles of 4. One or two bundles can be connected to each tag, for a maximum of 8 Active LEDs per Tag.

  • Each LED emits 850 nm IR light.

  • Size: 5 mm (T1 ¾) Plastic Package, half angle ±65°, typ. 12 mW/sr at 100mA

Active Pucks

An active tag self-contained into a trackable object, the Active Puck provides 6 DoF information for any object to which it's attached. Pucks include a factory installed Active Tag with 8 LEDs and a rechargeable battery with up to 10-hours of run time on a single charge.

CinePucks

Similar to the Active Puck, the CinePuck is designed to attach to a movie camera to support In-Camera Virtual Effects, often referred to as InCam VFX or ICVFX. Please see the page Unreal Engine: OptiTrack InCamera VFX for more information.

Wiring the Components

Camera System

BaseStation

  • Connect the BaseStation to one of the PoE switches within the camera network.

  • Metal and other dense materials can cause interference that may reduce the BaseStation's range. For best performance, place the base station near the center of the tracking space, with unobstructed lines of sight to the areas where the Active Tags will be located during use.

  • Do not place external electromagnetic or radiofrequency devices near the Base Station.

  • When Base Station is working properly, the LED closest to the antenna should blink green when Motive is running.

BaseStation LEDs

  • Communication Indicator LED: When the BaseStation is successfully sending data and communicating with the Active Pucks, the LED closest to the antenna will blink green. If this LED turns red, it indicates that the BaseStation failed to establish a connection with Motive.

  • Interference Indicator LED: The middle LED indicates if there are other signal-traffics on the respective radio channel and PAN ID that might be interfering with the active components. This LED should stay dark in order for the active marker system to work properly. If it flashes in red, consider switching both the channel and PAN ID on all of the active components.

  • Power Indicator LED: The LED located at the corner indicates power for the BaseStation. This LED may be disabled on BaseStations with the latest firmware, but on older BaseStations this LED may light up in red to indicate the device has power.

Tag Setup

  1. Connect two sets of active markers (4 LEDs in each set) into a Tag.

  2. Connect the battery and/or a micro USB cable to power the Tag. The Tag takes 3.3V ~ 5.0V of inputs from the micro USB cable. If powering with a battery, use only the batteries supplied by OptiTrack. To recharge the battery, connect it to the Tag then connect the micro USB cable to a power source.

  3. To initialize the Tag, press the power switch once. Be careful not to hold down on the power switch for more than a second, as this will initialize the device in the firmware update (DFU) mode. If it initializes in the DFU mode, which is indicated by two orange LEDs, just power off and restart the Tag. To power off the Tag, hold down on the power switch until the status LEDs go dark.

  4. Once powered, you should be able to see the illumination of IR LEDs from the 2D reference camera view.

Puck Setup

  • Press the power button for 1~2 seconds and release to power the device on.

  • The top-left LED will turn amber while the Puck initializes. The bottom LED will turn green when the Puck has made a successful connection with the BaseStation, at which point the top-left LED will start blinking green to indicate the sync packets are being received.

Configuration

As shipped, BaseStations and active devices will connect to the OptiTrack system without additional configuration by the user. Some circumstances may require a configuration update, such as when adding new BaseStations to an existing system or to change the RF channel or BaseStation divisor rate.

The BaseStation is configured outside of Motive, using one of the following programs:

Please see the linked pages for more details on configuring the BaseStation.

Motive Settings

The following settings are relevant to Active Tracking.

Live Pipeline Solver Tab - Trajectorizer Section

Active Pattern Depth

Default value: 12

This setting adjusts the complexity of the illumination patterns produced by active markers.

In most applications, the default value is sufficient for high quality tracking results. If a large number of Rigid Bodies are tracked simultaneously, increase the value to allow more combinations of illumination patterns on each marker.

If this value is set too low, duplicate active IDs can be produced, should this error appear increase the value of this setting.

Minimum Active Count

Default value: 3

This sets the number of rays required to establish the active ID for each on frame of an active marker cycle.

Views 3D Tab - Markers Section

Active

Default color: blue

Intermediate

Default color: white

Intermediate markers are active markers in a temporary state prior to being identified in Motive. These markers change to the active marker color (or the asset color, if different) once Motive identifies them.

Camera Settings

The following camera settings yield the best tracking results for active LED markers.

Camera Exposure

Set the camera exposure a bit higher than you would when tracking passive markers. This allows the cameras to better detect the active markers. The optimal value will vary depending on the camera system setup, but in general, set the camera exposure between 400 ~ 750, microseconds.

IR LEDs

Active Devices in Motive

BaseStations

BaseStations are listed in the Synchronization category of the Devices pane. Available display options are the Device (device type) and the Serial number.

Active Tags

Active devices that connect to the camera system via BaseStations are listed in the Active Tag section. The following properties are available:

  • Name: the tag name consists of two numbers, the the RF channel used to communicate with the Base Station followed by the unique Uplink ID assigned to the device.

  • Paired Asset: If the tag is paired to an asset, the asset's name will appear here. Otherwise, the field will display N/A.

  • Aligned: shows the status of the Active tag.

  • BaseStation: displays the serial number of the connected BaseStation. This column is not displayed by default; right-click the header to add it.

Active Markers in Motive

Active Labels

Active Markers are reconstructed and tracked in Motive automatically. The unique illumination pattern ensures each active marker is individually labeled, with an Active ID assigned to the corresponding reconstruction. This applies whether or not the Active Marker is part of an asset.

  1. Enable the Marker Labels and the Active ID options.

Active IDs that are not part of an asset:

The same Active IDs after asset creation:

Rigid body definitions created using Active Markers will search for specific Active IDs along with the marker placements to track the Rigid Body. See below for more details.

Duplicate active frame IDs

This Notification displays if more than one marker has the same ID. Duplicate IDs may cause errors during 3D reconstruction.

Active Tags in Rigid Bodies

As noted above, rigid body definitions created from reconstructions with Active IDs will search for those IDs to solve the Rigid Body. This means active markers can be placed in perfectly symmetrical marker arrangements across multiple Rigid Bodies without the risk of labeling swaps.

For more information, please see the following pages:

Troubleshooting

Q : Active markers are flickering in both the 3D viewport and Cameras view in Motive.
  • Flickering can also occur if the volume does not have adequate camera coverage. Adjusting the exposure rate can also contribute to better marker detection.

Please see the page for more information.

For product specifications and other information about the Puck, please see the page .

To configure Pucks that contain an Inertial Measurement Unit (IMU), please refer to the page .

For product specifications and other information about the CinePuck, please see the page .

All CinePucks contain an Inertial Measurement Unit (IMU). Please refer to the page for instructions to configure the CinePuck.

Active tracking is supported only with an Ethernet camera system (Prime series or Slime 13E cameras). For instructions on how to set up a camera system, please refer to the chapter.

The number of Active Devices that can attach to a a single BaseStation is determined by the system frame rate and the divisor applied to the BaseStation. The on the page shows the IMU maximum for common frame rates and divisors.

For more information, please read the page.

Use the panel to customize Motive and set default values. Application Settings can be accessed from the or by clicking the icon on the main toolbar.

→ Solver Tab -> Trajectorizer

The default value works well for the majority of applications. If this value is increased and active markers become occluded, it may take longer to reestablish those markers in the .

The Markers section sets the default color assigned to different types of markers. Markers that are part of an asset will use the color selected in the visuals section of the .

The Active setting distinguishes active markers from passive in the .

When tracking active markers only, the cameras do not need to emit IR lights. In this case, you can disable the LED lights in the .

Information about BaseStations and Active Tags is available in the . Select an item in the Devices pane to view its properties in the . All values are read-only.

The is required to view additional settings or make configuration changes to a Base Station and its associated active devices.

If the tag is unpaired, the circle x icon will appear.

If the tag is pairing, the circle with the wave icon will appear.

If the tag is paired, the green circle with green check icon will appear.

The Active IDs can be monitored in the as part of the marker label, in both Live and Edit modes. To view:

Click the in the 3D Viewport to open the Visual Aids menu.

If this occurs, please for assistance.

To create or modify a Rigid Body asset, please see .

To configure Pucks and CinePucks with IMU sensors, please see .

Flicker can be caused by RF interference. Try changing the RF channel for the BaseStation using the

Information for Assembling the Active Tags
Active Puck
IMU Sensor Fusion
CinePuck
IMU Sensor Fusion
Ethernet Camera Network Setup
Active Puck
Active Batch Programmer
PuTTy
Settings → Live Pipeline
Asset Properties
Devices pane
Devices pane
Properties pane
Active Batch Programmer
contact support
Rigid Body Tracking
IMU Sensor Fusion
Active Batch Programmer.
BaseStation
CinePuck
IMU Sensor Fusion
OptiTrack active markers
compatibility notes
BaseStation
Active Tags
Active Puck
BaseStation
Application Settings
Motive 3D Viewport
Motive 3D Viewport
3D Viewport
BaseStation Load Capacity table
Settings → Views → 3D Tab -> Markers
BaseStation.
Active Tags.
Active Puck.
CinePuck.
BaseStation Setup
Assembled Tags
Puck initializing. Top-left: Amber.
Connected to BaseStation & receiving sync packets.
BaseStation and Active Tag in the Devices Pane.
Unique Active IDs assigned to unlabeled active markers.
Unique Active IDs assigned to active markers in a Rigid Body.
View menu