3af23725ca
* Added hovering demo to ScatterPlot example * Use Qt's serialization for SymbolAtlas.symbolMap keys Yields significant performance improvements when updating the scatter plot's options. See e.g. the plot hover example. * Further optimized scatter plot picking * Fix ScatterPlot example tool tip * Clean up while I'm here * Compatibility * Some simple optimizations for ScatterPlotItem Speedups for ScatterPlotSpeedTest.py: ~50% without pxMode ~ 0% pxMode with useCache ~30% pxMode without useCache * ~3x speedup in scatter plot speed test with pxMode * More optimization low-hanging fruit for the scatter plot * Removed hover example to lazily pass tests * Avoid segfault * Re-add hover example to ScatterPlot.py * Switch to id-based keying for scatter plot symbol atlas - Use cases exist where serialization-based keying is a significant bottleneck, e.g. updating without atlas invalidation when a large variety pens or brushes are present. - To avoid a performance hit, the onus is on the user to carefully reuse pen and brush objects. * Optimized caching in scatter plot hovering example * Fixed and optimized scatter plot hovering example * Minor scatter plot optimization * Cleanup * Store hovered points in a set for the hovering example * Keep a limited number symbol atlas entries around for future reuse * Added a docstring note to remind the user to reuse QPen and QBrush objects for better performance * Tidied up hovering example * Typo * Avoid unnecessary atlas rebuilds * Refactored SymbolAtlas * Efficient appending to SymbolAtlas * SymbolAtlas rewrite * Cleanup and profiling * Add randomized brushes to speed test * Add loc indexer to ScatterPlotItem * Profile ScatterPlotItem.paint to identify bottlenecks * Reuse targetRect to improve paint performance * Readability improvements (opinionated) * Only need to set x and y of targetRect - w and h can stay set to 0 (not entirely sure why) - this is a bit faster than setting all of x, y, w, h * Minor renaming * Strip off API changes and leave to another PR * Renaming * Compatibility * Use drawPixmap(x, y, pm, sx, sy, sw, sh) signature to avoid needing to update QRectFs * Use different drawing approaches for each Qt binding for performance reasons * Fix a bug introduced two commits ago Incidentally, I think there is a similar bug in the main branch currently. * Minor performance and readability improvements * Strip out source and target QRectF stuff * Bring source and target QRectF stuff back in a less coupled way * Leave deprecating getSpotOpts for another PR * Compatibility fix * Added docstrings and use SymbolAtlas__len__ where possible * Fix export issue * Add missing import * Add deprecation warnings * Avoid using deprecated methods * Fix and cleanup max spot size measurements * Make creation of style opts entries explicit * Add hovering API to ScatterPlotItem * Compatibility * Marshal pen and brush lists in setPen and setBrush * Fixed platform dependent bug |
||
|---|---|---|
| .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 2020 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
- Python 2.7, or 3.x
- Required
- PyQt 4.8+, PySide, PyQt5, or PySide2
numpy
- Optional
scipyfor image processingpyopenglfor 3D graphicshdf5for large hdf5 binary format support
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 | ✅ | ❌ | ❌ | ❌ |
| PyQt5-5.9 | ❌ | ✅ | ❌ | ❌ |
| PySide2-5.13 | ❌ | ❌ | ✅ | ❌ |
| PyQt5-Latest | ❌ | ❌ | ❌ | ✅ |
| PySide2-Latest | ❌ | ❌ | ❌ | ✅ |
- pyqtgraph has had some incompatibilities with PySide2 versions 5.6-5.11, and we recommend you avoid those versions if possible
- on macOS with Python 2.7 and Qt4 bindings (PyQt4 or PySide) the openGL related visualizations do not work reliably
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@master
- Last released version:
- From conda
- Last released version:
conda install -c conda-forge 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.
Documentation
The official documentation lives at https://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.