SciQLopPlots
A high-performance scientific plotting library built on C++20/Qt6 with Python bindings via Shiboken6 (PySide6). Designed for the SciQLop data analysis platform but usable standalone.
Features
- Async resampling — render millions of points smoothly; data is downsampled in background threads via NeoQCP pipelines
- Multiple plot types — time series (line graphs), spectrograms (color maps), 2D histograms, parametric curves, N-D projection curves, waterfall plots
- Interactive — pan, zoom, data-driven callbacks, vertical/horizontal/rectangular spans, tracers, straight lines, text, shapes, pixmaps
- Multi-plot panels — synchronized axes, aligned margins, drag-and-drop from product trees
- Reactive pipelines — connect plot properties with
>>to build live data flows - Export — PDF (vector), PNG, JPG, BMP for both individual plots and panels
- Busy indicator — visual feedback when data is loading or being processed
- Runtime inspector — tree model/view for inspecting and editing plot properties
- Cross-platform — Linux, macOS, Windows
Architecture
graph TD
subgraph Python["Python Layer"]
PY[SciQLopPlots package]
SB[Shiboken6 bindings]
end
subgraph Plots["Plot Hierarchy"]
PI[SciQLopPlotInterface<br/><i>QFrame</i>]
SP[SciQLopPlot]
TSP[SciQLopTimeSeriesPlot]
NDP[SciQLopNDProjectionPlot]
end
subgraph Plotables["Plotables"]
PTI[SciQLopPlottableInterface<br/><i>QObject</i>]
GI[SciQLopGraphInterface]
CMI[SciQLopColorMapInterface]
LG[SciQLopLineGraph]
SLG[SciQLopSingleLineGraph]
CRV[SciQLopCurve]
WF[SciQLopWaterfallGraph]
NDC[SciQLopNDProjectionCurves]
CMB[SciQLopColorMapBase]
CM[SciQLopColorMap]
H2D[SciQLopHistogram2D]
end
subgraph Items["Overlay Items"]
VS[VerticalSpan]
HS[HorizontalSpan]
RS[RectangularSpan]
TR[Tracer]
SL[StraightLine]
end
subgraph MultiPlot["Multi-Plot"]
PPI[SciQLopPlotPanelInterface]
MPP[SciQLopMultiPlotPanel]
AX[AxisSynchronizer]
VA[VPlotsAlign]
end
PY --> SB --> PI
PI --> SP
PI --> NDP
SP --> TSP
PTI --> GI
PTI --> CMI
GI --> LG
GI --> SLG
GI --> CRV
GI --> WF
GI --> NDC
CMI --> CMB
CMB --> CM
CMB --> H2D
PPI --> MPP
MPP --> AX
MPP --> VA
SP -.->|contains| PTI
SP -.->|contains| Items
MPP -.->|contains| SP
Data flow
sequenceDiagram
participant User
participant Plot as SciQLopPlot
participant Resampler as Resampler<br/>(worker thread)
participant NeoQCP as NeoQCP
User->>Plot: pan / zoom
Plot->>Resampler: new visible range
Resampler->>Resampler: downsample data
Resampler->>NeoQCP: resampled points
NeoQCP->>Plot: render
For callback-driven data, the plot invokes a Python callable with (start, stop) on range change, and the returned arrays flow through the same resampling pipeline.
Quick start
The user guide walks through everything below and more: plot types, live data, time series, panels, overlays, pipelines and export. Every example in it is tested.
pip install SciQLopPlots
import numpy as np
from PySide6.QtWidgets import QApplication
from SciQLopPlots import SciQLopPlot
app = QApplication([])
plot = SciQLopPlot()
# Static data
x = np.arange(0, 1000, dtype=np.float64)
y = np.sin(x / 100) * np.cos(x / 10)
plot.plot(x, y, labels=["signal"])
# Data callback (called on pan/zoom with visible range)
def get_data(start, stop):
x = np.arange(start, stop, dtype=np.float64)
y = np.column_stack([np.sin(x / 100), np.cos(x / 100)])
return x, y
plot.plot(get_data, labels=["sin", "cos"])
plot.show()
app.exec()
Reactive pipelines
Connect plot properties with the >> operator to build live data pipelines:
from SciQLopPlots import SciQLopPlot
plot = SciQLopPlot()
graph = plot.plot(lambda start, stop: ..., labels=["signal"])
# Axis range changes automatically feed a transform, which pushes data to the graph
plot.x_axis().on.range >> get_data >> graph.on.data
# Direct property forwarding (no transform)
span.on.range >> plot.x_axis().on.range
# Chain multiple steps
source.on.range >> transform >> target.on.data
Run the gallery for a full feature showcase:
python tests/manual-tests/gallery.py
Runtime tracing
SciQLopPlots ships with a built-in tracer that emits Chrome trace JSON, viewable in
Perfetto, Speedscope, or
chrome://tracing. Always compiled in, runtime-toggled, ~1 ns when off.
Enable for a session, then open the file in Perfetto:
from SciQLopPlots import tracing
with tracing.session("/tmp/sciqlop.json"):
panel.zoom_in_a_lot() # whatever's slow
Annotate Python work to land alongside the C++ zones (plot.replot,
setdata.colormap, resample.async_2d, …):
with tracing.zone("speasy.fetch", cat="data", product="amda/mms_fgm"):
data = speasy.get_data(...)
@tracing.traced("layer.eval", cat="layer")
def render_layer(...): ...
tracing.counter("queue_depth", q.size(), cat="fetch")
You can also auto-enable at process start with the SCIQLOP_TRACE env var:
SCIQLOP_TRACE=/tmp/sciqlop.json python my_script.py
When tracy_enable=true is also passed at build time, the same PROFILE_HERE_N
sites feed both the Chrome JSON tracer and the Tracy live-streaming view.
Building from source
Requires Qt6, PySide6 == 6.11.0, a C++20 compiler, and Meson.
# Development build (recommended — plain `debug` disables optimizations
# and makes the resampling pipelines noticeably sluggish)
meson setup build --buildtype=debugoptimized
meson compile -C build
# Install as editable Python package
pip install -e . --no-build-isolation
Build options
| Option | Type | Default | Description |
|---|---|---|---|
trace_refcount |
bool | false | Enable reference count tracing |
tracy_enable |
bool | false | Enable Tracy profiling |
with_opengl |
bool | true | Enable OpenGL support |
Contributing
Fork the repository, make your changes and submit a pull request. Bug reports and feature requests are welcome.
Credits
Development is supported by CDPP. We acknowledge support from Plas@Par.
Thanks
- PySide6 — Qt bindings and Shiboken6 binding generator
- NeoQCP — fork of QCustomPlot with async pipelines, multi-dtype support, and QRhi rendering
1 maintainer
Metadata
1 maintainer
Release files for SciQLopPlots 0.42.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sciqlopplots-0.42.0.tar.gz | 1.8 MB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| sciqlopplots-0.42.0-cp311-abi3-win_amd64.whl | CPython 3.11 | abi3 | Windows x86-64 | Details |
| sciqlopplots-0.42.0-cp311-abi3-manylinux_2_39_aarch64.whl | CPython 3.11 | abi3 | Linux glibc 2.39+ ARM64 | Details |
| sciqlopplots-0.42.0-cp311-abi3-manylinux_2_34_x86_64.whl | CPython 3.11 | abi3 | Linux glibc 2.34+ x86-64 | Details |
| sciqlopplots-0.42.0-cp311-abi3-macosx_13_0_x86_64.whl | CPython 3.11 | abi3 | macOS 13.0+ x86-64 | Details |
| sciqlopplots-0.42.0-cp311-abi3-macosx_13_0_arm64.whl | CPython 3.11 | abi3 | macOS 13.0+ ARM64 | Details |
Total release size: 32.4 MB
Release files / sciqlopplots-0.42.0.tar.gz
| Download URL | sciqlopplots-0.42.0.tar.gz |
|---|---|
| Size | 1.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b5e7d0e5dadacc471bdcbf5b14c130886676a650258a3bfcd05fbca2c0a3e6d3
|
|
BLAKE2b-256 checksum How to use checksums |
ab4342f550fecd32dbd9defc7bd8e7312b721cdb28c3cd54614938114d08534a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / sciqlopplots-0.42.0-cp311-abi3-win_amd64.whl
| Download URL | sciqlopplots-0.42.0-cp311-abi3-win_amd64.whl |
|---|---|
| Size | 4.5 MB |
| Tags | CPython 3.11 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
b6bd339b1bb1a6aa20b750d3fa28115d46ef52f0b217ba878108cd8c04f0d3ef
|
|
BLAKE2b-256 checksum How to use checksums |
de1bd46ec74f755acd60cbe67c9140983a1e8c4457cffe0fd54d51cf2e49a58b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / sciqlopplots-0.42.0-cp311-abi3-manylinux_2_39_aarch64.whl
| Download URL | sciqlopplots-0.42.0-cp311-abi3-manylinux_2_39_aarch64.whl |
|---|---|
| Size | 6.8 MB |
| Tags | CPython 3.11 Linux glibc 2.39+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
6508e8b3531f69ba54b4a13dab072d0f366345be7b2170e6a0d861e1a57a2ad2
|
|
BLAKE2b-256 checksum How to use checksums |
0e156de42e0cb92a026ab35899187f4ae9354238aa23513118a9ac9cf5d15a82
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / sciqlopplots-0.42.0-cp311-abi3-manylinux_2_34_x86_64.whl
| Download URL | sciqlopplots-0.42.0-cp311-abi3-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 7.3 MB |
| Tags | CPython 3.11 Linux glibc 2.34+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
19f914d1f2523e42472d00f74267180293a71d70eedccb2ac90012ac14a8232a
|
|
BLAKE2b-256 checksum How to use checksums |
a9cb42da8977093cc7e87d306e7e626b66eeedece5eb5e81319a878394138ccc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / sciqlopplots-0.42.0-cp311-abi3-macosx_13_0_x86_64.whl
| Download URL | sciqlopplots-0.42.0-cp311-abi3-macosx_13_0_x86_64.whl |
|---|---|
| Size | 6.2 MB |
| Tags | CPython 3.11 abi3 macOS 13.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
1d0c75859abfa6eb11dcb5ae6d8def734955915e6201fc6e0bfbe077f7fde533
|
|
BLAKE2b-256 checksum How to use checksums |
916deb2053d623c8faf9b23284612f8fe9c36ac93746ac48ff6919a5924dbff1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / sciqlopplots-0.42.0-cp311-abi3-macosx_13_0_arm64.whl
| Download URL | sciqlopplots-0.42.0-cp311-abi3-macosx_13_0_arm64.whl |
|---|---|
| Size | 5.7 MB |
| Tags | CPython 3.11 abi3 macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
079295158f67a0483f830c6ab2d8fab3414f239d308c4a67af643c2f9f2bac84
|
|
BLAKE2b-256 checksum How to use checksums |
7f7453d5664716e25e1745bed839c968f8c76e9a67fe244be8393302e07eab37
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
