---
title: "selectByPart"
canonical: "https://help.vicon.com/space/Shogun110/13075863/selectByPart"
format: markdown
---
# Description

Selects bone modules in the scene by their Part_Name attribute.

The Part_Name attribute on bone modules is used for retargeting operations, which relies on body part naming.

## Functional area

Selection

# Command syntax

## Syntax

|  |
| --- |
| `selectByPart partName1 partName2...[-a] [-r] [-childOf string] [-side string]` |

### Arguments

> Macro (scroll-tablelayout)

| **Name** | **Type** | **Required** | **Comments** |
| --- | --- | --- | --- |
| `partName(s)` | string | yes | The part name(s) to select by. Must be one of the names in the bone module Part_Name attribute. |

### Flags

> Macro (scroll-tablelayout)

| **Name** | **Flag arguments** | **Argument type** | **Exclusive to** | **Comments** |
| --- | --- | --- | --- | --- |
| `a` | 0 | — | r | Selection adds to the current scene selection. The default is to replace the scene selection. |
| `r` | 0 | — | a | Selection removes from the current scene selection. The default is to replace the scene selection. |
| > Macro (scroll-pagebreak)<br>`childOf` | 1 | string | — | Only selects modules that are children of this module name. |
| `side` | 1 | string | — | Only selects modules that have the side attribute set to this. |

## Return value

void

## Examples

```plaintext
// Select all bone modules with the "Collar" part name. 
selectByPart "Collar";
```

# Additional information

## Related commands

- [select](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075851)
- [selectabilityOn](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075853)
- [selectBranch](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075855)
- [selectByName](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075859)
- [selectBySide](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075865)
- [selectByType](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075867)
- [selectChildren](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075869)
- [selectParent](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075885)
- [selectSet](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075893)
- [selectTree](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075901)
- [setPrimary](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13076005)