Labeling
Last updated
Was this helpful?
v2.3
Last updated
Was this helpful?
This page provides basic description of marker labels and instructions on labeling workflow in Motive.
Marker Label
Marker labels are basically software name tags that are assigned to trajectories of reconstructed 3D markers so that they can be referenced for tracking individual markers, Rigid Bodies, or Skeletons. Motive identifies marker trajectories using the assigned labels. Labeled trajectories can be exported individually, or combined together to compute positions and orientations of the tracked objects. In most applications, all of the target 3D markers will need to be labeled in Motive. There are two methods for labeling markers in Motive: auto-labeling and manual labeling, and both labeling methods will be covered in this page.
Monitoring Labels
Labeled or unlabeled trajectories can be identified and resolved from the following places in Motive:
There are two approaches to labeling markers in Motive:
Auto-label pipeline: Automatically label sets of Rigid Body markers and Skeleton markers using calibrated asset definitions.
Rigid body and Skeleton asset definitions contain information of marker placements on corresponding assets. This is recorded when the assets are first created, and the auto-labeler in Motive uses them to label a set of reconstructed 3D trajectories that resemble marker arrangements of active assets. Once all of the markers on active assets are successfully labeled, corresponding Rigid Bodies and Skeletons get tracked in the 3D viewport.
The auto-labeler runs in real-time during Live mode and the marker labels get saved onto the recorded TAKs. Running the auto-labeler again in post-processing will basically attempt to label the Rigid Body and Skeleton markers again from the 3D data.
From Data pane
Right-click to bring up the context menu
Click reconstruct and auto-label' to process selected Takes. The this pipeline will create a new set of 3D data and auto-label the markers from it.
This will label all the markers that matches the corresponding asset definition.
Since creating rigid bodies, or skeletons, groups the markers in each set and automatically labels them, Marker Sets are not commonly used in the processing workflow. However, they are still useful for marker-specific tracking applications or when the marker labeling is done in pipelines other than auto-labeling. Also, marker sets are useful when organizing and reassigning the labels.
Under the drop-down menu in the Labels pane, select an asset you wish to label.
All of the involved markers will be displayed under the columns.
From the label list, select unlabeled or mislabeled markers.
Step 4. Select an asset that you wish to label.
Step 5. From the label columns, Click on a marker label that you wish to re-assign.
Step 6. Inspect behavior of a selected trajectory and its labeling errors and set the appropriate labeling settings (allowable gap size, maximum spike and applied frame ranges).
Step 7. Switch to the QuickLabel mode (Hotkey: D).
Step 9. When all markers have been labeled, switch back to the Select Mode.
Step 1. Start with 2D data of a captured Take with model assets (Skeletons and Rigid Bodies).
Step 3. Examine the reconstructed 3D data, and inspect the frame range where markers are mislabeled.
Step 5. Unlabel all trajectories you want to re-auto-label.
Step 6. Auto-Label the Take again. Only the unlabeled markers will get re-labeled, and all existing labels will be kept the same.
Step 7. Re-examine the marker labels. If some of the labels are still not assigned correctly from any of the frames, repeat the steps 3-6 until complete.
The general process for resolving labeling error is:
Identify the trajectory with the labeling error.
Determine if the error is a swap, an occlusion, or unlabeled.
Resolve the error with the correct tool.
Swap: Use the Swap Fix tool ( Edit Tools ) or just re-assign each label ( Labels panel ).
When manually labeling markers to fix swaps, set appropriate settings for the labeling direction, max spike, and selected range settings.
Occlusion: Use the Gap Fill tool ( Edit Tools ).
Unlabeled: Manually label an unlabeled trajectory with the correct label ( Labels panel ).
When recorded 3D data have been labeled properly and entirely throughout the Take, you will not need to edit marker labels. If you don't have 3D data recorded, you can reconstruct and auto-label the Take to obtain 3D data and label all of the skeleton and rigid body markers. If all of the markers are well reconstructed and there are no significant occlusions, auto-labeled 3D data may be acceptable right away. In this case, you can proceed without post-processing of marker labels.
Recorded 3D data has no gaps in the labels, or the Reconstruct and Auto-label works perfectly the first time without additional post-processing.
Done.
When skeleton markers are mislabeled only within specific frame ranges of a Take, you will have to manually re-label the markers. This may occur when a subject performs dynamic movements or come into contact with another object during the recorded Take. After correcting the mislabeled markers, you can also use the auto-labeler to assign remaining missing labels.
Start with recorded 3D data or Reconstruct and auto-label the Take to obtain newly labeled 3D data.
Inspect the Take to pick out the frame ranges with bad tracking.
Scrub the timeline to a frame just before the bad tracking frame range.
Scrub the timeline to a frame after the bad tracking frame range.
Manually label the same skeleton.
Auto-label the Take.
Check the frames again and correct any remaining mislabels using the Labeling pane.
For Take(s) where skeletons are never perfectly tracked and the markers are consistently mislabeled, you will need to manually assign the correct labels for the skeleton asset(s). Situations like this could happen when the skeleton(s) are never in an easily trackable pose throughout the Take (e.g. captures where the actors are rolling on the ground). It is usually recommended that all skeleton ‘’Takes’’’ start and end with T-pose in order to easily distinguish the skeleton markers.
This also helps the skeleton solver to correctly auto-label the associated markers; however, in some cases, only specific section of a Take needs be trimmed out, or including the calibration poses might not be possible. Manually assigning labels can help the auto-labeler to correctly label markers and have skeletons acquire properly in a Take.
You will get best results if you manually label the entire skeleton, but doing so can be time-consuming. You can also label only the mislabeled segment or the key segment (hip bone) and run the auto-labeler to see if it correctly assigns the labels with the small help.
Start with recorded 3D data or Reconstruct the Take.
Check to see if all markers are correctly assigned throughout the take. If not, re-label or unlabel, any mislabeled markers and run auto-label again if needed.
Marker occlusions can be critical to the auto-labeling process. After having a gap for multiple frames, occluded markers can be unlabeled entirely, or nearby reconstructions can be mistakenly recognized as the occluded marker and result in labeling swaps or mislabels. Skeleton and rigid body asset definitions may accommodate labeling for such occlusions, but in some cases, labeling errors may persist throughout the Take. The following steps can be used to re-assign the labels in this case.
Start with recorded 3D data or Reconstruct and auto-label the Take
Examine through the Take, and go to a frame where markers are mislabeled right after an occlusion.
Using the Quick Label Mode, correct the labeling errors.
Move onto next occluded frames. When the marker reappears, correct the labels.
After correcting the labels, Auto-label the Take again.
: From the 3D viewport, check the Marker Labels in the visual aids option to view marker labels for selected markers.
: The Labels pane lists out all of the marker labels and corresponding percentage gap for each label. The color of the label also indicates whether if the label is present or missing at the current frame.
: For frames where the selected label is not assigned to any markers, the timeline scrubber gets highlighted in red. Also, the tracks view of this pane provides a list of labels and their continuity in a captured Take.
Manual Label: Manually label individual markers using the .
For tracking Rigid Bodies and Skeletons, Motive can use the to automatically label associated markers both in real-time and post-processing. The auto-labeler uses references assets that are enabled, or assets that are checked in the , to search for a set of markers that matches with the definition and assign pre-defined labels throughout the capture.
There are times, however, when it is necessary to manually label a section or all of a trajectory, either because the markers of a Rigid Body or a Skeleton were misidentified (or unidentified) during capture or because individual markers need to be labeled without using any tracking assets. In these cases, the in Motive is used to perform manual labeling of individual trajectories. Manual labeling workflow is supported only in post-processing of capture when a Take file (TAK) has been loaded with 3D data as its playback type. In case of only capture, the Take must be Reconstructed first in order to assign, or edit, the marker labels in its 3D data. This manual labeling process, along with is typically referred to as post processing of mocap data.
Select Takes from the
The settings for the auto-labeling engine are defined in the section of the Reconstruction pane. The auto-labeler parameters can be modified during post-processing pipelines, and they can be optimized for stable labeling of markers throughout the Take.
Note: Be careful when reconstructing a Take again either by Reconstruct or Reconstruct and Auto-label, because it will overwrite the 3D data and any post-processing edits on trajectories and marker labels will be discarded. Also, for Takes involving Skeleton assets, the recorded Skeleton marker labels, which were intact during the live capture, may be discarded, and reconstructed markers may not be auto-labeled again if the Skeletons are never in well-trackable poses throughout the captured Take. This is another reason why you want to start a capture with a calibration pose (e.g. ).
The Marker Set is a type of in Motive. It is the most fundamental method of grouping related markers, and this can be used to manually label individual markers in post-processing of captured data using the . Note that Marker Sets are used for manual labeling only. For automatic labeling during live mode, a Rigid Body asset or a Skeleton asset is necessary.
To create a MarkerSet, click the icon under the and select New Marker Set.
Once a MarkerSet asset is created, its list of labels can be managed using the . First of all, markerset assets must be selected in Motive and the corresponding asset will be listed on the markerset pane. Then, new marker labels can be added by clicking the Icon. If you wish to create multiple marker labels at once, they can added by typing in the labels or copying and pasting a list of labels (a carriage-return delimited) from the windows clipboard onto the pane as shown in the image below..(Press Ctrl+V in the Marker List window).
The is used to assign, remove, and edit marker labels in the . The Tracks View under the can be used in conjunction with the Labels pane to monitor which markers and gaps are associated. The Labels pane is also used to examine the number of occluded gaps in each label, and it can be used along with the for complete post-processing.
Using the Labels pane, you can assign marker labels for each asset (Marker Set, Rigid Body, and Skeleton) via the QuickLabel Mode . The Labels pane also shows a list of labels involved in the Take and their corresponding percent completeness values. The percent completeness values indicate frame percentages of a Take for which the trajectory has been labeled. If the trajectory has no gaps (100% complete), no number will be shown. You can use this pane together with the to quickly locate gaps in a trajectory.
For a given frame, all labels are color-coded. For each frame of 3D data, assigned marker labels are shown in white, labels without reconstructions are shown in red, and unlabeled reconstructions are shown in orange; similar to how they are presented in the .
See the page for detailed explanation on each option.
The QuickLabel mode allows you to tag labels with single-clicks in the view pane, and it is a handy way to reassign or modify marker labels throughout the capture. When the QuickLabel mode is toggled, the mouse cursor switches to a finger icon with the selected label name attached next to it. Also, when the display label option is enabled in the , all of assigned marker labels will be displayed next to each marker in the , as shown in the image below. Select the marker set you wish to label, and tag the appropriate labels to each marker throughout the capture.
When assigning labels using the Quick Label Mode, the labeling scope is configured from the labeling range settings. You can restrict the labeling operation to apply from the current frame backward, current frame forward, or both depending on the trajectory. You may also restrict labeling operations to apply the selected label to all frames in the Take, to a selected frame range, or to a trajectory 'fragment' enclosed by gaps or spikes. The fragment/spike setting is used by default and this best identifies mislabeled frame ranges and assigns marker labels. See the page for details on each feature.
Inspect the behavior of the selected trajectory and decide whether you want to apply the selected label to frames forward or frames backward or both. This option can be selected from on the Labels pane.
Switch to QuickLabeling Mode (Hotkey: D).
In the pane. Assign the selected label to a marker. If the Increment Option () is set under the Labels pane, the label selection in the Labels pane will automatically advance each time you assign them.
After assigning all labels, switch back to normal Select Mode .
If the marker labels are set to visible in the , Motive will show all of the marker labels when entering the QuickLabel mode. To hide all of the marker labels from showing up in the viewport, you can click on the visual aids option in the perspective view, and uncheck marker labels.
The following section provides the general labeling steps in Motive. Note that the labeling workflow is flexible and alternative approaches to the steps listed in this section could also be used. Utilize the auto-labeling pipelines in combination with the to best reconstruct and label the 3D data of your capture.
Use the to monitor occlusion gaps and labeling errors as you post-process capture Takes
When using the , choose the most appropriate labeling setting (all, selected, spike, or fragment) to efficiently label selected trajectories. See more from the Labeling pane page.
can increase the speed of the workflow. Use Z and Shift+Z hotkeys to quickly find gaps in the selected trajectory.
Show/Hide skeleton visibility in the to have a better view on the markers when assigning marker labels.
Toggle skeleton selectability in the perspective view to use the skeleton as a visual aid without it getting in the way of marker data.
Show/Hide skeleton sticks and marker colors under the visual aids in the perspective view options for intuitive identification of labeled markers as you tag through skeleton markers.
For skeleton assets, the property can be utilized to display tracking errors on skeleton segments.
Step 1. In the , Reconstruct and auto-label the take with all of the desired assets enabled.
Step 2. In the , examine the trajectories and navigate to the frame where labeling errors are frequent.
Step 3. Open the .
Step 8. On the , assign the labels onto the corresponding marker reconstructions by clicking on them.
Step 2. Reconstruct and Auto-Label, or just Reconstruct, the Take with all of the desired assets enabled under the . If you use reconstruct only, you can skip step 3 and 5 for the first iteration.
Step 4. Using the , manually fix/assign marker labels, paying attention to your label settings (direction, max gap, max spike, selected duration).
For more data editing options, read through the page.
Following tutorials use Motive 1.10. On Motive 2.0., and is used instead of the Project pane.
Examine the Take(s). Check the Labeling pane, or the , to make sure no occlusion exists within the capture, and all markers are consistently labeled.
If markers are mislabeled during majority of the capture, unlabel all markers from the entire capture by right-clicking on the Take in and click Delete Marker Labels. You can do this on selected frame ranges as well.
Using the , manually label the skeleton. Depending on the severity of the mislabels, you can either label the entire skeleton or just the key segments starting from the hip.
At a certain point of the Take (usually at a frame where you can best identify the pose of the skeleton), use the to manually assign the marker labels for skeletons that are not labeling correctly. Depending on the severity of the mislabels, you can either label the entire skeleton or only the key segments starting from the hip.
After manually assigning the labels, auto-label the Take. Make sure the corresponding assets are enabled in the .
If tracked markers are relatively stationary during the occluded frames, you may want to increase the Maximum Marker Label Gap value under the Auto-Labeler settings in the to allow the occluded marker to maintain its label after auto-labeling the Take. However, note that adjusting this setting will not be useful if the marker is moving dynamically beyond the Prediction Radius (mm) settings during occlusion.
In the Labeling pane, disable the Increment Label Selection option, and select a marker set and a label that is frequently occluded.
In the Labeling pane, disable the Apply Labels to Previous Frames option, and leave only the Apply Labels to Upcoming Frames option enabled.
Use the Fill Gaps tool in the to interpolate the occluded trajectories.
