Pyqtgraph

What's Changed

Bug Fixes

* Refactor examples using `Interactor` to run on changing function parameters by ntjess in https://github.com/pyqtgraph/pyqtgraph/pull/2437

API Change

* deprecate GraphicsObject::parentChanged method by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2420

Other

* Move Console to generic template and make font Courier New by j9ac9k in https://github.com/pyqtgraph/pyqtgraph/pull/2435

What's Changed

Highlights

* With PyQt6 6.3.2+ PyQtGraph uses sip.array, which leads to significantly faster draw performance by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2314
* Introducing "interactive" parameter trees by ntjess in https://github.com/pyqtgraph/pyqtgraph/pull/2318
* Minimum Qt version now 5.15 for Qt5 and 6.2+ for Qt6 by j9ac9k in https://github.com/pyqtgraph/pyqtgraph/pull/2403
* with `enableExperimental` pyqtgraph accesses QPainterPathPrivate for faster QPainterPath generation by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2324

New Features

* Interactive params fixup by ntjess in https://github.com/pyqtgraph/pyqtgraph/pull/2318
* Added possibility to use custom dock labels by ardiloot in https://github.com/pyqtgraph/pyqtgraph/pull/2274
* Introduce API option to control whether lines are drawn as segmented lines by swvanbuuren in https://github.com/pyqtgraph/pyqtgraph/pull/2185
* access QPainterPathPrivate for faster arrayToQPath by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2324
* Update LabelItem to allow transparency in the text by ElpadoCan in https://github.com/pyqtgraph/pyqtgraph/pull/2300
* Make parameter tree read-only values selectable and copiable by ardiloot in https://github.com/pyqtgraph/pyqtgraph/pull/2311
* Have CSV exporter export error bar information by j9ac9k in https://github.com/pyqtgraph/pyqtgraph/pull/2405
* map pyqtgraph symbols to a matplotlib equivalent by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2395

Performance Improvements

* Improve performance of PlotCurveItem with QOpenGLWidget by bbc131 in https://github.com/pyqtgraph/pyqtgraph/pull/2264
* ScatterPlotItem: use Format_ARGB32_Premultiplied by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2317
* access QPainterPathPrivate for faster arrayToQPath by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2324
* make use of PyQt sip.array by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2314

Bug Fixes

* Fix GLImageItem regression by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2232
* Fixed the app crash on right clicked by Cosmicoppai in https://github.com/pyqtgraph/pyqtgraph/pull/2236
* Fix Regression in in ViewBox.updateScaleBox Caused by 2034 by campagnola in https://github.com/pyqtgraph/pyqtgraph/pull/2241
* Fix UFuncTypeError when plotting integer data on windows by campagnola in https://github.com/pyqtgraph/pyqtgraph/pull/2249
* Fixed division by zero when no pixmap is loaded by StSav012 in https://github.com/pyqtgraph/pyqtgraph/pull/2275
* Ensure in PlotCurveItem lookup occurs in tuple, not str by j9ac9k in https://github.com/pyqtgraph/pyqtgraph/pull/2294
* Fixed a crash when `step` option is missing by StSav012 in https://github.com/pyqtgraph/pyqtgraph/pull/2261
* Invalidate cached properties on geometryChanged signal by j9ac9k in https://github.com/pyqtgraph/pyqtgraph/pull/2357
* Bugfix: Handle example search failure due to bad regex by ntjess in https://github.com/pyqtgraph/pyqtgraph/pull/2121
* Address 2303 unapplied pen parameter constructor options by ntjess in https://github.com/pyqtgraph/pyqtgraph/pull/2305
* Issue 2203 Potential Fix: Disabled FlowchartCtrlWidget.nodeRenamed o… by HallowedDust5 in https://github.com/pyqtgraph/pyqtgraph/pull/2301
* Fix 2289 unwanted growing in scene context menu by ntjess in https://github.com/pyqtgraph/pyqtgraph/pull/2306
* 2283 delete limitation by rectangle width ROI by sasha-sem in https://github.com/pyqtgraph/pyqtgraph/pull/2285
* Update exception handling to catch exceptions in threads (py3 change) by campagnola in https://github.com/pyqtgraph/pyqtgraph/pull/2309
* Fix PlotCurveItem errors when pen=None by campagnola in https://github.com/pyqtgraph/pyqtgraph/pull/2315
* ScatterPlotItem point masking fix by ardiloot in https://github.com/pyqtgraph/pyqtgraph/pull/2310
* Use property to lazily declare rectangle by j9ac9k in https://github.com/pyqtgraph/pyqtgraph/pull/2356
* Fix missing import in Flowchart.py by Puff-Machine in https://github.com/pyqtgraph/pyqtgraph/pull/2421
* Fix doubling labels in DateAxisItem by bbc131 in https://github.com/pyqtgraph/pyqtgraph/pull/2413
* GridItem: Fix pen for usage of dash-pattern by bbc131 in https://github.com/pyqtgraph/pyqtgraph/pull/2304
* Update PColorMeshItem.py by LarsVoxen in https://github.com/pyqtgraph/pyqtgraph/pull/2327
* Fix infinite loop within DateAxisItem by bbc131 in https://github.com/pyqtgraph/pyqtgraph/pull/2365
* Fix GraphicsScene.itemsNearEvent and setClickRadius by bbc131 in https://github.com/pyqtgraph/pyqtgraph/pull/2383
* Modify MatplotlibWidget to accept QWidget super constructor parameters. by Dolphindalt in https://github.com/pyqtgraph/pyqtgraph/pull/2366
* Fix flickering, when panning/scrolling in a fully zoomed-out view by bbc131 in https://github.com/pyqtgraph/pyqtgraph/pull/2387
* Make auto downsample factor calculation more robust by StSav012 in https://github.com/pyqtgraph/pyqtgraph/pull/2253
* Fix : QPoint() no longer accepts float arguments by campagnola in https://github.com/pyqtgraph/pyqtgraph/pull/2260
* avoid double __init__ of DockDrop by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2286
* Add a few ImageView improvements by outofculture in https://github.com/pyqtgraph/pyqtgraph/pull/1828

