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

Selects a portion of a hierarchy.

The selectBranch command selects the members of a hierarchical branch. The command continues to select children down or up a branch hierarchy until it reaches the end or beginning of a chain, or a new branching.

## Functional area

Selection

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `selectBranch node1 node2 ....[-a] [-r] [-u]` |

### Arguments

| Name | Type | Required | Comments |
| --- | --- | --- | --- |
| `node(s)` | string | yes | String name of node(s) to operate on. |

### Flags

> Macro (scroll-tablelayout)

| Name | Flag arguments | Argument type | Exclusive to | Comments |
| --- | --- | --- | --- | --- |
| `a` | 0 | — | r | Adds to the current selection in the scene |
| `r` | 0 | — | a | Removes from the current selection in the scene |
| `u` | 0 | — | — | Selects all modules up the chain until it runs into a new branch |

## Return value

void 

> Macro (scroll-pagebreak)

## Examples

```plaintext
// This command adds all members of the left arm chain below 
// and including the lclavicle to the current selection.
// The same applies to the left thigh and below.
selectBranch -a lclavicle lfemur;
```

# 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)
- [selectByMarkerRadius](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736563)
- [selectByName](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253739192)
- [selectByPart](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736482)
- [selectBySide](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738001)
- [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)