TurboPlot is a blazingly fast waveform renderer made for visualizing huge traces.
Traces are displayed using a density rendering algorithm distributed across GPU and CPU threads, enabling very smooth navigation even with traces as big as 1 Giga samples! The density rendering allows analyzing traces easily on a large scale, while also preserving single-sample peaks visible.
When the sampling rate is configured, time intervals can be measured easily. The interval selection tools can also help in counting repetitive patterns in traces.
You can download the latest pre-built binaries for Linux, Windows, and macOS from the Releases page.
Rust shall be installed on your system (see instructions for installation). TurboPlot can be directly installed by cargo:
cargo install turboplot
turboplot waveform.npy
Alternatively, you can build and run by cloning this repository and execute:
cargo run --release -- waveform.npy
- NumPy (
.npy): 1D arrays (single trace) and 2D arrays (one trace per row). - Tektronix WFM (
.wfm): versions 1, 2 and 3, including FastFrame files (one trace per frame). - CSV (
.csv): single-column or multi-column files.
The format is guessed from the file extension. It can be forced with --format.
When loading a CSV file, --skip-lines shall be specified to skip header lines, and --column can indicate which data column must be parsed and rendered. Column indexing starts at 0.
turboplot --format csv --skip-lines 10 --column 2 waveform.csv
Files that contain multiple traces (2D NumPy arrays, FastFrame WFM files) load all traces by default. You can select a subset with --frames:
turboplot --frames 0-3,7,10-12 capture.wfm
The format accepts comma-separated indices and ranges (e.g. 1-3,6,7-8,12).
Multiple traces can be opened in horizontal split-screen, with their views optionally synchronized. This can be useful for comparing two traces:
turboplot waveform1.npy waveform2.npy
Traces can be filtered with basic filters when they are loaded. Low-pass, high-pass, band-pass and notch filters are possible. This requires specifying the sampling rate (in MHz) and the cutoff frequency (in kHz).
cargo run --release -- -s 100 --filter low-pass --cutoff-freq 1000 waveform.npy
By default TurboPlot will spawn 1 GPU rendering thread and the maximum CPU rendering threads the hardware can run simultaneously. To fit your needs, this can be changed by specifying the number of threads for each type of rendering backend:
# Disable use of GPU rendering backend, use only 1 CPU rendering thread.
turboplot --gpu 0 --cpu 1 waveform.npy
Note: In this mode, the user interface may still use the GPU; The trace rendering will be performed only on the CPU.
Controls:
- Horizontal panning is performed using left or right mouse buttons.
- Vertical offset can be modified using Alt + left or right mouse drag.
- Horizontal zoom is performed using mouse wheel.
- Vertical zoom is performed using Alt + mouse wheel.
- UI can be scaled up using Ctrl + =.
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.