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

Selects cliffs in data, which can be particularly <span style="color: #172B4D">useful for cleaning markerless data</span>. 

This command analyzes a marker's translation curve and attempts to detect keys which are within 'cliffs'. (Markerless keypoint data often contains mislabels/swaps, which in the graph appear as 'cliffs'. These are large jumps in translation curve data which occurs at the start of a mislabel or swap followed by another cliff at the end of the mislabel or swap, with fairly continuous data in between. For example, Marker A has its data for 500 frames, then becomes labeled as B for 100 frames, then back to A for the rest of the take.)

This selection can then be used by calling scripts to unlabel or delete these incorrect keys as part of a cleaning script.

## Functional area

Data Retrieval

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `selectCliffs distanceTolerance accelerationTolerance[-ranges] ` |

### Arguments

> Macro (scroll-tablelayout)

| Name | Type | Required | Comments |
| --- | --- | --- | --- |
| `distanceTolerance` |  | yes | Distance data on cliff must be from position before cliff |
| `accelerationTolerance` |  | yes | Specifies the required frame-to-frame acceleration to consider a cliff start |

### Flags

> Macro (scroll-tablelayout)

| Name | Flag arguments | Argument type | Exclusive to | Comments |
| --- | --- | --- | --- | --- |
| `ranges` |  | — | — | selectCliffs by default operates on the entire play range. When this flag is present, it causes the command to operate on only the selected time ranges |

## Return value

void

## Examples

```plaintext
// Select specified cliff's keys.
selectCliffs 125 35;
```