Bugfixes:

  - ArrowItem auto range now works correctly
  - Dock drag/drop fixed on PySide
  - Made padding behavior consistent across ViewBox methods
  - Fixed MeshData / python2.6 incompatibility
  - Fixed ScatterPlotItem.setSize and .setPointData
  - Workaround for PySide bug; GradientEditor fixed
  - Prefer initially selecting PlotItem rather then ViewBox when exporting
  - Fixed python3 import error with flowcharts

Cleaned up examples, made code editable from example loader
Minor documentation updates

Author: Luke Campagnola

doc/source/how_to_use.rst

@@ -17,7 +17,7 @@ Pyqtgraph makes it very easy to visualize data from the command line. Observe::
     import pyqtgraph as pg
     pg.plot(data)   # data can be a list of values or a numpy array
 
-The example above would open a window displaying a line plot of the data given. The call to :func:`pg.plot <pyqtgraph.plot>` returns a handle to the :class:`plot widget <pyqtgraph.PlotWidget>` that is created, allowing more data to be added to the same window.
+The example above would open a window displaying a line plot of the data given. The call to :func:`pg.plot <pyqtgraph.plot>` returns a handle to the :class:`plot widget <pyqtgraph.PlotWidget>` that is created, allowing more data to be added to the same window. **Note:** interactive plotting from the python prompt is only available with PyQt; PySide does not run the Qt event loop while the interactive prompt is running. If you wish to use pyqtgraph interactively with PySide, see the 'console' :ref:`example <examples>`.
 
 Further examples::
     

doc/source/qtcrashcourse.rst