API/Behavior Changes

* remove border QGraphicsRectItem from scene by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2225
* Introduce API option to control whether lines are drawn as segmented lines by swvanbuuren in https://github.com/pyqtgraph/pyqtgraph/pull/2185
* Modify CSV exporter to output original data without log mapping by NilsNemitz in https://github.com/pyqtgraph/pyqtgraph/pull/2297
* Expose useCache ScatterPlotItem option from plot method by ibrewster in https://github.com/pyqtgraph/pyqtgraph/pull/2258
* remove legend items manually from scene by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2368
* `getHistogramRange` for `HistogramLUTItem` by kremeyer in https://github.com/pyqtgraph/pyqtgraph/pull/2397
* Axis pen improvements by ibrewster in https://github.com/pyqtgraph/pyqtgraph/pull/2398
* remove MatplotlibWidget from pg namespace by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2400
* change the libOrder to favor Qt6 by Wubbzi in https://github.com/pyqtgraph/pyqtgraph/pull/2157

Examples

* Added Jupyter console widget and Example by jonmatthis in https://github.com/pyqtgraph/pyqtgraph/pull/2353
* Add glow example by edumur in https://github.com/pyqtgraph/pyqtgraph/pull/2242
* update multiplePlotSpeedTest.py to use PlotCurveItem instead of QGraphicsPathItem by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2426

Docs

* Add GLTextItem to docs by jebguth in https://github.com/pyqtgraph/pyqtgraph/pull/2419
* Add logo to docs by ixjlyons in https://github.com/pyqtgraph/pyqtgraph/pull/2384
* Enable nit-picky mode in documentation and fix associated warnings by j9ac9k in https://github.com/pyqtgraph/pyqtgraph/pull/1753
* Added UML class diagram to give overview of the most important classes by titusjan in https://github.com/pyqtgraph/pyqtgraph/pull/1631

Other

