mpl-extensions · ianhi · Sep 28, 2021 · Sep 25, 2021 · Sep 28, 2021 · Sep 28, 2021
diff --git a/.gitignore b/.gitignore
@@ -153,3 +153,5 @@ cython_debug/
 
 ## vscode
 .vscode
+
+docs/examples
diff --git a/docs/Contributing.rst b/docs/Contributing.rst
@@ -25,7 +25,7 @@ Now clone your fork of the Git repository and make an editable (``-e``) install.
 
    git clone <your fork>
    cd mpl-point-clicker
-   pip install -e ".[dev]"
+   pip install -e ".[test, doc]"
 
 
 Working with Git

diff --git a/docs/examples/example.ipynb b/docs/examples/example.ipynb
diff --git a/docs/examples/example.py b/docs/examples/example.py
diff --git a/docs/examples/example.py.md5 b/docs/examples/example.py.md5
diff --git a/docs/examples/example.rst b/docs/examples/example.rst
diff --git a/docs/examples/example_codeobj.pickle b/docs/examples/example_codeobj.pickle
diff --git a/docs/examples/examples_jupyter.zip b/docs/examples/examples_jupyter.zip
diff --git a/docs/examples/examples_python.zip b/docs/examples/examples_python.zip
diff --git a/docs/examples/images/sphx_glr_example_001.png b/docs/examples/images/sphx_glr_example_001.png
diff --git a/docs/examples/images/thumb/sphx_glr_example_thumb.png b/docs/examples/images/thumb/sphx_glr_example_thumb.png
diff --git a/docs/examples/index.rst b/docs/examples/index.rst
diff --git a/docs/examples/sg_execution_times.rst b/docs/examples/sg_execution_times.rst
diff --git a/examples/callbacks.py b/examples/callbacks.py
@@ -0,0 +1,50 @@
+"""
+---------
+Callbacks
+---------
+
+Demonstration of how to set up callback functions.
+
+"""
+
+from typing import Tuple
+
+import matplotlib.pyplot as plt
+import numpy as np
+
+from mpl_point_clicker import clicker
+
+image = np.load("example_image.npy")
+
+fig, ax = plt.subplots()
+ax.imshow(image, cmap='gray')
+klicker = clicker(ax, ['cells', 'pdms', 'media'], markers=['o', 'x', '*'])
+
+
+def class_changed_cb(new_class: str):
+    print(f'The newly selected class is {new_class}')
+
+
+def point_added_cb(position: Tuple[float, float], klass: str):
+    x, y = position
+    print(f"New point of class {klass} added at {x=}, {y=}")
+
+
+def point_removed_cb(position: Tuple[float, float], klass: str, idx):
+    x, y = position
+
+    suffix = {1: 'st', 2: 'nd', 3: 'rd'}.get(idx, 'th')
+    print(
+        f"The {idx}{suffix} point of class {klass} with position {x=:.2f}, {y=:.2f}  was removed"
+    )
+
+
+klicker.on_class_changed(class_changed_cb)
+klicker.on_point_added(point_added_cb)
+klicker.on_point_removed(point_removed_cb)
+
+
+plt.show()
+
+
+print(klicker.get_positions())
diff --git a/examples/example.py b/examples/example.py
@@ -3,8 +3,7 @@
 Basic Usage
 -----------
 
-A short example showcasing how to use the library. The docstrings will be
-turns in REST by sphinx-gallery.
+A short example showcasing how to use the library.
 """
 
 import matplotlib.pyplot as plt
Original file line number	Diff line number	Diff line change
Expand Up		@@ -153,3 +153,5 @@ cython_debug/

		## vscode
		.vscode

		docs/examples