Go to file
Ogi Moore 584c4516f0
Expand CI + pre-commit (#991)
* Initial attempt at extra checks in CI land

* Adding flake8 config

* Adding pre-commit configuration and explanation in CONTRIBUTING.md
2019-08-29 13:56:25 -07:00
.github/ISSUE_TEMPLATE Add issue template (#976) 2019-07-02 10:26:51 -04:00
doc BarGraphItem CSV export and documentation 2019-08-06 09:32:43 -07:00
examples Expand CI + pre-commit (#991) 2019-08-29 13:56:25 -07:00
pyqtgraph fix encoding error in checkOpenGLVersion (#787) 2019-08-18 12:16:31 -07:00
tools Expand CI + pre-commit (#991) 2019-08-29 13:56:25 -07:00
.coveragerc MNT: hard code the coverage report location 2015-08-01 11:54:15 -04:00
.flake8 Expand CI + pre-commit (#991) 2019-08-29 13:56:25 -07:00
.gitignore TST: Attempt 1 at breaking out ViewBox tests 2015-07-31 11:08:14 -04:00
.mailmap cleaner mailamp 2013-09-12 12:36:02 +08:00
.pre-commit-config.yaml Expand CI + pre-commit (#991) 2019-08-29 13:56:25 -07:00
.travis.yml Add timeout for pytest<5 2019-07-01 11:28:15 -07:00
CHANGELOG Add changelog entry and credit for previous PR 2018-11-09 07:18:36 -08:00
CONTRIBUTING.md Expand CI + pre-commit (#991) 2019-08-29 13:56:25 -07:00
LICENSE.txt - Major reorganization; we now follow the standard python package structure. 2012-12-26 17:51:52 -05:00
MANIFEST.in manifest corrections 2014-12-24 11:05:05 -05:00
README.md Skip GL* examples if on macOS with python2 and qt4 bindings, and update readme 2019-06-25 23:05:38 -07:00
azure-pipelines.yml Expand CI + pre-commit (#991) 2019-08-29 13:56:25 -07:00
azure-test-template.yml Expand CI + pre-commit (#991) 2019-08-29 13:56:25 -07:00
pytest.ini Add timeout option back to ini and remove command line option 2019-07-01 09:22:48 -07:00
setup.py Expand CI + pre-commit (#991) 2019-08-29 13:56:25 -07:00
test.py We support pyside2 don't we? 2019-05-30 14:40:39 -07:00
tox.ini Remove pytest-faulthandler from test dependencies 2019-06-30 12:05:57 -07:00

README.md

Build Status

PyQtGraph

A pure-Python graphics library for PyQt/PySide/PyQt5/PySide2

Copyright 2019 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

  • PyQt 4.8+, PySide, PyQt5, or PySide2
  • python 2.7, or 3.x
  • Required
    • numpy, scipy
  • Optional
    • pyopengl for 3D graphics
      • macOS with Python2 and Qt4 bindings (PyQt4 or PySide) do not work with 3D OpenGL graphics
      • pyqtgraph.opengl will be depreciated in a future version and replaced with VisPy
    • hdf5 for large hdf5 binary format support
  • Known to run on Windows, Linux, and macOS.

Qt Bindings Test Matrix

Below is a table of the configurations we test and have confidence pyqtgraph will work with. All current operating major operating systems (Windows, macOS, Linux) are tested against this configuration. We recommend using the Qt 5.12 or 5.9 (either PyQt5 or PySide2) bindings.

Python Version PyQt4 PySide PyQt5-5.6 PySide2-5.6 PyQt5-5.9 PySide2-5.9 PyQt5-5.12 PySide2 5.12
2.7
3.5
3.6
3.7
  • 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

Installation Methods

  • From PyPI:
    • Last released version: pip install pyqtgraph
    • Latest development version: pip install git+https://github.com/pyqtgraph/pyqtgraph@develop
  • From conda
    • Last released version: conda install 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.
  • 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 http://pyqtgraph.org/documentation