wxmplot 2026.2.2__tar.gz → 2026.2.3__tar.gz

{wxmplot-2026.2.2/wxmplot.egg-info → wxmplot-2026.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wxmplot
-Version: 2026.2.2
+Version: 2026.2.3
 Summary: wxPython plotting widgets using matplotlib
 Author-email: Matthew Newville <matt.newville@gmail.com>
 License-Expression: MIT
@@ -22,7 +22,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: wxPython>=4.2.3
@@ -46,6 +46,9 @@ Requires-Dist: Sphinx; extra == "doc"
 Requires-Dist: jupyter_sphinx; extra == "doc"
 Requires-Dist: sphinx-copybutton; extra == "doc"
 Requires-Dist: sphinxcontrib-video; extra == "doc"
+Requires-Dist: nbsphinx; extra == "doc"
+Requires-Dist: sphinx-design; extra == "doc"
+Requires-Dist: sphinx-breeze-theme; extra == "doc"
 Provides-Extra: test
 Requires-Dist: pytest; extra == "test"
 Requires-Dist: pytest-cov; extra == "test"

wxmplot-2026.2.3/examples/image_canvas_scroll.py

@@ -0,0 +1,123 @@
+import time, os, sys
+from random import shuffle
+
+import numpy as np
+
+import wx
+from wxutils import pack
+from wxmplot import ImageFrame
+from wxmplot.image_canvas import ImageCanvas
+
+
+class ImageCanvasFrame(wx.Frame):
+    def __init__(self, parent, title='WXMPLOT Image Canvas', size=(700,600)):
+        wx.Frame.__init__(self, None, title=title, size=size,
+                          style=wx.DEFAULT_FRAME_STYLE)
+
+        self.im_canvas = ImageCanvas(self)
+        sizer = wx.BoxSizer(wx.VERTICAL)
+        sizer.Add(self.im_canvas, 1, wx.ALL|wx.GROW)
+        pack(self, sizer)
+
+    def set_colormap(self, colormap: str):
+        self.im_canvas.set_colormap(colormap)
+
+    def set_image(self, image: np.ndarray):
+        self.im_canvas.set_image(image)
+        self.im_canvas.set_auto_scale(True, level=0.5)
+
+class TestFrame(wx.Frame):
+    def __init__(self, parent=None, *args,**kwds):
+        kwds["style"] = wx.DEFAULT_FRAME_STYLE|wx.RESIZE_BORDER|wx.TAB_TRAVERSAL
+
+        wx.Frame.__init__(self, parent, -1, '',
+                         wx.DefaultPosition, wx.Size(-1,-1), **kwds)
+        self.SetTitle(" WXMPlot Image Scroll")
+
+        self.SetFont(wx.Font(12,wx.SWISS,wx.NORMAL,wx.BOLD,False))
+        menu = wx.Menu()
+
+        self.arrays = []
+        self.imageframe  = None
+
+        framesizer = wx.BoxSizer(wx.VERTICAL)
+
+        panel      = wx.Panel(self, -1, size=(-1, -1))
+        panelsizer = wx.BoxSizer(wx.VERTICAL)
+
+        panelsizer.Add( wx.StaticText(panel, -1, 'Show Images'),
+                        0, wx.LEFT|wx.EXPAND, 10)
+
+        btn = wx.Button(panel, -1, 'start scrolling', size=(-1,-1))
+        btn.Bind(wx.EVT_BUTTON,self.onScrollImages)
+
+        btn2 = wx.Button(panel, -1, 'stop scrolling', size=(-1,-1))
+        btn2.Bind(wx.EVT_BUTTON,self.onStop)
+
+        self.msg = wx.StaticText(panel, label='000 images in 00.0000 seconds ',  size=(500, -1))
+
+        panelsizer.Add(btn, 0, wx.ALIGN_LEFT|wx.ALIGN_CENTER|wx.LEFT, 5)
+        panelsizer.Add(btn2, 0, wx.ALIGN_LEFT|wx.ALIGN_CENTER|wx.LEFT, 5)
+        panelsizer.Add(self.msg, 0, wx.ALIGN_LEFT|wx.ALIGN_CENTER|wx.LEFT, 5)
+
+        panel.SetSizer(panelsizer)
+        panelsizer.Fit(panel)
+
+        framesizer.Add(panel, 0, wx.EXPAND, 2)
+        self.SetSizer(framesizer)
+        framesizer.Fit(self)
+        self.create_data()
+        self.ShowImageCanvasFrame()
+        self.count    = 0
+        self.Bind(wx.EVT_TIMER, self.onTimer)
+        self.timer = wx.Timer(self)
+        self.Refresh()
+
+    def create_data(self):
+        nx = ny = 1001
+        print("Creating 240 images..")
+        for xoff in np.linspace(-2.5, 2.5, 20):
+            y, x = np.mgrid[-10+xoff:10+xoff:nx*1j, -10:10:nx*1j]
+            for xscale in (4.5, 5.0, 6.0):
+                for yscale in (0.8, 1.0, 1.1, 1.2):
+                    dat = np.sin(x*x/xscale + y*y/yscale)/(1 + (x+y)*(x+y))
+                    dat += np.random.normal(scale=0.12, size=(nx, ny))
+                    self.arrays.append(dat)
+        shuffle(self.arrays)
+        print("Built %d arrays, shape=%s" % (len(self.arrays), repr(dat.shape)))
+
+    def ShowImageCanvasFrame(self):
+        if self.imageframe is None:
+            self.imageframe = ImageCanvasFrame(self)
+        try:
+            self.imageframe.Show()
+        except RuntimeError:
+            self.imageframe = ImageCanvasframe(self)
+            self.imageframe.Show()
+
+        self.imageframe.set_image(self.arrays[0])
+        self.imageframe.set_colormap('bone')
+        self.imageframe.Raise()
+
+    def onTimer(self, event):
+        self.count += 1
+        message = " %d images in %.3f sec" % (self.count,
+                                              time.time()-self.t0)
+        self.msg.SetLabel(message)
+        wx.CallAfter(self.imageframe.set_image,
+                     self.arrays[self.count % len(self.arrays)])
+
+    def onScrollImages(self,event=None):
+        self.ShowImageCanvasFrame()
+        self.count = 0
+        self.t0 = time.time()
+        self.timer.Start(10)
+
+    def onStop(self,event=None):
+        self.timer.Stop()
+
+if __name__ == '__main__':
+    app = wx.App()
+    f = TestFrame(None,-1)
+    f.Show(True)
+    app.MainLoop()

{wxmplot-2026.2.2 → wxmplot-2026.2.3}/pyproject.toml

@@ -15,7 +15,7 @@ omit = ["tests/*"]
 [project]
 name = "wxmplot"
 dynamic = ["version"]
-requires-python = ">= 3.10"
+requires-python = ">= 3.11"
 description = "wxPython plotting widgets using matplotlib"
 readme = "README.md"
 authors = [
@@ -64,6 +64,8 @@ Tracker = "https://github.com/newville/wxmplot/issues"
 
 [project.optional-dependencies]
 dev = ["build", "twine"]
-doc = ["Sphinx", "jupyter_sphinx", "sphinx-copybutton", "sphinxcontrib-video"]
+doc = ["Sphinx", "jupyter_sphinx", "sphinx-copybutton", "sphinxcontrib-video",
+       "nbsphinx", "sphinx-design", "sphinx-breeze-theme"]
+
 test = ["pytest", "pytest-cov", "coverage"]
 all = ["wxmplot[dev, doc, test]"]

{wxmplot-2026.2.2 → wxmplot-2026.2.3}/wxmplot/__init__.py

@@ -8,10 +8,8 @@
    with from wx programs.  More importantly, the widgets created by wxmplot
    give the end user a flexible set of tools for interacting with their
    data and customizing the plots and displays.  wxmplot panels are more
-   interactive than typical displayss from matplotlib's pyplot module.
+   interactive than typical displays from matplotlib's pyplot module.
 
-   version: 0.9.56
-   last update: 2023-Jul-02
    License:  MIT
    Author:  Matthew Newville <newville@cars.uchicago.edu>
             Center for Advanced Radiation Sources,
@@ -47,5 +45,3 @@ from .image_canvas import ImageCanvas, BinMethod
 from .line_plot import LinePlot
 from .histogram import Histogram, compute_histogram_data
 
-if sys.platform.lower() == 'darwin':
-    wx.PyApp.IsDisplayAvailable = lambda _: True

{wxmplot-2026.2.2 → wxmplot-2026.2.3}/wxmplot/image_canvas.py

@@ -103,6 +103,7 @@ class ImageCanvas(wx.Panel):
         self._first_image = True
         self._auto_scale = True
         self._filter_gaps = False
+        self._percentile_level: "float | None" = None
         self._min_value = 0.0
         self._max_value = 255.0
         self._data_min = 0.0
@@ -168,7 +169,7 @@ class ImageCanvas(wx.Panel):
         self._pixel_info_text = scene.visuals.Text(
             text="",
             color=vispy_colour("green"),
-            font_size=6,
+            font_size=8,
             bold=True,
             anchor_x="left",
             anchor_y="top",
@@ -179,7 +180,7 @@ class ImageCanvas(wx.Panel):
         self._fps_text = scene.visuals.Text(
             text="",
             color=vispy_colour("green"),
-            font_size=6,
+            font_size=8,
             bold=True,
             anchor_x="left",
             anchor_y="top",
@@ -226,11 +227,23 @@ class ImageCanvas(wx.Panel):
         self._image_visual.clim = (self._norm_fwd(min_val), self._norm_fwd(max_val))
         self._canvas.update()
 
-    def set_auto_scale(self, enabled: bool, level: (None, float) = None) -> None:
+    def set_auto_scale(self, enabled: bool, level: "float | None" = None) -> None:
         """Enable or disable automatic contrast scaling."""
         self._auto_scale = enabled
         if enabled and self._raw_image is not None:
-            self._min_value, self._max_value = self._compute_auto_clim(self._raw_image, level=level)
+            effective_level = level if level is not None else self._percentile_level
+            self._min_value, self._max_value = self._compute_auto_clim(self._raw_image, level=effective_level)
+            self._image_visual.clim = (self._norm_fwd(self._min_value), self._norm_fwd(self._max_value))
+            self._canvas.update()
+
+    def set_percentile_level(self, level: "float | None") -> None:
+        """Set a persistent contrast clip applied on every frame regardless of auto-scale (None=off)."""
+        self._percentile_level = level
+        if self._raw_image is not None:
+            if level is not None:
+                self._min_value, self._max_value = self._compute_auto_clim(self._raw_image, level=level)
+            elif self._auto_scale:
+                self._min_value, self._max_value = self._compute_auto_clim(self._raw_image)
             self._image_visual.clim = (self._norm_fwd(self._min_value), self._norm_fwd(self._max_value))
             self._canvas.update()
 
@@ -386,7 +399,9 @@ class ImageCanvas(wx.Panel):
             gpu_image = np.ascontiguousarray(gpu_image)
 
         self._data_min, self._data_max = self._compute_full_range(full_res)
-        if self._auto_scale:
+        if self._percentile_level is not None:
+            self._min_value, self._max_value = self._compute_auto_clim(full_res, level=self._percentile_level)
+        elif self._auto_scale:
             self._min_value, self._max_value = self._compute_auto_clim(full_res)
 
         display_image = self._norm_apply(gpu_image)
@@ -413,7 +428,7 @@ class ImageCanvas(wx.Panel):
 
     def _compute_auto_clim(self, img: np.ndarray, level=None) -> tuple[float, float]:
         """Estimate display clim from a sampled subset of pixels.
-           Uses percentiles when filter_gaps is on."""
+           level: symmetric contrast_level — clips this % from each side (e.g. 2 → [2, 98])."""
         flat = img.reshape(-1)
         step = max(1, flat.size // self._AUTO_CLIM_SAMPLE_BUDGET)
         sample = flat[::step]
@@ -432,9 +447,8 @@ class ImageCanvas(wx.Panel):
         else:
             vmin, vmax = float(sample.min()), float(sample.max())
 
-        # alternative implementation
         if level is not None:
-            vmin, vmax = np.percentile(img, [level, 100.0-level])
+            vmin, vmax = np.percentile(img, [level, 100.0 - level])
 
         # Ensure min != max to avoid histogram handle overlap
         if vmax <= vmin:

{wxmplot-2026.2.2 → wxmplot-2026.2.3}/wxmplot/line_plot.py

@@ -528,7 +528,7 @@ class LinePlot(wx.Panel):
         gc.StrokeLine(ml, mt + ph, ml + pw, mt + ph)
         gc.StrokeLine(ml, mt, ml, mt + ph)
 
-        font_small = wx.Font(10, wx.FONTFAMILY_DEFAULT, wx.FONTSTYLE_NORMAL, wx.FONTWEIGHT_BOLD)
+        font_small = wx.Font(wx.Size(0, 10), wx.FONTFAMILY_DEFAULT, wx.FONTSTYLE_NORMAL, wx.FONTWEIGHT_BOLD)
         ranges = self._data_ranges()
 
         if ranges is None:
@@ -536,7 +536,7 @@ class LinePlot(wx.Panel):
             gc.SetPen(wx.TRANSPARENT_PEN)
             gc.DrawRectangle(ml, mt, pw, ph)
             gc.SetFont(
-                wx.Font(13, wx.FONTFAMILY_DEFAULT, wx.FONTSTYLE_NORMAL, wx.FONTWEIGHT_BOLD),
+                wx.Font(wx.Size(0, 13), wx.FONTFAMILY_DEFAULT, wx.FONTSTYLE_NORMAL, wx.FONTWEIGHT_BOLD),
                 empty_text,
             )
             msg = "No data"
@@ -586,7 +586,7 @@ class LinePlot(wx.Panel):
             gc.PopState()
 
         if self._hover_data_x is not None and self._hover_data_y is not None:
-            hover_font = wx.Font(10, wx.FONTFAMILY_DEFAULT, wx.FONTSTYLE_NORMAL, wx.FONTWEIGHT_BOLD)
+            hover_font = wx.Font(wx.Size(0, 8), wx.FONTFAMILY_DEFAULT, wx.FONTSTYLE_NORMAL, wx.FONTWEIGHT_BOLD)
             gc.SetFont(hover_font, get_theme().green)
             text = self.format_hover_info(self._hover_data_x, self._hover_data_y)
             tw, th = gc.GetTextExtent(text)

{wxmplot-2026.2.2 → wxmplot-2026.2.3}/wxmplot/version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '2026.2.2'
-__version_tuple__ = version_tuple = (2026, 2, 2)
+__version__ = version = '2026.2.3'
+__version_tuple__ = version_tuple = (2026, 2, 3)
 
-__commit_id__ = commit_id = 'gbb23702e8'
+__commit_id__ = commit_id = 'g514ae8af4'

{wxmplot-2026.2.2 → wxmplot-2026.2.3/wxmplot.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wxmplot
-Version: 2026.2.2
+Version: 2026.2.3
 Summary: wxPython plotting widgets using matplotlib
 Author-email: Matthew Newville <matt.newville@gmail.com>
 License-Expression: MIT
@@ -22,7 +22,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: wxPython>=4.2.3
@@ -46,6 +46,9 @@ Requires-Dist: Sphinx; extra == "doc"
 Requires-Dist: jupyter_sphinx; extra == "doc"
 Requires-Dist: sphinx-copybutton; extra == "doc"
 Requires-Dist: sphinxcontrib-video; extra == "doc"
+Requires-Dist: nbsphinx; extra == "doc"
+Requires-Dist: sphinx-design; extra == "doc"
+Requires-Dist: sphinx-breeze-theme; extra == "doc"
 Provides-Extra: test
 Requires-Dist: pytest; extra == "test"
 Requires-Dist: pytest-cov; extra == "test"

{wxmplot-2026.2.2 → wxmplot-2026.2.3}/wxmplot.egg-info/SOURCES.txt

@@ -20,6 +20,7 @@ examples/floatcontrol.py
 examples/histogram.py
 examples/image.py
 examples/image_canvas_ex.py
+examples/image_canvas_scroll.py
 examples/image_scroll.py
 examples/imagematrix.py
 examples/interactive_multiplewindows.py

{wxmplot-2026.2.2 → wxmplot-2026.2.3}/wxmplot.egg-info/requires.txt

@@ -26,6 +26,9 @@ Sphinx
 jupyter_sphinx
 sphinx-copybutton
 sphinxcontrib-video
+nbsphinx
+sphinx-design
+sphinx-breeze-theme
 
 [test]
 pytest

{wxmplot-2026.2.2 → wxmplot-2026.2.3}/wxmplot.egg-info/scm_file_list.json

@@ -92,6 +92,7 @@
     "examples/histogram.py",
     "examples/image.py",
     "examples/image_canvas_ex.py",
+    "examples/image_canvas_scroll.py",
     "examples/image_scroll.py",
     "examples/imagematrix.py",
     "examples/interactive_multiplewindows.py",

wxmplot-2026.2.3/wxmplot.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "2026.2.3",
+  "distance": 0,
+  "node": "g514ae8af45f85a5f69edaea0db68f16f66ead976",
+  "dirty": false,
+  "branch": "master",
+  "node_date": "2026-09-01"
+}

wxmplot-2026.2.2/wxmplot.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "2026.2.2",
-  "distance": 0,
-  "node": "gbb23702e8d55a50452dc722de6db921762942571",
-  "dirty": false,
-  "branch": "master",
-  "node_date": "2026-08-09"
-}