LogoLogo
WebsiteSupportDownloadsForumsQuick LinksContact Us
v3.2
v3.2
  • OptiTrack Documentation
  • WHAT'S NEW
    • What's New in Motive 3.2
  • 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
        • V120:Duo
        • V120:Trio
        • 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
      • V120:Duo and Trio 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
  • Quick Start Guide - Auto Configure
  • Active Tag Context Menu Options
  • Viewport Active Tag Menu
  • Devices Pane Active Tag Menu
  • Assets Pane
  • 3D Viewport
  • Devices Pane Active Tag Section
  • Properties Pane for Tag and Rigid Body
  • Active Tag Properties
  • Rigid Body Properties
  • Constraints Pane
  • IMU Constraint
  • Active Debugging in Info Pane
  • BaseStation Load Capacity
  • CinePuck and other IMU Active Puck Indicator Lights

Was this helpful?

Export as PDF
  1. MOTIVE

IMU Sensor Fusion

PreviousTrained MarkersetsNextData Recording

Last updated 1 month ago

Was this helpful?

Overview

An Inertial Measurement Unit (IMU) communicates coordinate data to Motive either through an Ethernet cable or through a connected BaseStation. When connected to an Active device containing an Inertial Measurement Unit (IMU), Motive is able to fuse the inertial and optical sources of data to produce more precise and accurate tracking.

The process of merging the IMU data with the optical data is known as Sensor Fusion.

Quick Start Guide - Auto Configure

First and foremost, ensure that your tracking volume is setup with optimal conditions and your Calibration is Exceptional.

  1. Power on either a CinePuck or an Active IMU puck.

  2. Set the puck on a level surface and wait until the puck is finished calculating its bias. See below for a description of the various indicator lights.

We highly recommend ensuring all markers can be tracked with minimal occlusions for the best results when pairing and aligning the Rigid Body to the IMU.

  1. The Active Tag is displayed in the Devices pane. When selected, the tag's properties are visible in the Properties pane. These properties are read-only.

  1. Right click the Rigid Body in the Assets pane and select Active Tags -> Auto-Configure Active Tag.

  1. Attach the CinePuck to the cinema camera or the Active Puck to the object to be tracked. The sensor-fused Puck is now available for seamless and robust tracking.

If the IMU Does Not Pair

This could mean that an IMU device is not present in the Rigid Body or it is not being recognized.

  • Check the Devices pane to see if the IMU Device is populated in the table with its Uplink ID.

  • If the device is not listed, use Active Batch Programmer to check the RF Channel and Uplink ID. If the device is set to the correct RF channel and an IMU does not appear, the active device may not have an IMU.

If the IMU Doesn't Fuse

  • Try rotating the Puck on more axes.

  • Check the label above the rigid body asset to see if it is collecting alignment samples. If the number of samples does not increase as you rotate the tracker, the optical data may not be reliable enough to calculate an alignment.

  • Unpair the IMU and complete the pairing and alignment process again.

Active Tag Context Menu Options

Viewport Active Tag Menu

Active Tag options are also available by right clicking a Rigid Body in the Viewport:

Auto-Configure Active Tag

This option pairs and aligns the Rigid Body to the IMU Tag all at once. This is the recommended method when getting started as it is also the quickest.

Set Auto Pair

Auto-Pair causes Motive to search for an IMU whose movements match the rigid body asset. Rotate the rigid body and Motive will find and pair it to the IMU automatically.

Once paired, this alignment status will be indicated in the 3D Viewport IMU visual. The asset name will display in the Devices pane Active Tag Paired Asset column, and in the Assets pane's Active Tag column.

Auto-Configure vs. Auto-Pair

Auto-Configure sets a property that allows tracking to continue if there are no markers visible to the cameras, whereas Auto-Pair does not.

Both functions begin the alignment process immediately after pairing.

Unpair Active Tag

This will remove a paired Tag from the Rigid Body.

Align

Manually align the Tag to the Rigid Body after pairing. A minimum of 10 alignment samples are required; see the IMU label in the Viewport for the total number of samples currently collected.

Remove Alignment

Remove alignment from the Rigid Body while still paired to the IMU.

Orient Pivot to IMU

Sets the pivot orientation to reflect the orientation of the IMU (internal). Motive will recognize the physical orientation of the IMU within the Puck and adjust the Rigid Body pivot bone appropriately.

Devices Pane Active Tag Menu

Other options are available by right-clicking the tag in the Devices pane:

Groups

Groups are a convenient way to manage multiple devices that require the same settings.

Add to Group

Add selected devices to a new or existing group with the Add to Group option.

Remove from Groups

Removes the selected devices from all groups.

Manual Pair

If manually pairing from the Devices pane:

  • Choose the Rigid Body you would like to pair to the selected Tag in the Devices pane.

If manually pairing from the Assets pane:

  • Choose the Active Tag you would like to pair to the selected Rigid Body in the Assets pane.

Assets Pane