* Remove old Qt workarounds by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2224
* Track when ScatterPlotItem clears the tooltip, only clear when needed by ixjlyons in https://github.com/pyqtgraph/pyqtgraph/pull/2235
* Avoid import error in HDF5 exporter by campagnola in https://github.com/pyqtgraph/pyqtgraph/pull/2259
* test enum using : "enums & enum" by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2250
* add support for PySide6 6.3.0 QOverrideCursorGuard by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2263
* Used the power of `blockIfUnchanged` decorator by StSav012 in https://github.com/pyqtgraph/pyqtgraph/pull/2181
* Handle/remove unused variables by ksunden in https://github.com/pyqtgraph/pyqtgraph/pull/2094
* BusyCursor and QPainter fixes for PyPy by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2349
* Add a pyi stub file to import best-guess pyqt type hints by outofculture in https://github.com/pyqtgraph/pyqtgraph/pull/2358
* test_PlotCurveItem: unset skipFiniteCheck for next test by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2313
* lazy create the rectangle selection item by danielhrisca in https://github.com/pyqtgraph/pyqtgraph/pull/2168
* fix: super().__init__ does not need self by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2359
* Promote interactive `Run` action to group level by ntjess in https://github.com/pyqtgraph/pyqtgraph/pull/2414
* Enhance testing for creating parameters from saved states by ntjess in https://github.com/pyqtgraph/pyqtgraph/pull/2319
* add support for PySide6's usage of Python Enums by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2329
* remove QFileDialog PyQt4 compatibility code by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2394
* Bugfix: `interact` on decorated method that uses `self`. by ntjess in https://github.com/pyqtgraph/pyqtgraph/pull/2408
* use single generic template for all bindings by pijyoi in https://github.com/pyqtgraph/pyqtgraph/pull/2226
* `interact()` defaults to `ON_ACTION` behavior and accepts `runActionTemplate` argument by ntjess in https://github.com/pyqtgraph/pyqtgraph/pull/2432

New Contributors
* andriyor made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2212
* keziah55 made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2191
* Cosmicoppai made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2236
* bbc131 made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2264
* StSav012 made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2181
* ardiloot made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2274
* sasha-sem made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2285
* swvanbuuren made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2185
* Anatoly1010 made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2330
* LarsVoxen made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2327
* HallowedDust5 made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2301
* ElpadoCan made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2300
* dependabot made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2342
* jaj42 made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2389
* Dolphindalt made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2366
* kremeyer made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2397
* jonmatthis made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2353
* jebguth made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2419
* Puff-Machine made their first contribution in https://github.com/pyqtgraph/pyqtgraph/pull/2421

**Full Changelog**: https://github.com/pyqtgraph/pyqtgraph/compare/pyqtgraph-0.12.4...pyqtgraph-0.13.0

Highlights:
- 2055 Jupyter Support via jupyter-rfb
- 2011 Experimental High Performance With Lines > 1px Thickness
- 2059/2153 Python 3.10 Support

New Features:
- 2041 Allow unsetting various options in PlotDataItem and PlotCurveItem
- 2052 PlotItem Average pen and shadow pen are now accessible
- 2090 More coninient methods for color maps and bars

Performance Enhancements:
- 2023 PColorMeshItem Performance Improvements
- 2032 Speed up PlotCurveItem fillLevel
- 2036 Speed up arrayToQPath for connect='all' with non-finite values
- 2111 PlotCurveItem OpenGL avoid automatic conversion from float64 to float32
- 2124 Go back to using np.clip on Windows with numpy 1.22 or newer
- 2131 Avoid PyOpenGL automatic array conversion
- 2198 Cache values used in GraphicsWidget .boundingRect() and .shape() methods
- 2199 Avoid unnecessary call to viewRange if autoRange is disabled
- 2202 Cachce ViewBox view pixel size

Bug Fixes:
- 2034 Fix Mouse Event possitioning issue with grid
- 2047 Fixed WidgetGroup Handling QSplitter
- 2054 Limit ViewBox based on double precision limitations
- 2085 Reverse coordinates when drawing on row-major images
- 2087 Fix broken imports in some examples
- 2089 Don't raise exception when close method of an already-closed dock is called
- 2101 Change GroupParameterItem palette to look ok in darkmode on macOS
- 2103 Fix stuck ColorBarItem
- 2132 Workaround for PySide6 6.2.2 breaking change
- 2130 RangeColorMapItem derives from ColorMapParameter
- 2147 Fire correct signal for Checklist ParameterItem type
- 2148 Avoid comparing a string with a np.ndarray
- 2170 Fix formatting on minimum value of GradientLegend

API/Behavior Changes:
- 2081 Separate x and y flags for AxisItem.setLogMode
- 2086 ParameterTree PenParameter now uses GrouParameter instead of popup button
- 2097 Add a proxy delay to checklist ParameterItem changes via children edits
- 2192 Added option to makeARGB to disable masking NaNs

