2019-06-11 05:24:53 +00:00
2020-08-15 20:18:08 +00:00
[](https://pyqtgraph.visualstudio.com/pyqtgraph/_build/latest?definitionId=17& branchName=master)
2020-05-18 21:53:41 +00:00
[](https://pyqtgraph.readthedocs.io/en/latest/?badge=latest)
2019-06-11 05:24:53 +00:00
2013-09-12 06:01:52 +00:00
PyQtGraph
=========
2019-06-11 05:24:53 +00:00
A pure-Python graphics library for PyQt/PySide/PyQt5/PySide2
2013-09-12 06:22:26 +00:00
2020-06-07 03:34:21 +00:00
Copyright 2020 Luke Campagnola, University of North Carolina at Chapel Hill
2013-09-12 06:22:26 +00:00
< http: / / www . pyqtgraph . org >
2013-09-12 06:01:52 +00:00
2018-04-25 23:55:10 +00:00
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.
2013-09-12 06:22:26 +00:00
2013-09-12 06:01:52 +00:00
Requirements
------------
2013-09-12 06:22:26 +00:00
2020-02-28 22:48:24 +00:00
* Python 2.7, or 3.x
2019-06-11 05:24:53 +00:00
* Required
2020-06-07 03:34:21 +00:00
* PyQt 4.8+, PySide, PyQt5, or PySide2
2019-11-12 17:02:08 +00:00
* `numpy`
2019-06-11 05:24:53 +00:00
* Optional
2019-11-12 17:02:08 +00:00
* `scipy` for image processing
2019-06-11 05:24:53 +00:00
* `pyopengl` for 3D graphics
* `hdf5` for large hdf5 binary format support
Qt Bindings Test Matrix
-----------------------
2020-02-28 22:48:24 +00:00
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.
2019-06-11 05:24:53 +00:00
2020-06-04 04:27:49 +00:00
| Qt-Bindings | Python 2.7 | Python 3.6 | Python 3.7 | Python 3.8 |
| :------------- | :----------------: | :----------------: | :----------------: | :----------------: |
| PyQt-4 | :white_check_mark: | :x: | :x: | :x: |
| PySide1 | :white_check_mark: | :x: | :x: | :x: |
| PyQt5-5.9 | :x: | :white_check_mark: | :x: | :x: |
| PySide2-5.13 | :x: | :x: | :white_check_mark: | :x: |
| PyQt5-Latest | :x: | :x: | :x: | :white_check_mark: |
| PySide2-Latest | :x: | :x: | :x: | :white_check_mark: |
2020-06-07 03:34:21 +00:00
* 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
2013-09-12 06:01:52 +00:00
Support
-------
2018-04-25 23:55:10 +00:00
2019-05-23 05:07:30 +00:00
* Report issues on the [GitHub issue tracker ](https://github.com/pyqtgraph/pyqtgraph/issues )
* Post questions to the [mailing list / forum ](https://groups.google.com/forum/?fromgroups#!forum/pyqtgraph ) or [StackOverflow ](https://stackoverflow.com/questions/tagged/pyqtgraph )
2013-09-12 06:01:52 +00:00
Installation Methods
--------------------
2013-09-12 06:22:26 +00:00
2019-05-23 05:07:30 +00:00
* From PyPI:
* Last released version: `pip install pyqtgraph`
2020-06-07 03:34:21 +00:00
* Latest development version: `pip install git+https://github.com/pyqtgraph/pyqtgraph@master`
2019-06-11 05:24:53 +00:00
* From conda
2020-06-07 03:34:21 +00:00
* Last released version: `conda install -c conda-forge pyqtgraph`
2018-07-10 23:14:59 +00:00
* 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
2019-05-23 05:07:30 +00:00
anywhere that is importable from your project.
2013-09-12 06:01:52 +00:00
Documentation
-------------
2013-09-12 06:22:26 +00:00
2020-05-18 21:53:41 +00:00
The official documentation lives at https://pyqtgraph.readthedocs.io
2020-06-07 03:34:21 +00:00
The easiest way to learn pyqtgraph is to browse through the examples; run `python -m pyqtgraph.examples` to launch the examples application.
