TouCAN-Plot

An interactive PySide6 + Matplotlib plotting tool for CSV, SMV, and CAN bus log files.

Features

Supported File Formats

• Auto-detects Time / timestamp columns as the default X axis
• CAN signals are forward-fill interpolated and named as Message.Signal

Plot Interaction

• Shared X axis across all subplots with linked panning and zooming
• Secondary Y axis support per series
• Double-click a subplot to edit its series, or right-click for a context menu
• Measure cursors — two draggable vertical cursors with a live delta table
• Expression evaluator — create computed series from math expressions (e.g. sin("series_A") + "series_B" * 2)
• Multi-file merge — overlay series from different files, each in its own tab
• X axis switching — reassign the X column without losing subplot configuration
• Per-series properties (label, color, linewidth, linestyle, marker) persisted across all redraws
• Live mouse coordinates in the status bar

Toolbar

Menus

• File → Open (Ctrl+O) — open one or more files (multi-select)
• File → Merge (Ctrl+M) — append files to the current session
• Style → Customize plot style — preset, line mode, marker, text size, grid, legend
• Style → Theme — Dark / Light (icons swap automatically)

Right-Click Context Menu

• Add subplot above / below
• Delete subplot
• Legend: show/hide, position (14 options), orientation, text size
• Line style: plot / step

Style Presets

Four built-in presets: Default, Style 1, IEEE, Other.

Installation

From PyPI (recommended)

Install the released package from PyPI:

pip install toucan-plot

Usage

# Open a CSV file
toucan-plot data.csv

# Open an MF4 measurement file
toucan-plot recording.mf4

# Open a CAN log with DBC decoding
toucan-plot recording.blf signals.dbc

# Open multiple files (merge mode)
toucan-plot file1.csv file2.csv

# Launch without files
toucan-plot

Requirements

• Python ≥ 3.13
• PySide6
• Matplotlib
• NumPy
• pyqtdarktheme
• SciencePlots
• python-can (for CAN log files)
• cantools (for DBC decoding)
• asammdf (for MF4 files)

License

MIT