Iterative improvement of the README file

Replace "pyqtgraph" by "PyQtGraph".
Replace the optional libraries list by an "Optional added functionalities" section.
More precise on the role of each optional library.
Add numba in optional library.
This commit is contained in:
Etienne Dumur 2021-06-29 11:26:51 +02:00
parent 08e460ad34
commit da39e8f460

View File

@ -23,7 +23,7 @@ heavy leverage of numpy for number crunching, Qt's GraphicsView framework for
Requirements Requirements
------------ ------------
pyqtgraph has adopted [NEP 29](https://numpy.org/neps/nep-0029-deprecation_policy.html). PyQtGraph has adopted [NEP 29](https://numpy.org/neps/nep-0029-deprecation_policy.html).
This project supports: This project supports:
@ -38,15 +38,21 @@ Currently this means:
* Required * Required
* [PyQt5](https://www.riverbankcomputing.com/software/pyqt/), [PyQt6](https://www.riverbankcomputing.com/software/pyqt/), [PySide2](https://wiki.qt.io/Qt_for_Python) or [PySide6](https://wiki.qt.io/Qt_for_Python) * [PyQt5](https://www.riverbankcomputing.com/software/pyqt/), [PyQt6](https://www.riverbankcomputing.com/software/pyqt/), [PySide2](https://wiki.qt.io/Qt_for_Python) or [PySide6](https://wiki.qt.io/Qt_for_Python)
* [`numpy`](https://github.com/numpy/numpy) 1.17+ * [`numpy`](https://github.com/numpy/numpy) 1.17+
* Optional
* [`scipy`](https://github.com/scipy/scipy) for image processing Optional added functionalities
* [`pyopengl`](https://github.com/mcfletch/pyopengl) for 3D graphics ------------------------------
* [`pyopengl`](https://github.com/mcfletch/pyopengl) on macOS Big Sur only works with python 3.9.1+
* [`h5py`](https://github.com/h5py/h5py) for large hdf5 binary format support Through 3rd part libraries, additional functionality may be added to PyQtGraph, see the table below for a summary.
* [`colorcet`](https://github.com/holoviz/colorcet) for supplemental colormaps
* [`matplotlib`](https://github.com/matplotlib/matplotlib) for supplemental colormaps | Library | Added functionality |
* [`cupy`](https://docs.cupy.dev/en/stable/install.html) for CUDA-enhanced image processing |----------------------------------------------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
* On Windows, CUDA toolkit must be >= 11.1 | [`scipy`](https://github.com/scipy/scipy) | <ul style="list-style-type: None;text-align: left;"><li> Image processing through [`ndimage`](https://docs.scipy.org/doc/scipy/reference/ndimage.html)</li><li> Data array filtering through [`signal`](https://docs.scipy.org/doc/scipy/reference/signal.html) </li><ul> |
| [`pyopengl`](https://github.com/mcfletch/pyopengl) | <ul style="list-style-type: None;text-align: left;"><li> 3D graphics </li><li> Faster image processing </li><li>Note: on macOS Big Sur only works with python 3.9.1+</li></ul> |
| [`h5py`](https://github.com/h5py/h5py) | <ul style="list-style-type: None;text-align: left;"><li> Export in hdf5 format </li></ul> |
| [`colorcet`](https://github.com/holoviz/colorcet) | <ul style="list-style-type: None;text-align: left;"><li> Add a collection of perceptually uniform colormaps </li></ul> |
| [`matplotlib`](https://github.com/matplotlib/matplotlib) | <ul style="list-style-type: None;text-align: left;"><li> Export of PlotItem in matplotlib figure </li><li> Add matplotlib collection of colormaps </li></ul> |
| [`cupy`](https://docs.cupy.dev/en/stable/install.html) | <ul style="list-style-type: None;text-align: left;"><li> CUDA-enhanced image processing </li><li> Note: On Windows, CUDA toolkit must be >= 11.1 </li></ul> |
| [`numba`](https://github.com/numba/numba) | <ul style="list-style-type: None;text-align: left;"><li> Faster image processing </li></ul> |
Qt Bindings Test Matrix Qt Bindings Test Matrix
----------------------- -----------------------
@ -81,7 +87,7 @@ Installation Methods
* Last released version: `conda install -c conda-forge pyqtgraph` * Last released version: `conda install -c conda-forge pyqtgraph`
* To install system-wide from source distribution: `python setup.py install` * To install system-wide from source distribution: `python setup.py install`
* Many linux package repositories have release versions. * Many linux package repositories have release versions.
* To use with a specific project, simply copy the pyqtgraph subdirectory * To use with a specific project, simply copy the PyQtGraph subdirectory
anywhere that is importable from your project. anywhere that is importable from your project.
Documentation Documentation
@ -89,7 +95,7 @@ Documentation
The official documentation lives at [pyqtgraph.readthedocs.io](https://pyqtgraph.readthedocs.io) The official documentation lives at [pyqtgraph.readthedocs.io](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. The easiest way to learn PyQtGraph is to browse through the examples; run `python -m pyqtgraph.examples` to launch the examples application.
Used By Used By
------- -------