libinput-analyze-per-slot-delta(1) General Commands Manual libinput-analyze-per-slot-delta(1)

# [NAME](#NAME)

libinput-analyze-per-slot-delta - analyze the per-event delta movement for touch slots

# [SYNOPSIS](#SYNOPSIS)

**libinput analyze per-slot-delta \[--help] \[options] *recording.yml***

# [DESCRIPTION](#DESCRIPTION)

The **libinput analyze per-slot-delta** tool analyzes a recording made with **libinput record** and prints the delta movement per touch slot.

This is a debugging tool only, its output may change at any time. Do not rely on the output.

# [OPTIONS](#OPTIONS)

[**--help**](#help)

Print help

[**--ignore-below=<units or mm>**](#ignore-below=_units)

Ignore any movement below the given threshold. The threshold is in mm if **--use-mm** is selected or in device units otherwise.

[**--show-distance**](#show-distance)

Also show the distance relative to the initial position of the current touch. The distance is mm if **--use-mm** is selected or in device units otherwise.

[**--threshold=<units or mm>**](#threshold=_units)

Color any movement above this threshold in red. The threshold is in mm if **--use-mm** is selected or in device units otherwise.

[**--use-mm**](#use-mm)

Print data in mm instead of device units

[**--use-st**](#use-st)

Use the single-touch ABS\_X/ABS\_Y instead of the multitouch axes

[**--use-absolute**](#use-absolute)

Print absolute coordinates, not deltas

# [OUTPUT](#OUTPUT)

An example output for a single finger touch on a touchpad supporting two slots is below. This output is with the use of the **--use-mm** flag.

```


 0.000000   +0ms TOU:     ++++++     |  ************* |


 0.021900  +21ms TOU: →↘ +1.10/+0.14 |  ************* |


 0.033468  +11ms TOU: →↘ +1.15/+0.19 |  ************* |


 0.043856  +10ms TOU: →↘ +1.76/+0.22 |  ************* |


 0.053237   +9ms TOU: →↘ +2.20/+0.19 |  ************* |
```

The entry **++++++** indicates a finger has been put down, **------** indicates the finger has lifted. The left-most column is the absolute timestamp in seconds.microseconds followed by the relative time of the event to the previous event.

The word **TOU** in this example represents BTN\_TOUCH, similar abbreviations exist for BTN\_TOOL\_DOUBLETAP, BTN\_TOOL\_TRIPLETAP, BTN\_TOOL\_QUADTAP, and BTN\_TOOL\_QUINTTAP.

The arrows indicate the approximate direction on a 16-point compass, in this example EastSouthEast.

Each multitouch slot supported by the hardware has one column, where the column shows asterisk **\*\*\*\*\*\*\*\*** no finger is down for that slot. Where the column shows spaces only, a finger is down but no data is currently available.

In the above example, the third events occurs ~33ms into the recording, is 11ms after the previous event and has an east south-east direction. The movement for this event was x: 1.15 and y: 0.19 mm. A second finger is not currently down.

# [LIBINPUT](#LIBINPUT)

Part of the [**libinput(1)**](/man/os/libinput/libinput.1) suite

---

Document: libinput-analyze-per-slot-delta(1) from libinput 1.32.0-r2 (Chainguard OS)
Source: https://gitlab.freedesktop.org/libinput/libinput