@@ -66,6 +66,12 @@ Signals, Slots, and Events
 
 [ to be continued.. please post a request on the pyqtgraph forum if you'd like to read more ]
 
+Qt detects and reacts to user interaction by executing its *event loop*. 
+
+ - what happens in the event loop?
+ - when do I need to use QApplication.exec_() ?
+ - what control do I have over event loop execution? (QApplication.processEvents)
+
 
 GraphicsView and GraphicsItems
 ------------------------------
@@ -79,8 +85,8 @@ Mouse and Keyboard Input
 ------------------------
 
 
-QTimer, the Event Loop, and Multi-Threading
--------------------------------------------
+QTimer, Multi-Threading
+-----------------------
 
 
 Multi-threading vs Multi-processing in Qt

examples/Arrow.py

@@ -1,11 +1,12 @@
 # -*- coding: utf-8 -*-
+"""
+Display an animated arrowhead following a curve.
+This example uses the CurveArrow class, which is a combination
+of ArrowItem and CurvePoint. 
 
-## Display an animated arrowhead following a curve.
-## This example uses the CurveArrow class, which is a combination
-## of ArrowItem and CurvePoint. 
-##
-## To place a static arrow anywhere in a scene, use ArrowItem.
-## To attach other types of item to a curve, use CurvePoint.
+To place a static arrow anywhere in a scene, use ArrowItem.
+To attach other types of item to a curve, use CurvePoint.
+"""
 
 import initExample ## Add path to library (just for examples; you do not need this)
 
@@ -21,6 +22,7 @@
 w.show()
 w.resize(400,600)
 w.setCentralWidget(cw)
+w.setWindowTitle('pyqtgraph example: Arrow')
 
 p = cw.addPlot(row=0, col=0)
 p2 = cw.addPlot(row=1, col=0)

examples/CLIexample.py

@@ -1,21 +1,26 @@
+"""
+Display a plot and an image with minimal setup. 
+
+pg.plot() and pg.image() are indended to be used from an interactive prompt
+to allow easy data inspection (but note that PySide unfortunately does not
+call the Qt event loop while the interactive prompt is running, in this case
+it is necessary to call QApplication.exec_() to make the windows appear).
+"""
 import initExample ## Add path to library (just for examples; you do not need this)
 
-from pyqtgraph.Qt import QtGui, QtCore
+
 import numpy as np
 import pyqtgraph as pg
 
-app = QtGui.QApplication([])
-
-
 data = np.random.normal(size=1000)
 pg.plot(data, title="Simplest possible plotting example")
 
 data = np.random.normal(size=(500,500))
-pg.show(data, title="Simplest possible image example")
+pg.image(data, title="Simplest possible image example")
 
 
 ## Start Qt event loop unless running in interactive mode or using pyside.
 if __name__ == '__main__':
     import sys
     if sys.flags.interactive != 1 or not hasattr(QtCore, 'PYQT_VERSION'):
-        app.exec_()
+        pg.QtGui.QApplication.exec_()

examples/ColorButton.py

@@ -1,11 +1,12 @@
 # -*- coding: utf-8 -*-
-import initExample ## Add path to library (just for examples; you do not need this)
-
 """
 Simple example demonstrating a button which displays a colored rectangle
 and allows the user to select a new color by clicking on the button.
 """
 
+import initExample ## Add path to library (just for examples; you do not need this)
+
+
 import pyqtgraph as pg
 from pyqtgraph.Qt import QtCore, QtGui
 import numpy as np
@@ -15,6 +16,7 @@
 btn = pg.ColorButton()
 win.setCentralWidget(btn)
 win.show()
+win.setWindowTitle('pyqtgraph example: ColorButton')
 
 def change(btn):
     print("change", btn.color())

examples/ConsoleWidget.py

@@ -1,4 +1,10 @@
 # -*- coding: utf-8 -*-
+"""
+ConsoleWidget is used to allow execution of user-supplied python commands
+in an application. It also includes a command history and functionality for trapping
+and inspecting stack traces.
+
+"""
 import initExample ## Add path to library (just for examples; you do not need this)
 
 import pyqtgraph as pg
@@ -21,6 +27,7 @@
 """
 c = pyqtgraph.console.ConsoleWidget(namespace=namespace, text=text)
 c.show()
+c.setWindowTitle('pyqtgraph example: ConsoleWidget')
 
 ## Start Qt event loop unless running in interactive mode or using pyside.
 if __name__ == '__main__':

examples/DataSlicing.py

@@ -1,4 +1,12 @@
 # -*- coding: utf-8 -*-
+"""
+Demonstrate a simple data-slicing task: given 3D data (displayed at top), select 
+a 2D plane and interpolate data along that plane to generate a slice image 
+(displayed at bottom). 
+
+
+"""
+
 ## Add path to library (just for examples; you do not need this)
 import initExample
 
@@ -12,6 +20,7 @@
 ## Create window with two ImageView widgets
 win = QtGui.QMainWindow()
 win.resize(800,800)
+win.setWindowTitle('pyqtgraph example: DataSlicing')
 cw = QtGui.QWidget()
 win.setCentralWidget(cw)
 l = QtGui.QGridLayout()

examples/DataTreeWidget.py

@@ -4,8 +4,6 @@
 Simple use of DataTreeWidget to display a structure of nested dicts, lists, and arrays
 """
 
-
-
 import initExample ## Add path to library (just for examples; you do not need this)
 
 import pyqtgraph as pg
@@ -26,6 +24,7 @@
 
 tree = pg.DataTreeWidget(data=d)
 tree.show()
+tree.setWindowTitle('pyqtgraph example: DataTreeWidget')
 tree.resize(600,600)
 
 

examples/Draw.py

@@ -1,4 +1,10 @@
 # -*- coding: utf-8 -*-
+"""
+Demonstrate ability of ImageItem to be used as a canvas for painting with
+the mouse.
+
+"""
+
 import initExample ## Add path to library (just for examples; you do not need this)
 
 
@@ -12,6 +18,7 @@
 w = pg.GraphicsView()
 w.show()
 w.resize(800,800)
+w.setWindowTitle('pyqtgraph example: Draw')
 
 view = pg.ViewBox()
 w.setCentralItem(view)

examples/ErrorBarItem.py

@@ -21,6 +21,7 @@
 bottom = np.linspace(2, 0.5, 10)
 
 plt = pg.plot()
+plt.setWindowTitle('pyqtgraph example: ErrorBarItem')
 err = pg.ErrorBarItem(x=x, y=y, top=top, bottom=bottom, beam=0.5)
 plt.addItem(err)
 plt.plot(x, y, symbol='o', pen={'color': 0.8, 'width': 2})