11 files changed, 149 insertions, 0 deletions
diff --git a/doc/source/modules/gui/plot/actions/control.rst b/doc/source/modules/gui/plot/actions/control.rst
new file mode 100644
index 0000000..b35986d
--- /dev/null
+++ b/doc/source/modules/gui/plot/actions/control.rst
@@ -0,0 +1,5 @@
+:mod:`silx.gui.plot.actions.control`
+````````````````````````````````````
+
+.. automodule:: silx.gui.plot.actions.control
+    :members:
diff --git a/doc/source/modules/gui/plot/actions/examples.rst b/doc/source/modules/gui/plot/actions/examples.rst
new file mode 100644
index 0000000..125e9c5
--- /dev/null
+++ b/doc/source/modules/gui/plot/actions/examples.rst
@@ -0,0 +1,93 @@
+.. currentmodule:: silx.gui
+
+Adding custom plot actions
+==========================
+
+A :class:`PlotWindow` defines a number of standard plot actions that can be executed
+by clicking on toolbar icons.
+
+Developers can design additional plot actions to be added as toolbar icons or as menu entries,
+to be added to a :class:`PlotWindow` or to design their own plot window based on
+:class:`PlotWidget`.
+
+This documentation pages provides examples on how to do this.
+
+Simple example: Shift a curve
+-----------------------------
+
+The following script is a simplistic example to show the basic required steps:
+
+ - create a new class inheriting from :class:`silx.gui.plot.actions.PlotAction`
+ - define basic parameters such as the icon, the tooltip...
+ - write a method that will be triggered by the action
+ - initialize the new plot action by passing a reference to a plot window
+ - add the action to a toolbar or a menu
+
+The method implemented in this action interacts with the plot in a basic way. It gets the active curve,
+then it creates a new data array based on the curve data, and finally it replaces the original curve
+with a new one using the modified data array.
+
+.. literalinclude:: ../../../../../../examples/shiftPlotAction.py
+   :lines: 36-
+
+.. |imgShiftAction0| image:: img/shiftAction0.png
+   :height: 300px
+   :align: middle
+
+.. |imgShiftAction3| image:: img/shiftAction3.png
+   :height: 300px
+   :align: middle
+
+.. list-table::
+   :widths: 1 2
+
+   * - |imgShiftAction0|
+     - Initial state
+   * - |imgShiftAction3|
+     - After triggering the action 3 times, the selected triangle shaped curve
+       is shifted up by 3 units
+
+Advanced example: Display amplitude spectrum
+--------------------------------------------
+
+This more advanced example shows additional ways of interacting with the plot, by changing
+labels, storing additional data array along with the curve data.
+
+This action is *checkable*, meaning that is has two states. When clicking the toolbar icon
+or the menu item, it remains in a *pushed* state until it is clicked again.
+
+In one state (*un-checked*), the original data is displayed. In the other state, the amplitude
+spectrum of the original signal is displayed. When the state is changed, the triggered action
+computes either the Fast Fourier Transform (FFT), or the reverse FFT.
+
+This example also illustrates how to store additional data, along with a curve.
+The FFT computation returns complex values, but we want to display real data, so we compute
+the amplitude spectrum. However, the inverse FFT requires  the complete FFT data as input.
+We are therefore required to store the complex array of FFT data as curve metadata,
+in order to be able to reverse the process when the action is unchecked.
+
+.. literalinclude:: ../../../../../../examples/fftPlotAction.py
+   :lines: 44-
+
+.. |imgFftAction0| image:: img/fftAction0.png
+   :height: 300px
+   :align: middle
+
+.. |imgFftAction1| image:: img/fftAction1.png
+   :height: 300px
+   :align: middle
+
+.. list-table::
+   :widths: 1 2
+
+   * - |imgFftAction0|
+     - Original signals (zoom applied). In red, a cosine wave at 7 Hz.
+       In black, a sum of sines with frequencies of 3, 20 and 42 Hz.
+       In green, a square wave with a fundamental frequency of 0.5 Hz
+       (wavelength of 2 seconds).
+   * - |imgFftAction1|
+     - Amplitude spectra (zoom applied), with peaks visible at
+       the expected frequencies of 3, 7, 20 and 42 Hz for the sine and cosine
+       signals. In green, we see the complete series of peaks related to the square wave,
+       with a fundamental frequency at 0.5 Hz and harmonic frequencies at every
+       odd multiple of the fundamental.
diff --git a/doc/source/modules/gui/plot/actions/fit.rst b/doc/source/modules/gui/plot/actions/fit.rst
new file mode 100644
index 0000000..8b06908
--- /dev/null
+++ b/doc/source/modules/gui/plot/actions/fit.rst
@@ -0,0 +1,5 @@
+:mod:`silx.gui.plot.actions.fit`
+````````````````````````````````
+
+.. automodule:: silx.gui.plot.actions.fit
+    :members:
diff --git a/doc/source/modules/gui/plot/actions/histogram.rst b/doc/source/modules/gui/plot/actions/histogram.rst
new file mode 100644
index 0000000..6a31236
--- /dev/null
+++ b/doc/source/modules/gui/plot/actions/histogram.rst
@@ -0,0 +1,5 @@
+:mod:`silx.gui.plot.actions.histogram`
+``````````````````````````````````````
+
+.. automodule:: silx.gui.plot.actions.histogram
+    :members:
diff --git a/doc/source/modules/gui/plot/actions/img/fftAction0.png b/doc/source/modules/gui/plot/actions/img/fftAction0.png
new file mode 100644
index 0000000..5bd8061
--- /dev/null
+++ b/doc/source/modules/gui/plot/actions/img/fftAction0.png
diff --git a/doc/source/modules/gui/plot/actions/img/fftAction1.png b/doc/source/modules/gui/plot/actions/img/fftAction1.png
new file mode 100644
index 0000000..e4b20d7
--- /dev/null
+++ b/doc/source/modules/gui/plot/actions/img/fftAction1.png
diff --git a/doc/source/modules/gui/plot/actions/img/shiftAction0.png b/doc/source/modules/gui/plot/actions/img/shiftAction0.png
new file mode 100644
index 0000000..2d5837a
--- /dev/null
+++ b/doc/source/modules/gui/plot/actions/img/shiftAction0.png
diff --git a/doc/source/modules/gui/plot/actions/img/shiftAction3.png b/doc/source/modules/gui/plot/actions/img/shiftAction3.png
new file mode 100644
index 0000000..a2187b8
--- /dev/null
+++ b/doc/source/modules/gui/plot/actions/img/shiftAction3.png
diff --git a/doc/source/modules/gui/plot/actions/index.rst b/doc/source/modules/gui/plot/actions/index.rst
new file mode 100644
index 0000000..f95b1f8
--- /dev/null
+++ b/doc/source/modules/gui/plot/actions/index.rst
@@ -0,0 +1,30 @@
+.. currentmodule:: silx.gui.plot
+
+:mod:`actions`: Actions for PlotWidget
+===========================================
+
+.. currentmodule:: silx.gui.plot.actions
+
+The :class:`PlotAction` is a base class used to define plot actions.
+
+Plot actions serve to add menu items or toolbar items that are associated with a method
+that can interact with the associated :class:`.PlotWidget`.
+
+For an introduction to creating custom plot actions, see :doc:`examples`.
+
+actions API
+-----------
+
+Actions are divided into the following sub-modules:
+
+
+.. toctree::
+   :maxdepth: 1
+
+   control.rst
+   medfilt.rst
+   fit.rst
+   histogram.rst
+   io.rst
+
+.. autoclass:: silx.gui.plot.actions.PlotAction
diff --git a/doc/source/modules/gui/plot/actions/io.rst b/doc/source/modules/gui/plot/actions/io.rst
new file mode 100644
index 0000000..98f1808
--- /dev/null
+++ b/doc/source/modules/gui/plot/actions/io.rst
@@ -0,0 +1,6 @@
+:mod:`silx.gui.plot.actions.io`
+```````````````````````````````
+
+.. automodule:: silx.gui.plot.actions.io
+    :members:
+
diff --git a/doc/source/modules/gui/plot/actions/medfilt.rst b/doc/source/modules/gui/plot/actions/medfilt.rst
new file mode 100644
index 0000000..25f5af1
--- /dev/null
+++ b/doc/source/modules/gui/plot/actions/medfilt.rst
@@ -0,0 +1,5 @@
+:mod:`silx.gui.plot.actions.medfilt`
+````````````````````````````````````
+
+.. automodule:: silx.gui.plot.actions.medfilt
+    :members: