New Feature: Add various marker types including arrows, ellipses, rectangles, squares, polygons, texts, points, horizontal lines, and vertical lines for enhanced plotting capabilities

Author: CSSFrancis

Examples/Interactive/plot_interactive_fft.py

@@ -147,18 +147,18 @@ def _compute_fft(img_full, x0, y0, w, h):
 
 # ── Callbacks ─────────────────────────────────────────────────────────────────
 
-@v_real.on_change(wid)
+@wid.on_changed
 def _roi_dragging(event):
     """Fires on every drag frame — highlight rectangle while dragging."""
     # Cheaply pulse the widget colour to give live drag feedback.
     for w in v_real._state["overlay_widgets"]:
-        if w["id"] == wid:
+        if w["id"] == wid._id:
             w["color"] = "#ff9800"   # orange while dragging
             break
     v_real._push()
 
 
-@v_real.on_release(wid)
+@wid.on_release
 def _roi_released(event):
     """Fires once on mouse-up — recompute and push the full FFT."""
     x0 = event.data.get("x", roi_x0)
@@ -168,14 +168,14 @@ def _roi_released(event):
 
     # Restore widget colour to yellow
     for widget in v_real._state["overlay_widgets"]:
-        if widget["id"] == wid:
+        if widget["id"] == wid._id:
             widget["color"] = "#ffeb3b"
             break
 
     log_mag, freq_x, freq_y = _compute_fft(image, x0, y0, w, h)
 
     # Push updated FFT into the right panel
-    v_fft.update(log_mag, x_axis=freq_x, y_axis=freq_y, units="1/Å")
+    v_fft.update(log_mag, x_axis=freq_x, y_axis=freq_y, units="1/\u00c5")
 
 
 fig

Examples/Markers/plot_arrows.py

@@ -20,10 +20,10 @@
 tails = rng.uniform(15, 100, (8, 2))
 U     = rng.uniform(-18, 18, 8)
 V     = rng.uniform(-18, 18, 8)
-
 v.add_arrows(tails, U, V, name="flow",
              edgecolors="#76ff03", linewidths=2.0,
              label="flow vectors")
+
 fig
 
 # %%

Examples/Markers/plot_circles.py

@@ -1,27 +1,34 @@
 """
 Circles
 =======
+
 Mark circular features on a 2-D image with
 :meth:`~anyplotlib.figure_plots.Plot2D.add_circles`.
 Use ``markers["circles"]["name"].set(...)`` to update them live.
 """
 import numpy as np
 import anyplotlib as vw
+
 rng  = np.random.default_rng(0)
 data = rng.standard_normal((128, 128)).cumsum(0).cumsum(1)
 data = (data - data.min()) / (data.max() - data.min())
 xy   = np.linspace(0, 10, 128)
+
 fig, ax = vw.subplots(1, 1, figsize=(460, 460))
 v = ax.imshow(data, axes=[xy, xy], units="nm")
+
 centres = rng.uniform(15, 113, (8, 2))
 v.add_circles(centres, name="spots", radius=10,
               edgecolors="#ff1744", facecolors="#ff174433",
               labels=[f"#{i}" for i in range(8)])
+
 fig
+
 # %%
 # Live update
 # -----------
 # Call ``.set()`` on the marker group to push any change immediately.
+
 v.markers["circles"]["spots"].set(radius=16, edgecolors="#ffcc00",
                                   facecolors="#ffcc0033")
 fig

Examples/Markers/plot_ellipses.py

@@ -23,6 +23,7 @@
                name="grains",
                edgecolors="#ff9100", facecolors="#ff910033",
                label="grains", labels=["A", "B", "C"])
+
 fig
 
 # %%
@@ -34,4 +35,3 @@
                                     edgecolors="#69f0ae",
                                     facecolors="#69f0ae33")
 fig
-

Examples/Markers/plot_horizontal_lines.py

@@ -1,22 +1,29 @@
 """
 Horizontal Lines
 ================
-Draw read-only horizontal lines on a 1-D plot with
+
+Draw static horizontal threshold lines on a 1-D plot with
 :meth:`~anyplotlib.figure_plots.Plot1D.add_hlines`.
 Use ``markers["hlines"]["name"].set(...)`` to update them live.
 """
 import numpy as np
 import anyplotlib as vw