Active Tag Column

Right click the header of the Assets pane to add columns. For this IMU workflow, we recommend adding the Active Tag column. The Active Tag column will display the status along with the ID of the paired device.

  • Auto-pairing: This status appears while the auto-pair process is running on the device.

  • Paired: Indicates that the IMU is paired to the Rigid Body, but sensor fusion has not been performed yet.

  • Fused: The IMU is paired to the Rigid Body and sensor fusion has been completed.

  • None: The Rigid Body does not have an IMU or is not yet Paired, this column will display "None."

3D Viewport

If the IMU label is enabled in the Rigid Body Properties, the Viewport will display the status of the IMU Sensor Fusion process.

Rotate to Pair IMU

After Auto or Manually pairing, the status label above the Rigid Body will display Rotate to Pair IMU.

Rotate to Align (##/100)

Move and rotate the Rigid Body around to complete the alignment. The IMU label will display the status of the alignment as a fraction, i.e. 27/100.

%:

The Percentage of IMU packets that an IMU Tag is successfully delivering for every 100 frames. 100% indicates all packets are going through; 80% indicates 20% of IMU packets were dropped.

Fused

The IMU is now successfully paired and aligned with the Rigid Body.

Optical Status

The Optical status at the end of the label indicates how many of the Rigid Body's markers can be seen and tracked within the volume.

  • Optical Good: most markers can be seen and tracked.

  • Optical: the minimum number of markers can be seen and tracked.

  • No Optical: either fewer than the minimum or no markers can be seen and tracked.

Devices Pane Active Tag Section

Tags recognized by Motive are listed in the Devices pane under the Active Tag section. Please see the section above for context menu options for this pane.

Only devices with firmware 2.2 and above are included in the Devices pane.

Name

The Name identifies the type of tag, i.e., AnchorPuck, Wired CinePuck. For wireless devices, the Name is set to Tag ##:##, where the first set of numbers indicates the RF Channel and the second the Uplink ID. For example, Tag 22:02 is on RF Channel 22 and has an Uplink ID of 2.

Paired Asset

When an Asset is paired to the Active Tag, this column displays the associated Rigid Body name, as shown in the Assets pane.

Aligned

The Aligned column will show the Aligned status of the Active Tag.

Illumination

The amount of time the LEDs are on for each frame. This setting applies only to Wired CinePuck and the Anchor Puck at this time.

This value should be aligned with the exposure of the cameras for maximum brightness.

Group

The active pattern grouping currently applied to the device.

Properties Pane for Tag and Rigid Body

Active Tag Properties

Click any tag in the Devices Pane to display its properties in the Properties pane. In Live mode, these properties can be edited for Wired tags. For wireless devices, these values are read-only.

For wireless devices, the RF Channel and Uplink ID can be changed using Active Batch Programmer.

Rigid Body Properties

Rigid Body properties that pertain to IMU specific workflows can be found under the Sensor Fusion section.

IMU Label

Display a label with the status of the Rigid Body's IMU in the 3D Perspective View. If the asset Label is enabled, the IMU state is appended to the asset name.

  • None - No visual is displayed.

  • Text - Descriptive text provides detailed information about the IMU state.

  • Icon - An icon-only visual is used.

The text label includes the following information:

  • Tag Name.

  • The status of Sensor Fusion:

    • Rotate to Align (##/100): this status indicates that more rotations are required to align the IMU with the Rigid Body.

    • Fused: Sensor Fusion completed successfully.

Min Alignment Count (Advanced)

The minimum number of measurements required for the IMU to auto-align. Higher values may lead to fewer alignment errors, but each new sample will have less of an effect on the estimate than the previous sample.

Max Drift Correction (Advanced)

Determines the rate at which the drift in the IMU data is corrected to optical. Higher values will lead to more responsive turning behavior, but more noise while stationary.

Drift Correction Frames (Advanced)

The number of frames over which drift correction can apply.

Impulse Correction Angle (Advanced)

Determines the angle (in degrees) between the calculated drift correction and the current drift correction that will trigger correction. Impulse correction differs from standard drift correction, causing an immediate correction to optical. This is used primarily to prevent physical impacts to the IMU from causing degraded tracking.

Constraints Pane

After pairing a Rigid Body to an IMU Puck, an IMU Constraint with IMU information is created for the Rigid Body. The pairing process will also update the Constraint names based on the Puck type identified by Motive.

IMU Constraint

The IMU Constraint stores the alignment information from when the Align action is performed, using either Auto-Group Active Tag or by Manually Aligning.

Removing this Constraint will remove the pair and/or align information from the Rigid Body. Pair and align the tag again to re-adhere the sensor fusion data to the Rigid Body.

Active Debugging in Info Pane

IMU % Drops

This column denotes the number of IMU packet drops that an IMU Tag encountered over 60 frames.

Max Gap Size

Max Gap Size is the number of frames between IMU data packets sent where the IMU packets were dropped. For example, in the image above on the left, the maximum gap is a 1 frame gap where IMU packets were either not sent or received. The image on the right has a gap of 3 frames where the IMU packets were either not sent or received.

Alignment

The difference between the IMU rotation and the optical rotation after alignment. If this value exceeds 1 degree, it may indicate that the IMU and optical have become misaligned and should undergo the alignment process again.

BaseStation Load Capacity

Wireless pucks and CinePucks attach to the camera system using a BaseStation. The number of IMUs that can attach to a BaseStation is determined by the system frame rate and the divisor applied to the BaseStation. The table below shows the IMU maximum for common frame rates with a divisor rate of 1, 2, and in some cases 3.

Frame Rate
Divisor Rate 1
Divisor Rate 2
Divisor Rate 3

60

26

54

83

70

22

47

71

80

19

39

62

90

16

36

54

100

14

32

49

110

13

29

44

120

11

26

40

130

10

24

140

9

22

34

150

9

20

160

8

19

30

170

7

17

180

7

16

26

190

6

15

200

6

14

23

210

5

14

220

5

13

21

230

5

12

240

4

11

18

250

4

11

As noted, the table does not include all possible frame rate and divisor combinations. If you are familiar with using Tera Term or PuTTy, you can determine the maximum number of IMUs for any specific frame rate and divisor combination not shown on the table.

  1. Use PuTTy to change the divisor rate on the BaseStation.

  2. Connect an IMU puck to PuTTy.

  3. Attempt to set the ID of the puck to an unrealistically high value. This triggers a warning that includes the current number of slots available for the given frame rate.

  4. Set the IMU puck ID to the highest available slot for the frame rate and confirm that it appears in Motive.

BaseStations have 16 radio frequency (RF) channels available for use (11-26). When adding more than one BaseStation to a system, the IMU count is simply the maximum number of IMUs multiplied by the number of BaseStations (up to 16). For example, in a system with 4 BaseStations running at 90Hz and a divisor rate of 3, the number of allowable IMUs would be 216 (54*4=216).

CinePuck and other IMU Active Puck Indicator Lights

Color
Description
Troubleshooting

Bottom Right:

Orange

Powered ON and Booting

N/A

Top: Flashing Red/Green

Calculating bias. Please set on level surface.

N/A

Top: Fast flashing Green Bottom Right: Slow flashing Green

Bias has been successfully calculated and Puck is connected to BaseStation

N/A

Top: Solid Red then no light Bottom Right: Slow flashing Green

After powering on, the top light turns a solid red then turns off. This means that it is not paired to a BaseStation. The slow flashing Green indicates that it is still ON.

Please check your RF Channel on both devices to ensure they match.

Top: Solid Green then no light Bottom Right: Slow flashing Green

The puck is disconnected from the BaseStation WHILE powered ON.

Please check your BaseStation and ensure it is powered ON and receiving a signal from the network cable/switch.

Top: Fast Flashing Green Bottom Right: Orange

Battery power is below half.

Please connect device to power or let charge before continuing.

Bottom Right: Flashing Red

Battery is nearly depleted.

Please connect device to power or let charge before continuing.

Bottom Left: Red

Plugged in and charging.

N/A

Select the markers from the active device and create a Rigid Body Asset. Please see the the section of the Builder pane page for further instructions.

Move the active device slowly around at least 3 axes. The status will update in the the Properties pane, and the Alignment status in the Devices pane will display a circled wave: . The IMU label will also display the status in the Viewport.

Continue rotating the active device until the Alignment status in the Devices pane updates to a circled checkmark: . The IMU is now successfully paired and aligned with the Rigid Body.

Click the button at the top of the Devices pane to select from the list of available .

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

If the tag is aligning with a rigid body, the circle with the wave icon will appear.

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

The tool on the Info pane is a troubleshooting aid for active devices. IMU status information is displayed in gray text when it falls within the user-established parameters set at the bottom of the pane. Magenta text indicates that values exceed the parameters.

Create Rigid Body
Active Debugging
Device Groups
Rigid body (Puck) with sensor fusion.
Properties pane and Devices pane for an unpaired IMU (Wired CinePuck).
Context Menu from the Assets pane.
Active Tag status and Properties during alignment.
Properties for an Active Tag that is successfully fused to the Rigid Body.
The Active Tag context menu from the Viewport.
The Active Tag context menu from the Devices pane.
The Active Tag column in the Assets pane.
Fused and Paired IMUs in the Assets pane.
Stage 1 of Sensor Fusion: IMU is paired but alignment has not started.
Alignment progress displayed in the IMU label.
An Active Puck with a successful Sensor Fusion.
Active Tag section of the Devices pane.
Active Tag properties pane.
Sensor Fusion section of the Rigid Body properties.
Text visual in 3D Viewport.
Icon visual in 3D Viewport.
Constraints tab.
Active Debugging Info pane: within parameters.
Active Debugging Info pane: outside parameters.
Wireless CinePuck, powered down.