Skip to content

Latest commit

 

History

History
225 lines (148 loc) · 6.66 KB

README.rst

File metadata and controls

225 lines (148 loc) · 6.66 KB
Raw
Travis CI Status AppVeyor CI Status PyPI Project Page PyPI - Python Version PyQt5 NIST Public Domain

SciPlot-PyQt: Publication-ready scientific plotting for Python

SciPlot-PyQt (aka SciPlot) is a user-interface/matplotlib wrapper built with PyQt5 that allows interactive plotting through an embedded matplotlib canvas. It enables fast and easy publication-ready plots and images:

  • Interactive plotting
  • Theme and style editing (TODO)
  • Figure saving and opening for later editing (TODO)

Dependencies

Note: These are the developmental system specs. Older versions of certain packages may work.

  • python >= 3.4
    • Tested with 3.6.7, 3.7.1
  • numpy
  • PyQT5 (5.5.* or 5.6.*)
    • Tested with 5.6, 5.8.1, 5.12
  • matplotlib (1.*, 2.*, 3.*)
  • Sphinx (1.5.2) (Only for building documentation)

Known Issues

  1. IPython: SciPlot has problems when imported and ran via sciplot.main() or %run from within IPython. It appears to work as expected when called through a normal Python interpreter.
  2. PyQt 5.7: There is a bug in PyQt 5.7.* that will prevent SciPlot's tables from showing the individual plot entries (see https://www.riverbankcomputing.com/pipermail/pyqt/2017-January/038483.html). Apparently, this will be fixed in 5.7.2.
    • As WinPython 3.5.2.3Qt5 and 3.5.2.2Qt5 use PyQt 5.7.*, it is advised to use WinPython 3.5.2.1Qt5 or 3.4.4.5Qt5 until the matter is sorted out.
    • Alternatively, one can uninstall pyqt5.7.* and force an install of <= 5.6.*.
  3. MATPLOTLIB 2.0: SciPlot version solder than 0.1.4 will crash with MPL 2.* as several changes have been made to the MPL API.
    • For v0.1.3, the dev-MPL2 branch should address those problems
    • v0.1.4 is a merge of v0.1.3 and the dev-MPL2 branch (with other updates)

Installation

Note: the installer only checks for the dependencies of matplotlib and numpy. PyQt5 is not checked for, though, it is also required. See Depencies above for more information and requirements.

Using pip (hard install)

# Only Python 3.* installed
pip install sciplot-pyqt

# If you have both Python 2.* and 3.* you may need
pip3 install sciplot-pyqt

Using pip (soft install [can update with git])

# Make new directory for sciplot-pyqt and enter it
# Clone from github
git clone https://github.com/CCampJr/SciPlot-PyQt.git

# Only Python 3.* installed
pip install -e .

# If you have both Python 2.* and 3.* you may need instead
pip3 install -e .

# To update in the future
git pull

Using setuptools

You will need to download the repository or clone the repository with git:

# Make new directory for sciplot-pyqt and enter it
# Clone from github
git clone https://github.com/CCampJr/SciPlot-PyQt.git

Perform the install without building the documentation:

python setup.py install

Perform the install and build the documentation (see dependencies above):

python setup.py build_sphinx
python setup.py install

Usage

import sciplot
sp = sciplot.main()

Note Sciplot-pyqt relies on an existing, active Qt5 QApplication instance to operate. Some versions of Matplotlib 1.5.* provide this, others do not. Matplotlib 2.* seems to always provide this functionality.

If you perform the examples below and just a non-repsonsive white window appears, follow up the plotting commands with:

sp.app.exec_()

Sciplot tests for this and will provide you with a message to your terminal:

No QApplication instance (this is common with certain
version of Matplotlib). Creating one.
You will need to exec manually after you finish plotting.

-----------Example---------------
import sciplot
sp = sciplot.main()

# Plot a line
sp.plot((0,1),(0,1))
# Start the QApplication
sp.app.exec_()

Example

sp.plot((0,1),(2,3),label='Line', x_label='X', y_label='Y', ls='--')
sp.fill_between((0,1),(1,2),(3,4),label='Fill Between', color='r', alpha=0.25)

./Screenshot.png

sp.hist(r, bins=100, label='Histogram', color=[0, .2, .3],
        x_label='Amplitude', y_label='Counts', alpha=0.5)

./Screenshot2.png

sp.imshow(r, clim=[25,75], cmap='viridis', label='Imshow', x_label='X (pix)',
          y_label='Y (pix)')

./Screenshot3.png

NONLICENSE

This software was developed at the National Institute of Standards and Technology (NIST) by employees of the Federal Government in the course of their official duties. Pursuant to Title 17 Section 105 of the United States Code, this software is not subject to copyright protection and is in the public domain. NIST assumes no responsibility whatsoever for use by other parties of its source code, and makes no guarantees, expressed or implied, about its quality, reliability, or any other characteristic.

Specific software products identified in this open source project were used in order to perform technology transfer and collaboration. In no case does such identification imply recommendation or endorsement by the National Institute of Standards and Technology, nor does it imply that the products identified are necessarily the best available for the purpose.

Contact

Charles H Camp Jr: charles.camp@nist.gov

Contributors

Charles H Camp Jr, Mona Lee, Xavier Audier