---
title: "autoSetSideAndParts"
canonical: "https://help.vicon.com/space/Shogun19/13795799/autoSetSideAndParts"
format: markdown
---
# Description

Automatically assigns the appropriate side (left, right, or center) and part (for example, knee, head, etc) to each bone that has active DoFs. Note that:

- It operates on the current subject's retargeting setup.
- It sets sides and parts for bones that have 1 or more active DoFs.

For the command to run without errors, ensure the following:

- There is a current subject.
- The current subject has a retargeting setup.
- Map mode is enabled.
- The facing direction of the target skeleton is +- Y or Z.

You are warned if the sides and parts could not be set.

## Functional area

Data Manipulators

# Command syntax

## Syntax

|  |
| --- |
| `autoSetSideAndParts [-tolerance float]` |

### Arguments

None 

> Macro (scroll-pagebreak)

### Flags

> Macro (scroll-tablelayout)

| **Name** | **Flag arguments** | **Argument type** | **Comments** |
| --- | --- | --- | --- |
| `tolerance` |  | float | The tolerance (in mm) controls the distance from the root at which bones are not considered to be center and are assigned to the left or right side.  
If a skeleton's spine and neck aren't perfectly aligned with the root, you can set the tolerance to account for this.  
Default: 1 mm, range 0–∞ |

## Return value

void

## Examples

```plaintext
// Run autoSetSideAndParts with an increased tolerance because the skeleton has 
// a spine that is not well aligned with the root.
autoSetSideAndParts -tolerance 5.0;
```

# Additional information

## Related commands

- [autoCreateRetargetingConstraints](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13803898)
- [createSidesAndPartsScript](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13795894)