Main Page → Motive Documentation → Assets → Rigid Body Tracking
In Motive, rigid body assets are used for tracking rigid, undeformable, objects. A set of markers get securely attached to tracked objects, and respective placement information gets used to identify the object and report 6 Degree of Freedom (6DoF) data. Thus, it's important that the distances between placed markers stay the same throughout the range of motion. Either passive retro-reflective markers or active LED markers can be used to define and track a rigid body. This page details instructions on how to create rigid bodies in Motive and other useful features associated with the assets.
A RigidBody in Motive is a collection of three or more markers on an object that are interconnected to each other with an assumption that the tracked object is undeformable. More specifically, it assumes that the spatial relationship among the attached markers remains unchanged and the marker-to-marker distance does not deviate beyond the allowable deflection tolerance defined under the corresponding rigid body properties. Otherwise, involved markers may become unlabeled. Cover any reflective surfaces on the rigid body with non-reflective materials, and attach the markers on the exterior of the rigid body where cameras can easily capture them.
Tip: If you wish to get more accurate 3D orientation data (pitch, roll, and yaw) of a rigid body, it is beneficial to spread markers as far as you can within the same rigid body. By placing the markers this way, any slight deviation in the orientation will be reflected from small changes in the position.
In a 3D space, a minimum of three coordinates is required for defining a plane using vector relationships; likewise, at least three markers are required to define a rigid body in Motive. Whenever possible, it is best to use 4+ markers to create a rigid body. Additional markers provide more 3D coordinates for computing positions and orientations of a rigid body, making overall tracking more stable and less vulnerable to marker occlusions. When any of markers are occluded, Motive can reference to other visible markers to solve for the missing data and compute position and orientation of the rigid body.
However, placing too many markers on one rigid body is not recommended. When too many markers are placed in close vicinity, markers may overlap on the camera view, and Motive may not resolve individual reflections. This may increase the likelihood of label-swaps during capture. Securely place a sufficient number of markers (usually less than 10) just enough to cover the main frame of the rigid body.
Tip: The recommended number of markers per a rigid body is 4 ~ 12 markers. Rigid body cannot be created with more than 20 markers in Motive.
Within a rigid body asset, its markers should be placed asymmetrically because this provides a clear distinction of orientations. Avoid placing the markers in symmetrical shapes such as squares, isosceles, or equilateral triangles. Symmetrical arrangements make asset identification difficult, and they may cause the rigid body assets to flip during capture.
When tracking multiple objects using passive markers, it is beneficial to create unique rigid body assets in Motive. Specifically, you need to place retroreflective markers in a distinctive arrangement between each object, and it will allow Motive to more clearly identify the markers on each rigid body throughout capture. In other words, their unique, non-congruent, arrangements work as distinctive identification flags among multiple assets in Motive. This not only reduces processing loads for the rigid body solver, but it also improves the tracking stability. Not having unique rigid bodies could lead to labeling errors especially when tracking several assets with similar size and shape.
Note for Active Marker Users
The key idea of creating unique rigid body is to avoid geometrical congruency within multiple rigid bodies in Motive.
Having multiple non-unique rigid bodies may lead to mislabeling errors. However, in Motive, non-unique rigid bodies can also be tracked fairly well as long as the non-unique rigid bodies are continuously tracked throughout capture. Motive can refer to the trajectory history to identify and associate corresponding rigid bodies within different frames. In order to track non-unique rigid bodies, you must make sure the Properties → General Settings → Unique setting in Rigid Body Properties of the assets are set to False.
Even though it is possible to track non-unique rigid bodies, it is strongly recommended to make each asset unique. Tracking of multiple congruent rigid bodies could be lost during capture either by occlusion or by stepping outside of the capture volume. Also, when two non-unique rigid bodies are positioned in vicinity and overlap in the scene, their marker labels may get swapped. If this happens, additional efforts will be required for correcting the labels in post-processing of the data.
Depending on the object, there could be limitations on marker placements and number of variations of unique placements that could be achieved. The following list provides sample methods for varying unique arrangements when tracking multiple rigid bodies.
1. Create Distinctive 2D Arrangements. Create distinctive, non-congruent, marker arrangements as the starting point for producing multiple variations, as shown in the examples above.
2. Vary heights. Use marker bases or posts, with different heights to introduce variations in elevation to create additional unique arrangments.
3. Vary Maximum Marker to Marker Distance. Increase or decrease the overall size of the marker arrangements.
4. Add Two (or more) Markers Lastly, if an additional variation is needed, add extra markers to introduce the uniqueness. We recommended adding at least two extra markers in case any of them is occluded.
A set of markers attached to a rigid object can be grouped and auto-labeled as a rigid body. This rigid body definition can be utilized in multiple takes to continuously auto-label the same rigid body markers. Motive recognizes the unique spatial relationship in the marker arrangement and automatically labels each marker to track the rigid body. At least three coordinates are required to define a plane in 3D space, and therefore, a minimum of three markers are essential for creating a rigid body.
Click Create to define a rigid body asset from the selected markers.
You can also create a rigid body by doing the following actions while the markers are selected:
Defining Assets in Edit mode:
Rigid body properties consist of various configurations of rigid body assets in Motive, and they determine how rigid bodies are tracked and displayed in Motive. For more information on each property, read through the Properties: Rigid Body page.
You can add or remove asset model markers from a rigid body or a skeleton using the Builder pane. This is basically adding or removing markers to the existing rigid body and/or skeleton definition. To do this, you will need to make sure the selection of Asset Model Markers is enabled in the Perspective viewport. Then, follow the below steps to add or remove markers:
Multiple Rigid Bodies
When multiple rigid bodies are selected, context-menu applies only to the primary rigid body selection only. The primary rigid body is the last rigid body you selected, and its name will show up on the bottom-right corner of the 3D viewport.
Created rigid body definitions can be modified using the editing tools in the Builder pane or by using the steps covered in the following sections.
The pivot point of a rigid body is used to define both position and orientation. When a rigid body is created, its pivot point is be placed at its geometric center by default, and its orientation axis will be aligned with the global coordinate axis. To view the pivot point and the orientation in the 3D viewport, set the Bone Orientation to true under the display settings of a selected rigid body in the Properties pane.
Position and orientation of a tracked rigid body can be monitored in real-time from the Info pane. You can simply select a rigid body in Motive, open the Info pane, and access the Rigid Bodies tool from the to view respective real-time tracking data of the selected rigid body.
As mentioned previously, the orientation axis of a rigid body, by default, gets aligned with the global axis when the rigid body was first created. After a rigid body is created, its orientation can be adjusted by editing the rigid body orientation using the Builder pane or by using the GIZMO tools as described in the next section.
There are situations where the desired pivot point location is not at the center of a rigid body. The location of a pivot point can be adjusted by assigning it to a marker or by translating along the rigid body axis (x,y,z). For most accurate pivot point location, attach a marker on the desired pivot location, set the pivot point to the marker, and apply the translation for precise adjustments. If you are adjusting the pivot point after the capture, in the Edit mode, the Take will need to be auto-labeled again to apply the changes.
Using the gizmo tools from the perspective view options to easily modify the position and orientation of rigid body pivot points. You can translate and rotate rigid body pivot, assign pivot to a specific marker, and/or assign pivot to a mid-point among selected markers.
Read through the Gizmo tools page for detailed information.
If you wish to reset the pivot point, simply open the rigid body context menu in the Perspective pane and click Reset Pivot. The location of the pivot point will be reset back to the center of the rigid body again.
Rigid body tracking data can be either outputted onto a separate file or streamed to client applications in real-time:
Assets can be exported into Motive user profile (.MOTIVE) file if it needs to be re-imported. The user profile is a text-readable file that can contain various configuration settings in Motive; including the asset definitions.
When the asset definition(s) is exported to a MOTIVE user profile, it stores marker arrangements calibrated in each asset, and they can be imported into different takes without creating a new one in Motive. Note that these files specifically store the spatial relationship of each marker, and therefore, only the identical marker arrangements will be recognized and defined with the imported asset.
To export the assets, go to Files tab → Export Assets to export all of the assets in the Live-mode or in the current TAK file. You can also use Files tab → Export Profile to export other software settings including the assets.
This feature is supported in Live Mode only.
The rigid body refinement tool improves the accuracy of rigid body calculation in Motive. When a rigid body asset is initially created, Motive references only a single frame for defining the rigid body definition. The rigid body refinement tool allows Motive to collect additional samples in the live mode for achieving more accurate tracking results. More specifically, this feature improves the calculation of expected marker locations of the rigid body as well as the position and orientation of the rigid body itself.