983cc1695e
* Do not wrap PlotView/ImageView There is no need to wrap PlotView/ImageView into QMainWindow, since only purpose of the QMainWindow is some default menu toolbar & menu handling, that is not used by PyQtGraph anyway. Moreover, every parent-less Qt widget can become window, so this change just use PlotView/ImageView as windows, removing extra complexity, eg. method forwarding, self.win property. Another benefit of this change, it that these windows get initial dimensions and titles as they were designed in .ui file. * Properly cleanup on ImageView.close() We should not close explicitly child widgets or clear scene, otherwise Qt will deallocate children views, and cause "wrapped C/C++ object of type ImageItem has been deleted" error next time we call close() and/or some other methods. All children, including self.ui.roiPlot, self.ui.graphicsView will be closed together with its parent, so there is no need to close them explicitly. So the purpose of close it to reclaim the memory, but not to make the existing ImageView object dysfunctional. * Remove references to plot & image windows after close PyQtGraph images and plots module list variables are currently holding references to all plots and image windows returned directly from main module. This does not seem to be documented however, and causes the Qt windows to be not released from memory, even if user releases all own references. This change removes the references from images/plots list once window is closed, so when there is no other reference, window and all related memory is reclaimed. * Change all UI forms title from Form to PyQtGraph Co-authored-by: Ogi Moore <ognyan.moore@gmail.com> |
||
|---|---|---|
| .github/ISSUE_TEMPLATE | ||
| doc | ||
| examples | ||
| pyqtgraph | ||
| tools | ||
| .coveragerc | ||
| .flake8 | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| .readthedocs.yml | ||
| azure-pipelines.yml | ||
| azure-test-template.yml | ||
| CHANGELOG | ||
| CONTRIBUTING.md | ||
| LICENSE.txt | ||
| MANIFEST.in | ||
| pytest.ini | ||
| README.md | ||
| setup.py | ||
| test.py | ||
| tox.ini | ||
PyQtGraph
A pure-Python graphics library for PyQt/PySide/PyQt5/PySide2
Copyright 2019 Luke Campagnola, University of North Carolina at Chapel Hill
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
- PyQt 4.8+, PySide, PyQt5, or PySide2
- PySide2 5.14 does not have loadUiType functionality, and thus the example application will not work. You can follow along with restoring that functionality here.
- Python 2.7, or 3.x
- Required
numpy
- Optional
scipyfor image processingpyopenglfor 3D graphics- macOS with Python2 and Qt4 bindings (PyQt4 or PySide) do not work with 3D OpenGL graphics
pyqtgraph.openglwill be depreciated in a future version and replaced withVisPy
hdf5for large hdf5 binary format support
- Known to run on Windows, Linux, and macOS.
Qt Bindings Test Matrix
The following table represents the python environments we test in our CI system. Our CI system uses Ubuntu 18.04, Windows Server 2019, and macOS 10.15 base images.
| Qt-Bindings | Python 2.7 | Python 3.6 | Python 3.7 | Python 3.8 |
|---|---|---|---|---|
| PyQt-4 | ✅ | ❌ | ❌ | ❌ |
| PySide1 | ✅ | ❌ | ❌ | ❌ |
| PyQt-5.9 | ❌ | ✅ | ❌ | ❌ |
| PySide2-5.13 | ❌ | ❌ | ✅ | ❌ |
| PyQt-5.14 | ❌ | ❌ | ❌ | ✅ |
- pyqtgraph has had some incompatabilities with PySide2-5.6, and we recommend you avoid those bindings if possible
- on macOS with Python 2.7 and Qt4 bindings (PyQt4 or PySide) the openGL related visualizations do not work
Support
- Report issues on the GitHub issue tracker
- Post questions to the mailing list / forum or StackOverflow
Installation Methods
- From PyPI:
- Last released version:
pip install pyqtgraph - Latest development version:
pip install git+https://github.com/pyqtgraph/pyqtgraph@develop
- Last released version:
- From conda
- Last released version:
conda install pyqtgraph
- Last released version:
- 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.
- For installation packages, see the website (pyqtgraph.org)
Documentation
The easiest way to learn pyqtgraph is to browse through the examples; run python -m pyqtgraph.examples for a menu.
The official documentation lives at https://pyqtgraph.readthedocs.io