Difference between revisions of "Template:LabelingSamples"

Line 27: Line 27:
  
  
====Sample Scenario 3 :: Mislabeling/unlabeling of a marker due to frequent occlusions====
+
====Sample Scenario 3 :: Mislabeling/unlabeling of a marker due to occlusions====
 
[[Image:Labeling_Scenario4|thumb|Occlusions]]
 
[[Image:Labeling_Scenario4|thumb|Occlusions]]
 
{{Indent|
 
{{Indent|

Revision as of 16:04, 27 April 2016

Sample Scenario 1 :: All Good

File:Labeling Scenario1
All good (need to pick)

When all markers are well reconstructing and there are no significant occlusions, you can just simply Reconstruct and Auto-label the Take to obtain 3D data and label all of the skeleton and rigid body markers. If reconstructed and auto-labeled 3D data is acceptable, you can proceed without post-processing.

  1. Reconstruct and Auto-label works perfectly the first time without additional post-processing.
  2. Examine the Take(s). Check the Labeling pane, or the tracks view, to make sure no occlusion exists within the capture, and all markers are consistently labeled.
  3. Done.


Sample Scenario 2 :: Labeling errors in the middle of a Take

When skeleton markers are mislabeled only within a specific frame range of the Take, you will have to manually re-label the markers during that range. 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 auto-label the take again to assign remaining missing labels.

  1. Reconstruct and auto-label the Take.
  2. Inspect the Take to pick out the frame ranges with bad tracking.
  3. If necessary, unlabel the bad frame range or the entire Take.
  4. Scrub the timeline to a frame just before the bad tracking frame range.
  5. Using the Labeling pane, manually label the skeleton. Depending on severity of the mislabels, you can either label the entire skeleton or just the key segments starting from the hip.
  6. Scrub the timeline to a frame after the bad tracking frame range.
  7. Manually label the same skeleton.
  8. Auto-label the Take (Motive 1.10 and above).
  9. Check the frames again and correct any remaining mislabels using the Labeling pane.


Sample Scenario 3 :: Mislabeling/unlabeling of a marker due to occlusions

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.

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 Reconstruction pane 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.

  1. Reconstruct and auto-label the Take
  2. Examine through the Take, and go to a frame where markers are mislabeled right after an occlusion.
  3. In the Labeling pane, disable the Increment Label Selection Label Increment.png option, and select a marker set and a label that is frequently occluded.
  4. In the Labeling pane, disable the Apply Labels to Previous Frames Label ApplyBefore.png option, and leave only the Apply Labels to Upcoming Frames Label ApplyAfter.png option enabled.
  5. Using the Quick Label Mode, correct the labeling errors.
  6. Move onto next occluded frames. When the marker reappears, correct the labels.
  7. After correcting the labels, Auto-label the Take again.
  8. Use the Fill Gaps tool in the Editing tools to interpolate the occluded trajectories.


Sample Scenario 4 :: Skeletons never acquire perfectly throughout a Take

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.

  1. Reconstruct the Take.
  2. At a certain point of the Take (usually at a frame where you can best identify the pose of the skeleton), use the Labeling pane to manually assign the marker labels for skeletons that are not labeling correctly. Depending on severity of the mislabels, you can either label the entire skeleton or only the key segments starting from the hip.
  3. After manually assigning the labels, auto-label the Take. Make sure the corresponding assets are enabled in the Project pane.
  4. 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.