+
 x      = np.linspace(0, 4 * np.pi, 512)
 signal = np.sin(x)
+
 fig, ax = vw.subplots(1, 1, figsize=(560, 300))
 v = ax.plot(signal, axes=[x], units="rad")
+
 v.add_hlines([0.5, 0.0, -0.5], name="thresholds",
              color="#69f0ae", linewidths=1.5,
              label="thresholds", labels=["+0.5", "zero", "-0.5"])
+
 fig
+
 # %%
 # Live update
 # -----------
+
 v.markers["hlines"]["thresholds"].set(color="#ff1744", linewidths=2.0)
 fig

Examples/Markers/plot_line_segments.py

@@ -28,6 +28,7 @@
             edgecolors="#00e5ff", linewidths=1.5,
             label="frame",
             labels=["top", "right", "bottom", "left", "diagonal"])
+
 fig
 
 # %%

Examples/Markers/plot_points.py

@@ -1,25 +1,32 @@
 """
 Points
 ======
-Draw point markers on a 1-D plot with
+
+Mark specific (x, y) positions on a 1-D plot with
 :meth:`~anyplotlib.figure_plots.Plot1D.add_points`.
 Use ``markers["points"]["name"].set(...)`` to update them live.
 """
 import numpy as np
 import anyplotlib as vw
+
 x      = np.linspace(0, 4 * np.pi, 512)
 signal = np.sin(x)
+
 fig, ax = vw.subplots(1, 1, figsize=(560, 300))
 v = ax.plot(signal, axes=[x], units="rad")
+
 peak_x  = np.array([np.pi / 2, 5 * np.pi / 2, 9 * np.pi / 2])
 offsets = np.column_stack([peak_x, np.sin(peak_x)])
 v.add_points(offsets, name="peaks",
-             edgecolors="#ff1744", facecolors="#ff174433", sizes=8,
+             sizes=8, color="#ff1744", facecolors="#ff174433",
              label="peaks", labels=["P1", "P2", "P3"])
+
 fig
+
 # %%
 # Live update
 # -----------
-v.markers["points"]["peaks"].set(sizes=12, edgecolors="#ffcc00",
+
+v.markers["points"]["peaks"].set(sizes=12, color="#ffcc00",
                                  facecolors="#ffcc0033")
 fig

Examples/Markers/plot_polygons.py

@@ -21,11 +21,11 @@
 hexagon  = [[64.0 + 28 * np.cos(np.radians(60 * k)),
              95.0 + 28 * np.sin(np.radians(60 * k))]
             for k in range(6)]
-
 v.add_polygons([triangle, hexagon], name="shapes",
                edgecolors="#69f0ae", facecolors="#69f0ae22",
                linewidths=2.0,
                label="shapes", labels=["triangle", "hexagon"])
+
 fig
 
 # %%

Examples/Markers/plot_rectangles.py

@@ -1,25 +1,33 @@
 """
 Rectangles
 ==========
+
 Draw bounding boxes on a 2-D image with
 :meth:`~anyplotlib.figure_plots.Plot2D.add_rectangles`.
+Use ``markers["rectangles"]["name"].set(...)`` to update them live.
 """
 import numpy as np
 import anyplotlib as vw
+
 rng  = np.random.default_rng(1)
 data = rng.standard_normal((128, 128)).cumsum(0).cumsum(1)
 data = (data - data.min()) / (data.max() - data.min())
 xy   = np.linspace(0, 10, 128)
+
 fig, ax = vw.subplots(1, 1, figsize=(460, 460))
 v = ax.imshow(data, axes=[xy, xy], units="nm")
+
 centres = rng.uniform(20, 108, (5, 2))
 v.add_rectangles(centres, widths=22, heights=14, name="boxes",
                  edgecolors="#00e5ff", facecolors="#00e5ff22",
                  labels=[f"R{i}" for i in range(5)])
+
 fig
+
 # %%
 # Live update
 # -----------
+
 v.markers["rectangles"]["boxes"].set(widths=30, heights=20,
                                      edgecolors="#ff9100",
                                      facecolors="#ff910033")

Examples/Markers/plot_squares.py

@@ -24,6 +24,7 @@
               name="tiles",
               edgecolors="#00e5ff", facecolors="#00e5ff22",
               label="tiles", labels=[f"T{i}" for i in range(5)])
+
 fig
 
 # %%