latency-histogram1
Plot a histogram of machine latency
Usage
latency-histogram [{-? | --help}]
[--base
ns]
[--servo
ns]
[--bbinsize
ns]
[--sbinsize
ns]
[--bbins
ns]
[--sbins
ns]
[{--logscale
0 | 1}]
[--text
note]
[--show]
[--nobase]
[--verbose]
[--nox]
Overview
The latency test is important when configuring a LinuxCNC system. An adjunct to the standard latency-test latency-histogram plots the distribution of latency. This can be useful to get a feel for how frequent the high latency excursions are.
LinuxCNC and HAL should not be running, stop with halrun -U. Large number of bins and/or small binsizes will slow updates. For single thread, specify --nobase (and options for servo thread). Measured latencies outside of the +/- bin range are reported with special end bars. Use --show to show count for the off-chart [pos|neg] pin.
More details: https://linuxcnc.org/docs/html/install/latency-test.html
Options
-
-?, --help -
Show options and exit.
|
base thread interval, default: 25000, min: 5000 |
|---|---|
|
servo thread interval, default: 1000000, min: 25000 |
|
base bin size, default: 100 |
|
servo bin size, default: 100 |
|
base bins, default: 200 |
|
servo bins, default: 200 |
|
y axis log scale, default: 1 |
|
additional note, default: "" |
-
--show -
show count of undisplayed bins
-
--nobase -
servo thread only
-
--verbose -
progress and debug
-
--nox -
no GUI, display elapsed, min, max, sdev for each thread
Releases
Unchanged in 2 releases since Debian 12 (Bookworm).