PyQtGraph

A pure-Python graphics library for PyQt5/PyQt6/PySide2/PySide6

Copyright 2020 Luke Campagnola, University of North Carolina at Chapel Hill

http://www.pyqtgraph.org

PyQtGraph is intended for use in mathematics / scientific / engineering applications. Despite being written entirely in python, the library is fast due to its heavy leverage of numpy for number crunching, Qt's GraphicsView framework for 2D display, and OpenGL for 3D display.

Requirements

PyQtGraph has adopted NEP 29.

This project supports:

• All minor versions of Python released 42 months prior to the project, and at minimum the two latest minor versions.
• All minor versions of numpy released in the 24 months prior to the project, and at minimum the last three minor versions.
• All Qt5 versions from 5.12-5.15, and Qt6 6.1+

Currently this means:

• Python 3.8+
• Qt 5.12-5.15, 6.1+
• PyQt5, PyQt6, PySide2, or PySide6
• numpy 1.19+

Optional added functionalities

Through 3rd part libraries, additional functionality may be added to PyQtGraph, see the table below for a summary.

Library	Added functionality
scipy	Image processing through ndimage Data array filtering through signal
pyopengl	3D graphics Faster image processing Note: on macOS Big Sur only works with python 3.9.1+
h5py	Export in hdf5 format
colorcet	Add a collection of perceptually uniform colormaps
matplotlib	Export of PlotItem in matplotlib figure Add matplotlib collection of colormaps
cupy	CUDA-enhanced image processing Note: On Windows, CUDA toolkit must be >= 11.1
numba	Faster image processing
jupyter_rfb	Jupyter Notebook support

Qt Bindings Test Matrix

The following table represents the python environments we test in our CI system. Our CI system uses Ubuntu 20.04, Windows Server 2019, and macOS 10.15 base images.

Qt-Bindings	Python 3.8	Python 3.9	Python 3.10
PySide2-5.12	✳️	✳️	✳️
PyQt5-5.12	✅	❌	❌
PySide2-5.15		✅
PyQt5-5.15		✅
PySide6-6.2			✅
PyQt6-6.2			✅

• ❌ - Not compatible
• ✅ - Tested
• ✳️ - Requires conda-forge PySide2 package

Support

• Report issues on the GitHub issue tracker
• Post questions to
  • mailing list / forum
  • StackOverflow
  • GitHub Discussions

Installation Methods

• From PyPI
  • Last released version: pip install pyqtgraph
  • Latest development version: pip install git+https://github.com/pyqtgraph/pyqtgraph@master
• From conda
  • Last released version: conda install -c conda-forge pyqtgraph
• To install system-wide from source distribution: python setup.py install
• Many linux package repositories have release versions.
• To use with a specific project, simply copy the PyQtGraph subdirectory anywhere that is importable from your project.

Documentation

The official documentation lives at pyqtgraph.readthedocs.io

The easiest way to learn PyQtGraph is to browse through the examples; run python -m pyqtgraph.examples to launch the examples application.

Used By

Here is a partial listing of some of the applications that make use of PyQtGraph!

• ACQ4
• Orange3
• neurotic
• ephyviewer
• Joulescope
• rapidtide
• argos
• PySpectra
• Semi-Supervised Semantic Annotator
• PyMeasure
• Exo-Striker
• HussariX
• EnMAP-Box
• EO Time Series Viewer

Do you use PyQtGraph in your own project, and want to add it to the list? Submit a pull request to update this listing!