# Constraints Pane

## **Overview**

The reconstructed 3D markers that comprise an asset are known as constraints in Motive. The Constraints pane provides information and tools for working with solver constraints for all asset types:  [Rigid Bodies](https://docs.optitrack.com/v3.1/motive/rigid-body-tracking), [Skeletons](https://docs.optitrack.com/v3.1/motive/skeleton-tracking), and [Trained Markersets](https://docs.optitrack.com/v3.1/motive/trained-markersets).&#x20;

To open, click the <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FH0AOj22dd075OExMaBAp%2FConstraints%20Pane%20button.png?alt=media&#x26;token=9fccab00-2915-4b5c-9a05-a9b63bad9a1c" alt="" data-size="line"> button on the Motive toolbar.

<figure><img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2Fr9CN0G33Tj2GSHsu83HT%2FConstraints%20Pane%20-%20All%20assets.png?alt=media&#x26;token=072b5bb8-3987-4986-8901-06b7e5f41406" alt="" width="309"><figcaption><p>The Constraints pane. </p></figcaption></figure>

## Asset Selection

By default, the Constraints pane will display the constraints for the asset(s) selected in either the [3D Viewport](https://docs.optitrack.com/v3.1/motive-ui-panes/viewport) or the [Assets Pane](https://docs.optitrack.com/v3.1/motive-ui-panes/assets-pane). If none is selected, the pane will display the constraints for *-All-* the assets in the Live volume or in the *TAKE*, when in edit mode.&#x20;

The pane is locked to the selection whenever the <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FtpkzymNMTh5v0CrlV4E4%2FLink%20to%203D%20selection%20button.png?alt=media&#x26;token=5a73f657-9ffb-4487-88a0-4af9c4fde305" alt="" data-size="line"> button is active. Click the button to open the menu to select a different asset.&#x20;

<figure><img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FFdYvaze70Rn52VsBex1q%2FConstraints%20Pane%20-%20unlock%20asset%20selection.png?alt=media&#x26;token=83856a9c-790a-41e7-9155-5b1a32de392b" alt="" width="308"><figcaption><p>Selecting an Asset from the Constraints Pane.</p></figcaption></figure>

## Customize Pane Columns

The default view of the Constraints pane includes the Constraint (or label), Type, and Color. Right click the column header to add or remove columns from the view.

<figure><img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FRr57rRncjBgE1gXIIkqc%2FConstraints%20-%20Customize%20columns.png?alt=media&#x26;token=fdff4ad0-3f6f-46f3-b84f-def8cc244b09" alt="" width="308"><figcaption><p>Select columns to display.</p></figcaption></figure>

#### **Constraint**

The Constraint column displays the marker labels associated with an asset. When the Asset selection is set to *-All-*, the asset name is included as a prefix to the marker label.

{% hint style="info" %}

* Skeleton templates include pre-defined labels that correspond to the marker's location and easily import into other pipelines for biomechanical analysis or animation.&#x20;
* Rigid Bodies and Trained Markersets are auto-labeled with generic, sequential labels.
  {% endhint %}

#### MemberID

The MemberID column displays the unique ID value assigned to each constraint. Typically, this is the original order of the constraints.

#### Type

There are four types of constraints:

* **Marker:**  The constraint is associated with either a passive or active marker. Designated with the <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FrBjzMU6qBJ6KLF6oZYR6%2FConstraints%20Pane%20-%20Marker%20Type.png?alt=media&#x26;token=c7440fbc-a660-4e44-ba45-74ff6aa8b815" alt="" data-size="line"> icon in the *Type* column.
* **Calibration Marker:**  Some biomechanical skeleton templates use calibration markers during asset creation that are subsequently removed prior to motion capture. In the 3D viewport, the constraints for these markers appear in red. Designated with the <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FrBjzMU6qBJ6KLF6oZYR6%2FConstraints%20Pane%20-%20Marker%20Type.png?alt=media&#x26;token=c7440fbc-a660-4e44-ba45-74ff6aa8b815" alt="" data-size="line"> icon in the *Type* column.
* **6 DoF:**  The constraint formed by a Rigid Body on a skeleton created using a Rigid Body Skeleton template. Designated with the <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FNSoQ3535AFqYJY78gmBN%2FConstraints%20Pane%20-%206%20DoF%20Type.png?alt=media&#x26;token=24b155d8-e54f-4a5d-b9c8-e2e41d48f8a7" alt="" data-size="line"> icon in the *Type* column.
* **IMU:**  The constraint associated with a [sensor-fused IMU](https://docs.optitrack.com/v3.1/motive/imu-sensor-fusion) in a rigid body. Designated with the <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FngT41alzjX8wpx832V3X%2FConstraints%20Pane%20-%20IMU%20Type.png?alt=media&#x26;token=50c444ee-ba6e-4539-a975-1247a9c3bb46" alt="" data-size="line"> icon in the *Type* column.

#### Color

The color column displays the color assigned to the constraint. The option with a <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FAc7J9xJb0D4dKZkzH2rD%2FColor%20linked%20to%20Asset.png?alt=media&#x26;token=137e4271-b310-46a3-93be-d6a442230bf6" alt="" data-size="line"> rainbow effect links the constraint to the color defined by the asset.

#### ActiveID

The *ActiveID* column allows you to view and modify Active Marker ID values. Active ID values are automatically assigned during asset creation or when adding a marker, but this gives you a higher level of insight and control over the process.

#### Weight

Weight is the degree to which an individual constraint influences the 3D solve of an asset. Specifically, adjusting the weight tells the solver to prefer that marker when solving the asset data with less than an optimal amount of marker information. For example, the hands are weighted slightly higher for the baseline and core skeleton Marker Sets to preference the end effectors.&#x20;

Editing this property is not typically recommended.

## Modify Constraints

{% hint style="info" %}
To see constraints as well as markers in the 3D Viewport, click the Visual Aids <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2F3mN8rjpN2rVFUMEmsXMT%2FMotive%20Visual%20Options%20button.png?alt=media&#x26;token=49860aec-6f60-433e-88df-1dfcf025e817" alt="" data-size="line"> button and select *Marker Constraints* *-> Show All*.&#x20;
{% endhint %}

### Add or Remove Constraints

Select the marker(s) to add to or remove from the asset definition in the 3D Viewport then click either the Add <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FDhoO7RQGZmphUQljNhEk%2FAdd%20Button%20-%20Active.png?alt=media&#x26;token=78651bce-4b34-4e7d-a0ed-24de318c64a7" alt="" data-size="line"> button or the Remove <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FqPOnGCJDY35acGZWDcBP%2FRemove%20button%20-%20active.png?alt=media&#x26;token=59ff9e6e-dfb7-4fa1-aae5-8f3b4d63ce77" alt="" data-size="line"> button at the bottom of the pane.

<figure><img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FV2FgH6gNds927N3LUv3W%2FConstraints%20-%20Add%20or%20remove.png?alt=media&#x26;token=00a0de1b-86fc-4597-ba8e-f1e09e441a72" alt=""><figcaption><p>Click to Add selected markers.</p></figcaption></figure>

### Rename Constraints

To give a marker constraint a more meaningful name than the one auto-assigned when the asset is created, right-click the constraint name and select *Rename* from the context menu. Alternately, click twice on the constraint name to open the field for editing.

{% hint style="info" %}
We recommend using the single asset view rather than *-All-* when relabeling markers from the Constraints pane.
{% endhint %}

You can also import a list of constraint properties, including names, for all asset types. See the section [Export/Import Constraints](#export-import-constraints), below and the page [Constraints XML Files](https://docs.optitrack.com/v3.1/motive-ui-panes/constraints-pane/constraints-xml-files) for more details.

#### Trained Markerset Copy and Paste

Import label names for Trained Markerset assets with a quick copy and paste of text. This is useful if you've already mapped out the asset, either during the design phase or while placing the markers.&#x20;

1. Copy the desired labels to the clipboard.
2. Select the Markerset so the Constraints pane displays only its marker constraints. Alternately,  click the <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FOkExfNjYjDWF9jKfm9V5%2FLink%20to%203D%20selection%20button.png?alt=media&#x26;token=cf84e8a5-09da-4848-b23b-b6f99e744b03" alt="" data-size="line"> button to deselect *Lock Selection to Asset*, and select the Markerset from the dropdown list.&#x20;
3. Left click the Constraints Pane.
4. Use *Ctrl + V* to paste the label names to the pane.&#x20;

<figure><img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FgpPg70KaTli1CHDE7npi%2FConstraints%20Pane%20-%20Imported%20labels%20for%20TM.png?alt=media&#x26;token=dd9aeece-bf2e-422e-a5f9-8ab715862cce" alt=""><figcaption><p>Constraints Pane with new label names pasted in.</p></figcaption></figure>

The pasted labels will display at the bottom of the list. Click the <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FcfXxNYYn0qrtc3hQ6IrO%2FSelect%20or%20Edit%203D%20Object.png?alt=media&#x26;token=ebf4ae93-f652-41e8-9983-6e95ca6ace89" alt="" data-size="line"> Mouse Control button in the 3D Viewport or use the *D hotkey* to open the [Quick Label](https://docs.optitrack.com/v3.1/motive/labeling#quick-label-mode) tool to quickly assign the copied labels to the correct markers.&#x20;

Please see the [Labeling](https://docs.optitrack.com/v3.1/motive/labeling) page for more information on using the Quick Labels tool.

### Sort and Reorder Constraints

By default, the *Constraints* column sorts by the asset definition, or the order in which the markers were selected when the asset was created. Click the column header to sort the column alphabetically in ascending or descending order, then click again to return to the default.&#x20;

<figure><img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2F0UFzRlSi4Brt9pmkCieY%2FConstraints%20Pane%20-%20context%20menu.png?alt=media&#x26;token=ad87fe7a-1b09-499b-824f-5f6d3f4f1438" alt="" width="312"><figcaption><p>Right-click Context menu.</p></figcaption></figure>

There are two methods to change the order of the constraints in the internal asset definition:

* Right-click a constraint label and select an option to move up or down from its present location.
* Drag and drop labels into the desired order.

Reordering constraints helps to define custom marker sequences for manual labeling. Changes made to the order will also be reflected in the [Labels pane](https://docs.optitrack.com/v3.1/motive-ui-panes/labels-pane).&#x20;

### Change Marker Color

By default, constraints use the color selected in the asset properties, as indicated by the rainbow <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FtEuNrTj3vgeQzodzZeAW%2FColor%20linked%20to%20Asset.png?alt=media&#x26;token=67a0c642-7a95-48fb-9db3-5b3b9c3bba8f" alt="" data-size="line"> color icon.&#x20;

<div><img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FlT6uFcdhBQfs1Egd4aai%2FConstraints%20-%20RB%20with%20Asset%20color.png?alt=media&#x26;token=edad540f-3eb2-4aea-acee-46ededaed43e" alt="Rigid body with all constraints set to use the default asset color." width="563"> <figure><img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FFsGHpzf8SLDN2FIZTvHk%2FConstraints%20-%20RB%20with%20custom%20colors.png?alt=media&#x26;token=4e35303b-f37b-4bbb-9a27-12ecfd903e54" alt="" width="563"><figcaption><p>Rigid Body with custom colors assigned to four markers.</p></figcaption></figure></div>

## Modify Constraints from the Properties Pane

You can modify the following additional constraint settings from the [Properties pane](https://docs.optitrack.com/v3.1/motive-ui-panes/properties-pane) when a constraint is selected in the Constraints pane.

* Position and Rotation:  adjust the x/y/z coordinates of the constraint, in respect to the local coordinate system of the corresponding asset or bone.

{% hint style="warning" %}
Before making any changes to the x/y/z coordinates, save the current values by clicking the <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2Feo6OwSKQouSoL61VYKXX%2FMotive%20Context%20Menu.png?alt=media&#x26;token=391f5cae-b141-4623-a98a-ae16de820e84" alt="" data-size="line"> button to the right of the fields. Select *Set as default.* This will change the reset value from the Motive global default to the specific coordinates for the constraints.&#x20;
{% endhint %}

<div><figure><img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FXvIHNF24AKZtQn1PEAnw%2FConstraint%20Properties%20-%20Set%20Default%20position.png?alt=media&#x26;token=44dc4758-9a7d-4c2f-8c65-ede4dc7ccdb8" alt=""><figcaption><p>Reset Position to Motive global default.</p></figcaption></figure> <figure><img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2FGeP3axhgGFZXSIvVYLTD%2FConstraint%20Properties%20-%20new%20Default%20position.png?alt=media&#x26;token=31af48b3-b663-47c3-b90a-2767a8bbdd56" alt=""><figcaption><p>Reset Position after saving position coordinates.</p></figcaption></figure></div>

* Marker Diameter:  view or change the diameter of an individual marker.
* Constraint Type:  Motive assigns the constraint type during the auto-label process. The user should not need to adjust this property.

![Constraint Properties.](https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2F55jCU0LgKrSSbMnydyeN%2FProperties%20-%20constraint.png?alt=media\&token=b5dc3311-4265-473a-8158-95232bf96aa3)

## Export/Import Constraints

You can also export configured constraints, or import them, using the Constraints pane. To do this, simply click on the <img src="https://2867085706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuHClgoIWDmmoXSr2eD9q%2Fuploads%2Fg33QeSQDoc80UuZsDUsd%2Fimage.png?alt=media&#x26;token=7851432f-7e06-4c71-b188-6658d4a04964" alt="" data-size="line"> context menu. There are options to export, import, and generate constraints.

Exporting constraints makes an XML file containing the names, colors, marker stick definitions, and weights for manual editing. Importing reads the (.xml) files made when exporting. Generating constraints resets the asset back to the default state, if applicable.

Please see the page [Constraints XML Files](https://docs.optitrack.com/v3.1/motive-ui-panes/constraints-pane/constraints-xml-files) for more information on working with these files.

![](https://content.gitbook.com/content/uHClgoIWDmmoXSr2eD9q/blobs/fgs3o5w6NvL0VQxLZotu/image.png)
