Module plots

source code

Plotting facilities, based on Python's MPL library.

The Chart object is a facade which provides intuitive access to MPL's plotting objects. The following examples show a typical use of Chart:

1. Instantiation

   >>> chart = Chart()                     # a chart with a single plot    
   >>> chart = Chart(rows=2, columns=2)    # a chart with 2x2=4 plots

2. Accessing plots (equivalent to MPL's subplots)

   >>> chart.plots[0]                      # first plot (at row=0, column=0) 
   Plot (matplotlib.axes.AxesSubplot)    
   >>> chart.plots[0, 1]
   Plot (matplotlib.axes.AxesSubplot)      # plot at row=0, column=1

3. Plotting

   >>> chart.plots[0].hist(...)
   >>> chart.plots[0].set_title('T')

   >>> chart.plots[1].scatter(...)
   >>> chart.plots[1].set_xlabel('X')

4. Using the GUI

   >>> chart.show()
   >>> chart.hide()

5. Saving as image

   >>> chart.save(filename, format=chart.formats.PDF)

If using the GUI, do not forget to dispose the chart at the end:

>>> chart.dispose()

or simply use the chart in a context manager:

>>> with Chart() as chart:
        chart...