Other:
- 1915 Deprecate QtWidgets accessed through QtGui
- 2002 isort and pycln prun over entire repo
- 2038 Fixed various deprecations
- 2045 Examples Directory moved inside project directory
- 2051 Implement Pickle Protocol for RemoteGraphicsView
- 2053 Disable unneeded call to ViewBox.prepareForPaint()
- 2057 Avoid re-dispatching mouse events from the AxisItem
- 2064 Add a quantization limit to ViewBox
- 2073 Implementing glInfo without PyOpenGL
- 2077 Improved error message for invalid PYQTGRAPH_QT_LIB
- 2083 Added check for ROI to make sure its in a GraphicsScene
- 2093 Add helpful exceptions for invalid inputs to some methods
- 2096 Be lazier about importing h5py
- 2098 Remove polluting import namespace using *
- 2099 Convert == None to is None checks
- 2100 Avoid re-using variables in nested loops
- 2124 Fixed variety of deprecation warnings
- 2154 Fix typos and formatting errors in comments/docstrings
- 2194 stop using deprecated numpy.fromstring and use numpy.frombuffer instead

Highlights:
- PlotCurveItem render speed is now substantially faster
- 1868/1873 Example app now has filter text input
- 1910 PlotSpeedTest now has parameter tree control panel

New Features:
- 1844 More parameter item types (File, Calendar, ProgressBar, Font, Pen, Slider)
- 1865 Matplotlib colormaps viridis, plasma, magma and inferno are now included in pyqtgraph
- 1911 Extend Colormap with HSL cycles and subset generation
- 1932 Make anti-aliasing optional for paintGL in PlotCurveItem
- 1944 Expand use of QColor functions/methods, including setNamedColor
- 1952 Add checklist parameter item
- 1998 ThreadTrace can now save to a file

Performance Enhancement:
- 1927 Reduce ColorMap inefficiencies
- 1956 use QByteArray as backing store in arrayToQPath
- 1965 perform arrayToQPath in chunks

Bug Fixes:
- 1845 Fix zoom behavior with showGrid by separating mouse events stolen by AxisItem
- 1860 RemoteGraphicsView and RemoteSpeedTest now work under windows venv environments
- 1865 Fixed matplotlib colormap importer code
- 1869 Fix ColorBarItem tick position on export
- 1871 Allow adding items to GLViewWidget before showing plot
- 1875 Fix calls in mouse methods in GLViewWidgets due to missing event.localPos() in PyQt6
- 1876 Fix for improper placement of ROI handle positions in some cases
- 1889/2003 Fix call to drawText in GLTextItem and GLGradientLegendItem on Python 3.10
- 1897/1902 Re-enable "experimental" feature with fix for PlotCurveItem with OpenGL on Windows
- 1907 Fix GLVolumeItem example for arm64 platforms
- 1909 Check if AxisItem.label is None before and exit early in resizeEvent
- 1920 arrayToQPath can handle empty paths
- 1936 QPolygonF creation can now handle empty arrays
- 1968 Fix output of clip_array in colormap.modulatedBarData not being assigned
- 1973 Fix PlotItem.updateDecimate unhiding intentionally hidden curves
- 1974 Fix ImageView levelMode with levelMode == 'rgba'
- 1987 Fix HistogramLUTItem itemChanged with use of autoLevel
- 2009 Fix ROI curves hidding in ImageView

API/Behavior Changes:
- 1992 Reverted to traditional log10 mode for PlotDataItem
- 1840 Allow border=False in GraphicsLayout
- 1846 Reduced pollution to pg.namespace
- 1853 ColorMap.getColors and getStops behavior changes
- 1864 Draw GradientLegend in ViewBox coordinates
- 1885 Raise TypeError instead of general Exception if functions.eq is unable to determine equality
- 1903 Cleanup GLViewWidget
- 1908 More readable parameters for ColorBarItem
- 1914 Emit deprecation warning for use of pyqtgraph.ptime
- 1928 Restore previous signature of TargetItem.setPos
- 1940 fix log mode by reverting to previous formulation
- 1954 Deprecate use of values opt for list parameter type
- 1995 ColorButton now takes optional padding argument instead of hardcoded value of 6

Other:
- 1862/1901 MetaArray now under deprecation warning, to be removed in a future version
- 1892 Add GLPainterItem Example
- 1844 Debugged elusive intermitted CI segfault
- 1870/1891 Updated README.md
- 1895 Update CONTRIBUTING.md
- 1913 Bump sphinx and theme versions
- 1919 Re-organize paramtypes
- 1935 Remove some unused imports
- 1939 Remove usage of python2_3.py
- 1941 Remove str casting of QTextEdit.toPlainText output
- 1942 Add EOF newline to files missing it
- 1943 Remove python2 code paths
- 1951 Fix typos in docs
- 1957 Bump minimum numpy version to 1.18
- 1968 Fix ImageView calling deprecated QGraphicsItem.scale()
- 1985 delegate float LUTs to makeARGB with warning
- 2014 Replace couple absolute imports with relative imports

