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

Selects impacts in data.

Effectively filtering the keypoints in noisy data to clean the data requires aggressive filter settings which alone would over-filter the desired quick changes in marker position acceleration during motions like foot stomps, clapping hands. etc. This command provides a way of avoiding over-filtering these ranges by finding the ranges of such “impacts” and filtering them with a lighter setting. It analyzes the marker position data curve and detects keys which appear to be such impact motion.

This command can be useful for cleaning markerless data.

## Functional area

Data Retrieval

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `selectImpacts scaleTolerance minSpeed[-ranges] [-remove] [-padding integer]  ` |

### Arguments

> Macro (scroll-tablelayout)

| Name | Type | Required | Comments |
| --- | --- | --- | --- |
| `scaleTolerance` |  | yes | Specifies the difference in motion speed to be considered similar vs abrupt motion |
| `minSpeed` |  | yes | Specifies a minimum marker speed to consider the motion to be non-stationary |

> Macro (scroll-pagebreak)

### Flags

> Macro (scroll-tablelayout)

| Name | Argument type | Comments |
| --- | --- | --- |
| `ranges` | — | selectImpacts 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 |
| `remove` |  | Causes the command to remove impact keys from the selection instead of adding them to the selection. |
| `padding` | integer | Takes a single integer argument which specifies the number of frames to add on each side of the selected keys |

## Return value

void

## Examples

```plaintext
// Select the keys at the points of impact.
selectImpacts 5 10
```