Marker labels in Labels pane.
menu to show marker labels for selected markers.
* [**Labels pane**](https://docs.optitrack.com/motive-ui-panes/labels-pane): The Labels pane lists all the marker labels and corresponding percentage gap for each label. The label will turn magenta in the list if it is missing at the current frame.
* [**Graph View pane**](https://docs.optitrack.com/motive-ui-panes/graph-view-pane): The timeline scrubber highlights in red any frames where the selected label is not assigned to a marker. The *Tracks* view provides a list of labels and their continuity in a captured *Take*.
 
## Labeling Methods
There are two approaches to labeling markers in Motive:
* **Auto-label pipeline:** Automatically label sets of Rigid Body, Skeleton, or Trained Markerset markers using calibrated asset definitions. Motive uses the unique marker placement stored in the Asset definition to identify an asset and applies its associated marker labels automatically. This occurs both in real-time and post-processing.
{% hint style="info" %}
Auto-labeling applies only to assets enabled with a checkmark 
in the [Assets pane](https://docs.optitrack.com/motive-ui-panes/assets-pane).
{% endhint %}
* **Manual Label:** Manually label individual markers using the [Labels pane](https://docs.optitrack.com/motive-ui-panes/labels-pane). Use this workflow to give Rigid Bodies and Trained Markersets more meaningful labels.
 
### Auto-label
As noted above, Motive stores information about Rigid Bodies, Skeletons, and Trained Markersets in asset definitions, which are recorded when the assets are created. Motive's auto-labeler uses asset definitions to label a set of reconstructed 3D trajectories that resemble the 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 are saved in the recorded *TAKES*. Running the auto-labeler again in post-processing will label the Rigid Body and Skeleton markers again from the 3D data.
### Auto-labeling Steps
#### **From the Data pane**
1. Select the *Take(s)* from the [Data pane](https://docs.optitrack.com/motive-ui-panes/data-pane).
2. Right-click to open the context menu.
3. Click *reconstruct and auto-label* to process the selected *Takes*. This pipeline creates a new set of 3D data and auto-labels the markers that match the corresponding asset definitions.
{% hint style="danger" %}
Be careful when reconstructing a *Take* again either by **Reconstruct** or **Reconstruct and Auto-label.** These processes overwrite the 3D data, discarding any post-processing edits on trajectories and marker labels.
Recorded Skeleton marker labels, which were intact during the live capture, may be discarded, and the reconstructed markers may not be auto-labeled correctly again if the Skeletons are never in well-trackable poses during the captured *Take*. This is another reason to always start a capture with a good [calibration pose](https://docs.optitrack.com/skeleton-tracking#calibration-pose) (e.g., a T-pose).
{% endhint %}
### Rename Labels
Label names can be changed through the [Constraints Pane](https://docs.optitrack.com/motive-ui-panes/constraints-pane) or the [Labels Pane](https://docs.optitrack.com/motive-ui-panes/labels-pane).
* The [Constraints pane](https://docs.optitrack.com/motive-ui-panes/constraints-pane) displays marker labels for either the selected asset or all assets in the *Take*. Markers that are not part of an asset are not included.
* The Labels pane displays marker labels for either the selected asset or all markers in the *Take*.
Marker labels in Labels pane.
button in the Constraints pane to unlock the asset selection drop-down.
Asset Selection unlocked in the Constraints Pane.
button in the upper right corner of the pane and select any layout option other than *Labeled only*.
* Labels are color-coded to note the label's status in the current frame of 3D data. Assigned marker labels are shown in white, while labels without reconstructions and unlabeled reconstructions that are not in the current frame are shown in magenta.
Please see the [Labels pane](https://docs.optitrack.com/motive-ui-panes/labels-pane) page for a detailed explanation of each option.
{% hint style="info" %}
The **Tracks View** under the [Graph View pane](https://docs.optitrack.com/motive-ui-panes/graph-view-pane) can be used in conjunction with the Labels pane to quickly locate gaps in a trajectory to see which markers and gaps are associated.
{% endhint %}
### Quick Label Mode
The **Quick Label** mode allows you to tag labels with single-clicks in the 3D Viewport and is a handy way to reassign or modify marker labels throughout the capture.
 
### Quick Label Mode Steps
1. Select the asset to label, either from the Assets Pane, the 3D Viewport, or from the asset selection drop-down list in the Labels pane.
2. This will display all of the asset's markers and their corresponding percentage gap.
3. Click the 
button and select any option other than *Labeled Only* to see unlabeled markers.
4. Select the **Label Range**:
* **All or Selected:** Assign labels to a selected marker for all, or selected, frames in a capture.
* **Spike or Fragment:** Apply labels to a marker within the frame range bounded by trajectory gaps and spikes (erratic change).
* **Swap Spike or Fragment:** Apply labels only to spikes created by labeling swaps.
5. Inspect the behavior of the selected trajectory then use the **Apply Labels** drop-down list in the Labels pane Settings to apply the selected label to frames forward or frames backward or both. Click 
to display settings, if necessary.
6. Click the Mouse Actions button 
to switch to Quick Label Mode (Or use Hotkey: D). The cursor will change to a finger icon.
Mouse Actions menu.
Quick Label Mode in the 3D Viewport.
options in the [perspective view](https://docs.optitrack.com/motive-ui-panes/viewport#perspective-view) to have a better view on the markers when assigning marker labels.
* Toggle **Skeleton selectability** under the Selection Options 
in the [perspective view](https://docs.optitrack.com/motive-ui-panes/viewport#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](https://docs.optitrack.com/motive-ui-panes/viewport#perspective-view) options for intuitive identification of labeled markers as you tag through Skeleton markers.
* Enable the **Quality Visual** setting in the skeleton properties to graphically see:
* When there are no markers contributing to a bone. The bone will appear red.
* When a Degree of Freedom limit is reached. The bone will appear blue.
## Labeling Workflows
The labeling workflow is flexible and alternative approaches to the steps in this section can also be used.
{% hint style="info" %}
**General Labeling Tips**
* Use the [Graph View pane](https://docs.optitrack.com/motive-ui-panes/graph-view-pane) to monitor occlusion gaps and labeling errors during post-processing.
* [Motive Hotkeys](https://docs.optitrack.com/motive/motive-hotkeys) can increase the speed of the workflow. Use **Z and Shift+Z hotkeys** to quickly find gaps in the selected trajectory.
* Set the Visual Aids for Markers in the perspective view to *Hide for Disabled Assets* then uncheck the 
box to the left of the asset name in the Assets pane when you are done labeling it to better focus on the remaining unlabeled assets.
{% endhint %}
### Using Combined Reconstruction and Auto-label Pipeline
**Step 1.** In the [Data pane](https://docs.optitrack.com/motive-ui-panes/data-pane), **Reconstruct and auto-label** the take with all of the desired assets enabled.
**Step 2.** In the [Graph View pane](https://docs.optitrack.com/motive-ui-panes/graph-view-pane), examine the trajectories and navigate to the frame where labeling errors are frequent.
**Step 3.** Open the [Labels pane](https://docs.optitrack.com/motive-ui-panes/labels-pane).
**Step 4.** Select an asset that you wish to label.
**Step 5.** From the label columns, click on the 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 8.** In the [Perspective View](https://docs.optitrack.com/motive-ui-panes/viewport#perspective-view), assign the labels to the corresponding marker reconstructions by clicking on them.
**Step 9.** When all markers have been labeled, switch back to the Select Mode.
### Using Standalone Reconstruction Pipeline and Auto-label Pipeline Separately
**Step 1.** Start with 2D data of a captured *Take* with model assets (Skeletons, Rigid Bodies, or Trained Markersets).
**Step 2.** **Reconstruct and Auto-Label**, or just **Reconstruct**, the *Take* with all of the desired assets enabled under the [Assets pane](https://docs.optitrack.com/motive-ui-panes/assets-pane). If you use reconstruct only, you can skip step 3 and 5 for the first iteration.
**Step 3.** Examine the reconstructed 3D data and inspect the frame range where markers are mislabeled.
**Step 4.** Using the [Labels pane](https://docs.optitrack.com/motive-ui-panes/labels-pane), manually fix/assign marker labels, paying attention to the label settings (direction, max gap, max spike, selected duration).
**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 steps 3-6 until complete.
### Labeling Error Fix
The general process for resolving labeling error is:
1. Identify the trajectory with the labeling error.
2. Determine if the error is a swap, an occlusion, or unlabeled.
3. Resolve the error with the correct tool.
* Swap: Use the Swap Fix tool (Edit Tools) or just re-assign each label (Labels pane).
* 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).
For more data editing options, read through the [Data Editing](https://docs.optitrack.com/motive/data-editing) page.
