---
title: "selectBySide"
canonical: "https://help.vicon.com/space/ShogunPost121/1253738001/selectBySide"
format: markdown
---
# Description

Selects bone modules in the scene by their Side attribute.

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

## Functional area

Selection

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `selectBySide sideName1 sideName2...[-a] [-r] [-childOf string]` |

### Arguments

> Macro (scroll-tablelayout)

| Name | Type | Required | Comments |
| --- | --- | --- | --- |
| `sideName(s)` | string | yes | The side(s) to select by. Must be one of the sides listed in the bone module Side 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. |
| `childOf` | 1 | string | — | Only selects modules that are children of this module name. |

## Return value

void

## Examples

```plaintext
// Select all bone modules with the "Right" side attribute.
selectBySide "Right";
```

# Additional information

## Related commands

- [select](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737508)
- [selectabilityOn](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737978)
- [selectBranch](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737247)
- [selectByName](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253739192)
- [selectByPart](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736482)
- [selectByType](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737710)
- [selectChildren](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738333)
- [selectParent](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737538)
- [selectSet](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737834)
- [selectTree](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736558)
- [setPrimary](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736466)