Highlights
- Qt6 6.0 support has been removed in favor of Qt6 6.1+
- More numba utilization, specifically for makeARGB
- Substantial ImageItem performance improvements have been made thanks to pijyoi and outofculture
- Significant performance improvements made to ScatterPlotItem and LinePlots
- More ColorMap features/support (more are coming!)

New Features
- 1318 Added TargetItem
- 1707 Added Qt 6.1 support
- 1729 Allow gradient position to be configured on a histogram
- 1742 Better support for plotting with gradients
- 1776 Add GLTextItem
- 1797 Add ColorMap linearization (using CIELab calculations), colorDistance functionality
- 1865 Include viridis, magma, plasma, inferno, and cividis colormaps
- 1868/1873 Example app now has a filter text box to search for relevant examples

Performance enhancement:
- 1738, 1695, 1786, 1768, 1794 - ImageItem/makeARGB performance improvements
- 1724 Use math module for scalar values math instead of numpy functions
- 1796 Greatly speed up line plots with use-case of connect='all'
- 1817 Speed up some cases of connect='finite' (few discontinuities)
- 1829 Use QPainter.drawPixmapFragments for ScatterPlotItem

Bug Fixes:
- 1700 Fixed ROI getArrayRegion
- 1748 Fixed bug when plotting boolean arrays in PlotDataItem
- 1791 Callable LUTs being used on the ImageItem substrates
- 1783 Fix memory leak in GLMeshItem
- 1802 Updated cx_freeze example and added workaround for template files
- 1804 Fix mouseClick handling for Qt6 on ROIs
- 1799 Force cameraPosition() to return a Vector in GLViewWidget
- 1809 Sanitize ShowGrid Alpha Input PlotItem
- 1816 Fix bug with Parameter value failing with numpy array-like values
- 1827 Fix BusyCursor to use internal stack provided by setOverrideCursor/restoreOverrideCursor
- 1833 Fix ScatterPlot render issues for PyQt6 6.1.0
- 1843 Fix zoom only applied to y-axis with show grid
- 1860 Fix pyqtgraph multiprocessing on Windows inside a venv environment
- 1869 Fix color bar ticks not being drawn correctly during export
- 1865 Fix matplotlib colormap import code
- 1876 Fix LineROI handle positions being way off-base in some circumstances
- 1871 Allow adding items to GLViewWidget before calling GLViewWidget.show()
- 1864 Draw GradientLegend in ViewBox coordinate system with correct orientation
- 1875 Fixed mouse events in GLViewWidget for PyQt6 bindings

API/Behavior Changes:
- 519 Expose clickable property in PlotDataItem
- 1772 Keep ColorMap values for RGBA as uint8
- 1736 RemoteGraphicsView is now hidpi aware
- 1779 Have SpinBox use fallback minStep in dec mode
- 1706 Colors defined with hex string values must start with a
- 1819 Added method to disable autoscaling for HistogramLUTItem
- 1638 Expose number of subsamples in ImageItem auto-level determination
- 1824 Remove little-endian assumption for image export

Other
- 1807 Merge pyqtgraph/test-data repo into main repo, move test files to tests directory
- 1862 Scheduled deprecation for MetaArray module
- 1846 Cleaned up pg namespace

New Features
- 1596 - Add ColorBarItem for simplified image level adjustment

Performance enhancement:
- 1650 Don't use clip_array on scalers in DynamicPlotRange
- 1617 Optimize makeARGB for ubyte images
- 1648 Implement blocked variant of rescaleData

API/Behavior Change:
- 1690 Parameter Item default created from value if not present

Bug Fixes:
- 1665 Don't pass brush to mkPen in LegendItem.paint()
- 1660 Include colormaps in the python wheel
- 1653 Fix accidental disabling of style updates in PlotDataItem
- 1647 Handle empty adjacency array for GraphItem
- 1680 Fix test suite for big-endian architectures
- 1694 DateAxisItem now accounts for Daylight Savings Time
- 1691 Make sure dynamic range limiter runs on PlotDataItem