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
  • Quick Start Guide - Auto Configure
  • Active Tag Context Menu Options
  • Assets Pane
  • 3D Viewport
  • Devices Pane
  • Active Tag Table
  • 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 2 months ago

Was this helpful?

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. Select the markers from the active device and create a Rigid Body Asset.

It is highly recommended to make sure all 8 markers can be tracked with minimal occlusions for the best results when pairing and aligning the Rigid Body to the IMU.

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

  2. Move the CinePuck or IMU Active Puck slowly around at least 3 axes until you see 'IMU Working [Good Optical] %'. You have now successfully paired and aligned your CinePuck with your Rigid Body.

  3. Attach your CinePuck to your cinema camera or your regular IMU Active Puck to an object of your choosing.

  4. Enjoy your sensor fused Puck for seamless and robust tracking.

Motive can automatically recognize a CinePuck and after pairing and aligning a Rigid Body to an IMU Tag, will change the name of the Rigid Body to CinePuck_G### along with its marker constraints.

Active Tag Context Menu Options

The options below can be found both by right clicking a Rigid Body in the Assets pane or by selecting the Rigid Body in the 3D Viewport and right clicking to open the context menu.

The Devices pane has a few redundant options as well under the Active Tag section.

Auto Configure Active Tag

This option will pair and align the Rigid Body to the IMU Tag all in one go. This is the quickest and most preferable option when first getting started.

Set Auto Pair

This will set the Puck to search for an IMU pair. Once paired, this will be indicated in the 3D Viewport IMU visual as 'IMU Paired', the Devices pane Active Tag 'Paired Asset' column, and in the Assets pane's 'Active Tag' column.

Unpair Active Tag

This will remove a paired Tag from the Rigid Body.

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.

Align

This allows you to manually align your Tag to your Rigid Body after you have paired.

Remove Alignment

This allows you to remove alignment from your Rigid Body while still paired to the IMU.

Orient Pivot to IMU

If you would like your Pivot orientation to reflect the orientation of your IMU (internal), you can select Orient Pivot to IMU. Motive will recognize the physical orientation of the IMU within the Puck and adjust the Rigid Body pivot bone appropriately.

Assets Pane

Active Tag Column

From the existing Assets pane, you can right click to add columns. For this IMU workflow, you can select Active Tag. The Active Tag column will display either the Paired or fully Paired and Aligned IMU Tag to the Rigid Body Asset. If the Rigid Body is non IMU or is not yet Paired or Aligned, this column will display 'None'.

3D Viewport

In the 3D viewport, just like Labels, you can view the status of the Rigid Body.

Searching for IMU Pair

After either Auto or Manually pairing, the status above your Rigid Body will report 'Searching for IMU Pair'. After moving and rotating your Puck around this should change to 'IMU Paired'.

If it does not, this could mean that an IMU device is not present or is not being recognized. Please check the Devices pane to see if the IMU Device is populated in the table with its Uplink ID. If you are unable to find the Device, please check your RF Channel and Uplink ID using the Active Batch Programmer.

IMU Paired [Optical] %

After your Rigid Body has successfully paired with the IMU Tag, the status will change to IMU Paired [Optical] %.

IMU Working [Optical] %

Once you have either Auto-Configured or Manually Paired and Aligned an Asset, you should see 'IMU Working' appear over your Asset in the 3D viewport.

If you're having issues seeing 'IMU Working,' you may need to rotate the Puck in more axes or try Pairing again and Re-align.

Good Optical: Denotes most markers can be seen and tracked within the volume.

Optical:

Denotes that the minimum markers can be seen and tracked within the volume.

No Optical:

Denotes either below the minimum or no markers can be seen and tracked within the volume.

%:

Percentages denote the amount 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.

Devices Pane

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

Active Tag Table

Name

By default the Name is set to 'Tag XX:XX'. The XX:XX format denotes the RF Channel and Uplink ID respectively. i.e. Tag 20:00 is on RF Channel 20 and has an Uplink ID of 0.

Paired Asset

When an Asset is paired, this will show the Rigid Body name that will be the same as shown in the Assets pane.

Aligned

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

Properties Pane for Tag and Rigid Body

Properties for both the IMU tag by itself (when selected from Devices pane) and for the sensor fused Rigid Body (when selecting the Rigid Body from either the Assets pane or 3D Viewport) can be found in the Properties pane.

Active Tag Properties

The Active Tag does not have any editable properties but does display a few Details and General properties.

Rigid Body Properties

Rigid Body properties that pertain to IMU specific workflows can be found under the General and Visuals sections.

Min Alignment Count

The minimum number of measurements required for the IMU to auto-align. A higher number may result in a better outcome in a suboptimal environment. For example, if the CinePuck isn't being detected as expected, adjusting this value may obtain better results.

This setting is in the General section as an Advanced property.

Max Drift Correction

The rate of drift correction.

This changes how heavily the optical data is weighted or trusted in calculating the drift correction. A drift correction of 1 will look much like the optical data, whereas a drift correction close to 0 will more closely match the IMU data.

This setting is in the General section as an Advanced property.

IMU State

This dropdown in the Visuals section allows you to choose how you would like the IMU State to appear in the 3D viewport.

  • None - No visual in the viewport

  • Text - Text visual in viewport

  • Icon - Icon only visual in viewport

Constraints Pane

After pairing a Rigid Body to an IMU Puck, an IMU Constraint with IMU information will be created for the Rigid Body. This along with an update to the names of Constraints based on what Puck type is identified by Motive.

IMU Constraint

As stated above, the IMU Constraint is created when the IMU Tag is paired to a Rigid Body. This not only stores the information after pairing, but also alignment information when the Align action is performed by either Auto-Configure Active Tag or by Manually Aligning.

If this Constraint is removed, this will remove the pair and/or align information from the Rigid Body. You will need to perform another pair and align to re-adhere the sensor fusion data to the Rigid Body once more.

Active Debugging in Info Pane

The Info pane Active Debugging is used as a troubleshooting tool to see the amount of IMU data packets dropped along with the largest gap between IMU data packets being sent.

When either column exceeds the Maximum settings, the text will turn magenta depending on the logic setup in the Maximum settings at the bottom of the pane.

IMU % Drops

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

Max Gap Size

Max Gap Size denotes the number of frames between IMU data packets sent where the IMU packets were dropped. i.e. 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 288 frames where the IMU packets were either not sent or received.

BaseStation Load Capacity

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

  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

Set the puck on a level surface and wait until the puck is finished calculating its bias. See for a description of each indicator light.

Tags that have come into Motive can be viewed in the Devices pane under the Active Tag section. Please see above for for this pane.

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.

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

PuTTy
below
context menu options
Rigid body (CinePuck) with sensor fusion.
Context Menu in Assets Pane
Context menu in 3D Viewport
Options in Devices pane under Active Tag
IMU Paired Asset information.
Assets pane with Active Tag column.
Active Tag section of the Devices pane.
Active Tag detail in the Devices pane.
Active Tag properties pane.
Text visual in 3D Viewport.
Icon visual in 3D Viewport.
Constraints tab.
CinePuck, powered down.