sigima 1.0.4__tar.gz → 1.1.0__tar.gz

sigima-1.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+graft doc
+graft sigima/locale
+include CONTRIBUTING.md
+include requirements.txt

{sigima-1.0.4/sigima.egg-info → sigima-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sigima
-Version: 1.0.4
+Version: 1.1.0
 Summary: Scientific computing engine for 1D signals and 2D images, part of the DataLab open-source platform.
 Author-email: Pierre Raybaut <p.raybaut@codra.fr>
 Maintainer-email: DataLab Platform Developers <p.raybaut@codra.fr>
@@ -59,11 +59,11 @@ Requires-Python: <4,>=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: guidata>=3.13
-Requires-Dist: NumPy>=1.22
-Requires-Dist: SciPy>=1.10.1
-Requires-Dist: scikit-image>=0.19.2
-Requires-Dist: pandas>=1.4
-Requires-Dist: PyWavelets>=1.2
+Requires-Dist: NumPy<2.5,>=1.22
+Requires-Dist: SciPy<1.17,>=1.10.1
+Requires-Dist: scikit-image<0.27,>=0.19.2
+Requires-Dist: pandas<3.0,>=1.4
+Requires-Dist: PyWavelets<2.0,>=1.2
 Requires-Dist: packaging>=21.3
 Requires-Dist: typing-extensions>=4.0
 Requires-Dist: makefun>=1.13.1
@@ -81,12 +81,14 @@ Requires-Dist: sphinx; extra == "doc"
 Requires-Dist: sphinx-gallery; extra == "doc"
 Requires-Dist: sphinx_intl; extra == "doc"
 Requires-Dist: myst_parser; extra == "doc"
+Requires-Dist: myst-nb; extra == "doc"
 Requires-Dist: sphinx_design; extra == "doc"
 Requires-Dist: sphinx-copybutton; extra == "doc"
 Requires-Dist: pydata-sphinx-theme; extra == "doc"
 Requires-Dist: qtpy; extra == "doc"
 Requires-Dist: PyQt5; extra == "doc"
 Requires-Dist: plotpy; extra == "doc"
+Requires-Dist: matplotlib; extra == "doc"
 Requires-Dist: opencv-python-headless>=4.8.1.78; extra == "doc"
 Provides-Extra: test
 Requires-Dist: pytest; extra == "test"

{sigima-1.0.4 → sigima-1.1.0}/doc/api/index.rst

@@ -30,6 +30,9 @@ The public Application Programming Interface (API) of Sigima offers a set of fun
     * - :mod:`sigima.client`
       - Client interface for connecting to DataLab application through XML-RPC protocol, providing remote control capabilities for signal and image processing workflows.
 
+    * - :mod:`sigima.viz`
+      - Visualization tools for interactive display of signal and image objects, supporting PlotPy and Matplotlib backends for testing, debugging, and Jupyter notebook analysis.
+
 
 .. toctree::
    :maxdepth: 2
@@ -41,3 +44,4 @@ The public Application Programming Interface (API) of Sigima offers a set of fun
    proc
    config
    client
+   viz

sigima-1.1.0/doc/api/viz.rst

@@ -0,0 +1,166 @@
+.. _api_viz:
+
+:mod:`sigima.viz` --- Visualization Tools
+=========================================
+
+.. module:: sigima.viz
+
+This module provides visualization utilities for Sigima objects, useful for:
+
+- Interactive testing and debugging
+- Data analysis in Jupyter notebooks
+- Quick visual inspection of processing results
+
+Backend Selection
+-----------------
+
+The module automatically selects between **PlotPy** and **Matplotlib** backends based on availability and configuration settings.
+
+The backend selection follows this priority:
+
+1. Environment variable ``SIGIMA_VIZ_BACKEND`` (if set)
+2. Configuration option :attr:`sigima.config.options.viz_backend`
+3. Auto-detection (PlotPy preferred, Matplotlib as fallback)
+
+Backend selection logic:
+
+- ``"auto"``: Try PlotPy first, fall back to Matplotlib
+- ``"plotpy"``: Use PlotPy (raise :class:`ImportError` if not available)
+- ``"matplotlib"``: Use Matplotlib (raise :class:`ImportError` if not available)
+
+.. rubric:: Configuring the Backend
+
+Using environment variable:
+
+.. code-block:: python
+
+    import os
+    os.environ["SIGIMA_VIZ_BACKEND"] = "matplotlib"  # Before importing sigima.viz
+
+    from sigima import viz
+    # Now uses Matplotlib backend
+
+Using configuration option:
+
+.. code-block:: python
+
+    from sigima.config import options
+    options.viz_backend.set("plotpy")
+
+    from sigima import viz
+    # Now uses PlotPy backend
+
+Module Attributes
+-----------------
+
+.. py:data:: BACKEND_NAME
+   :type: str
+
+   Name of the currently selected backend: ``"plotpy"`` or ``"matplotlib"``.
+
+.. py:data:: BACKEND_SOURCE
+   :type: str
+
+   How the backend was selected: ``"env"``, ``"config"``, or ``"auto"``.
+
+Quick Start
+-----------
+
+.. code-block:: python
+
+    from sigima import viz
+    import sigima.proc.signal as sips
+    from sigima.tests.data import get_test_signal
+
+    # Load a test signal
+    signal = get_test_signal("paracetamol.txt")
+
+    # Apply some processing
+    filtered = sips.moving_average(signal, n=10)
+
+    # View the results
+    viz.view_curves([signal, filtered], title="Signal Processing")
+
+Viewing Functions
+-----------------
+
+These functions display Sigima objects (:class:`~sigima.objects.SignalObj` and :class:`~sigima.objects.ImageObj`) in interactive dialogs or plots.
+
+.. autofunction:: view_curves
+
+.. autofunction:: view_images
+
+.. autofunction:: view_images_side_by_side
+
+.. autofunction:: view_curves_and_images
+
+Low-Level Viewing Functions
+---------------------------
+
+These functions display plot items (curves, images) rather than Sigima objects.
+
+.. autofunction:: view_curve_items
+
+.. autofunction:: view_image_items
+
+Creation Functions
+------------------
+
+These functions create plot items that can be passed to the low-level viewing functions.
+
+Curve and Image Items
+~~~~~~~~~~~~~~~~~~~~~
+
+.. autofunction:: create_curve
+
+.. autofunction:: create_image
+
+Annotation Items
+~~~~~~~~~~~~~~~~
+
+.. autofunction:: create_contour_shapes
+
+.. autofunction:: create_circle
+
+.. autofunction:: create_segment
+
+.. autofunction:: create_cursor
+
+.. autofunction:: create_range
+
+.. autofunction:: create_label
+
+.. autofunction:: create_marker
+
+Backend Differences
+-------------------
+
+The two backends have different capabilities:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 40 30 30
+
+   * - Feature
+     - PlotPy
+     - Matplotlib
+   * - Interactive zoom/pan
+     - ✅ Full Qt tools
+     - ✅ Basic toolbar
+   * - ROI display
+     - ✅ Native support
+     - ✅ Patches overlay
+   * - Geometry results
+     - ✅ Shape annotations
+     - ✅ Markers/lines
+   * - Linked axes
+     - ✅ Native
+     - ✅ via ``sharex``/``sharey``
+   * - Qt integration
+     - ✅ Native
+     - ⚠️ Requires Qt backend
+   * - Headless/CI
+     - ⚠️ Needs display
+     - ✅ ``Agg`` backend
+
+For automated testing and CI environments, Matplotlib with the ``Agg`` backend is recommended. For interactive data exploration, PlotPy provides a richer experience.

{sigima-1.0.4 → sigima-1.1.0}/doc/conf.py

@@ -108,16 +108,25 @@ extensions = [
     "sphinx.ext.mathjax",
     "sphinx.ext.githubpages",
     "sphinx.ext.viewcode",
-    "myst_parser",
+    "myst_nb",  # Replaces myst_parser and adds notebook support
     "sphinx_design",
     "sphinx_copybutton",
     "guidata.dataset.autodoc",
     "sphinx_gallery.gen_gallery",
 ]
+
+# MyST-NB configuration
+nb_execution_mode = "off"  # Don't re-execute notebooks during build
+nb_execution_timeout = 180  # Timeout for notebook execution (if enabled)
+
 templates_path = ["_templates"]
 exclude_patterns = [
     "sg_execution_times.rst",
     "**/sg_execution_times.rst",
+    # exclude .py and .ipynb files in auto_examples generated by sphinx-gallery
+    # this is to prevent sphinx from complaining about duplicate source files
+    "auto_examples/**/*.ipynb",
+    "auto_examples/**/*.py",
 ]
 
 # Suppress the warning about unpicklable sphinx_gallery_conf

{sigima-1.0.4 → sigima-1.1.0}/doc/examples/README.txt

@@ -3,8 +3,8 @@ Examples
 
 This section presents a collection of examples demonstrating the capabilities of Sigima.
 Each example is a standalone Python script that showcases specific features or use cases
-of the Sigima library, along with visualizations of the results (using an internal
-plotting module `sigima.tests.vistools` based on `PlotPyStack <https://github.com/PlotPyStack>`_).
+of the Sigima library, along with visualizations of the results (using the
+`sigima.viz` module with the `PlotPyStack <https://github.com/PlotPyStack>`_ backend).
 
 Of course, some of these examples may seem trivial, but they serve to illustrate how to use
 various functionalities of Sigima in a clear and concise manner.

{sigima-1.0.4 → sigima-1.1.0}/doc/examples/features/convolution.py

@@ -33,7 +33,7 @@ import scipy.signal
 import sigima.objects
 import sigima.params
 import sigima.proc.image
-from sigima.tests import vistools
+from sigima import viz
 
 # %%
 # Creating test images and kernels
@@ -70,7 +70,7 @@ print(f"Gaussian kernel shape: {gaussian_kernel.data.shape}")
 print(f"Identity kernel shape: {identity_kernel.data.shape}")
 
 # Display the original image and kernels
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [original_image, gaussian_kernel, identity_kernel],
     ["Original Image", "Gaussian Kernel (σ=2.0)", "Identity Kernel"],
     title="Test Images and Kernels",
@@ -95,7 +95,7 @@ max_diff = np.max(np.abs(convolved_gauss.data - expected_result))
 print(f"Max difference from scipy: {max_diff:.2e}")
 
 # Visualize the convolution process
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [original_image, gaussian_kernel, convolved_gauss],
     ["Original Image", "Gaussian Kernel (σ=2.0)", "Convolved Result"],
     title="Gaussian Convolution Example",
@@ -117,7 +117,7 @@ print("\n✓ Identity convolution completed!")
 print(f"Max difference from original: {difference:.2e}")
 
 # Visualize the identity convolution
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [original_image, identity_kernel, convolved_identity],
     ["Original Image", "Identity Kernel", "Convolved with Identity"],
     "Identity Convolution Example",
@@ -141,7 +141,7 @@ print("\n✓ Identity deconvolution completed!")
 print(f"Recovery error: {recovery_error:.2e}")
 
 # Visualize the deconvolution process
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [original_image, convolved_identity, deconvolved_identity],
     ["Original", "Convolved", "Deconvolved"],
     title="Identity Deconvolution Example",
@@ -175,7 +175,7 @@ print(f"Original image range: [{orig_min:.3f}, {orig_max:.3f}]")
 print(f"Deconvolved image range: [{deconv_min:.3f}, {deconv_max:.3f}]")
 
 # Visualize the full deconvolution process
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [original_image, deconv_gaussian, large_convolved, large_deconvolved],
     ["Original", "Gaussian Kernel", "Convolved", "Deconvolved"],
     title="Gaussian Deconvolution Example",
@@ -209,14 +209,14 @@ conv_large = sigima.proc.image.convolution(original_image, large_sigma)
 print("\n✓ Multiple kernel comparison completed!")
 
 # Show the effect of different sigma values on kernels
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [small_sigma, medium_sigma, large_sigma],
     ["Kernel σ=0.8", "Kernel σ=2.0", "Kernel σ=4.0"],
     title="Gaussian Kernels with Different Sigma Values",
 )
 
 # Show the effect of different sigma values on convolution results
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [conv_small, conv_medium, conv_large],
     ["Convolved σ=0.8", "Convolved σ=2.0", "Convolved σ=4.0"],
     title="Convolution Results with Different Sigma Values",
@@ -246,14 +246,14 @@ sharpen_result.title = "Sharpened"
 print("\n✓ Custom kernel convolutions completed!")
 
 # Visualize custom kernels
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [edge_kernel, sharpen_kernel],
     ["Edge Detection Kernel", "Sharpening Kernel"],
     title="Custom Convolution Kernels",
 )
 
 # Visualize custom kernel results
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [original_image, edge_result, sharpen_result],
     ["Original", "Edge Detection", "Sharpened"],
     title="Custom Kernel Convolution Results",
@@ -281,7 +281,7 @@ print("• Deconvolution can recover original features (with limitations)")
 print("• Custom kernels enable specialized image processing effects")
 
 # Final comparison showing the complete pipeline
-dialog10 = vistools.view_images_side_by_side(
+dialog10 = viz.view_images_side_by_side(
     [original_image, gaussian_kernel, convolved_gauss, large_deconvolved],
     ["Original", "Gaussian Kernel", "Convolved", "Deconvolved"],
     title="Complete Convolution-Deconvolution Pipeline",

{sigima-1.0.4 → sigima-1.1.0}/doc/examples/features/coordinate_systems.py

@@ -29,7 +29,7 @@ that allow you to explore the coordinate system effects in detail.
 import numpy as np
 
 from sigima.objects import create_image
-from sigima.tests.vistools import view_images_side_by_side
+from sigima.viz import view_images_side_by_side
 
 # %%
 # Creating test images with uniform coordinates

{sigima-1.0.4 → sigima-1.1.0}/doc/examples/features/datetime_signals.py

@@ -33,7 +33,7 @@ import numpy as np
 from sigima.io.signal.formats import CSVSignalFormat
 from sigima.objects import SignalObj, create_signal
 from sigima.objects.signal.constants import TIME_UNIT_FACTORS, VALID_TIME_UNITS
-from sigima.tests.vistools import view_curves
+from sigima.viz import view_curves
 
 # %%
 # Creating datetime signals from datetime objects

{sigima-1.0.4 → sigima-1.1.0}/doc/examples/features/roi_grid.py

@@ -30,6 +30,7 @@ that allow you to explore the ROI grid placement in detail.
 
 from copy import deepcopy
 
+from sigima import viz
 from sigima.io import read_image
 from sigima.objects import RectangularROI
 from sigima.proc.image.extraction import (
@@ -38,7 +39,7 @@ from sigima.proc.image.extraction import (
     extract_roi,
     generate_image_grid_roi,
 )
-from sigima.tests import helpers, vistools
+from sigima.tests import helpers
 
 # %%
 # Loading a real laser spot array image
@@ -83,7 +84,7 @@ print(
 )
 
 # Display both images
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [full_image, laser_image],
     ["Full 6×6 Array", "Extracted 2×2 Sub-region"],
     title="Extracting a Sub-region for Analysis",
@@ -118,7 +119,7 @@ print(f"\n✓ Generated {len(list(roi_grid))} rectangular ROIs!")
 print("ROI titles:", [r.title for r in list(roi_grid)])
 
 # Display image with ROI overlay
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [laser_image, image_with_roi],
     ["2×2 Spot Array", "With ROI Grid"],
     title="Basic ROI Grid (2×2, Centered)",
@@ -145,7 +146,7 @@ for spot in extracted_spots:
     print(f"  - {spot.title}: {spot.width}×{spot.height} pixels")
 
 # Display extracted spots
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     extracted_spots,
     [spot.title for spot in extracted_spots],
     title="Extracted Individual Spots",
@@ -190,7 +191,7 @@ print("  - Small ROIs: 40% of cell size")
 print("  - Shifted ROIs: offset by 10% in X and Y")
 
 # Display the different configurations
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [image_with_roi, image_large, image_small, image_shifted],
     ["Default (75%)", "Large (90%)", "Small (40%)", "Shifted (+10%)"],
     title="ROI Size and Position Variations",
@@ -227,7 +228,7 @@ print("Increasing direction (first 4 ROIs):", [r.title for r in list(roi_inc)[:4
 print("Decreasing direction (first 4 ROIs):", [r.title for r in list(roi_dec)[:4]])
 
 # Display direction variations
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [image_inc, image_dec],
     ["Increasing Direction", "Decreasing Direction"],
     title="ROI Direction Labels",

{sigima-1.0.4 → sigima-1.1.0}/doc/examples/features/zero_padding.py

@@ -25,8 +25,8 @@ import numpy as np
 
 import sigima.params
 import sigima.proc.signal as sips
+from sigima import viz
 from sigima.objects import create_signal
-from sigima.tests import vistools
 
 # %%
 # Create a test signal
@@ -49,7 +49,7 @@ signal = create_signal(
 
 print(f"Original signal: {n_points} points")
 
-vistools.view_curves(signal, title="Original Signal")
+viz.view_curves(signal, title="Original Signal")
 
 # %%
 # Zero-padding with "next_pow2" strategy
@@ -91,7 +91,7 @@ print(f"Padded signal: {padded_size} points (power of 2: {power_of_2})")
 # -----------------------------------
 # The padded signal has zeros appended at the end.
 
-vistools.view_curves([signal, padded_signal], title="Original vs Zero-Padded Signal")
+viz.view_curves([signal, padded_signal], title="Original vs Zero-Padded Signal")
 
 # %%
 # FFT comparison: improved frequency resolution
@@ -110,7 +110,7 @@ fft_padded.title = f"FFT Zero-Padded ({fft_padded.y.size} bins)"
 print(f"Original FFT: {fft_original.y.size} frequency bins")
 print(f"Padded FFT: {fft_padded.y.size} frequency bins")
 
-vistools.view_curves([fft_original, fft_padded], title="FFT: Original vs Zero-Padded")
+viz.view_curves([fft_original, fft_padded], title="FFT: Original vs Zero-Padded")
 
 # %%
 # Using different strategies
@@ -160,4 +160,4 @@ for location in PadLocation1D:
     results.append(result)
     print(f"Location '{location.value}': x=[{result.x[0]:.4f}, {result.x[-1]:.4f}]")
 
-vistools.view_curves(results, title="Padding Location Comparison")
+viz.view_curves(results, title="Padding Location Comparison")

{sigima-1.0.4 → sigima-1.1.0}/doc/examples/getting_started/image_creation.py

@@ -16,7 +16,7 @@ There are three primary methods to create images in Sigima:
 Each method has its use cases, and Sigima provides a consistent interface for working
 with data regardless of its origin.
 
-For visualization, we use helper functions from the ``sigima.tests.vistools`` module.
+For visualization, we use helper functions from the ``sigima.viz`` module.
 This allows us to focus on Sigima's functionality rather than visualization details.
 """
 
@@ -28,7 +28,8 @@ This allows us to focus on Sigima's functionality rather than visualization deta
 import numpy as np
 
 import sigima
-from sigima.tests import helpers, vistools
+from sigima import viz
+from sigima.tests import helpers
 
 # %%
 # Method 1: Creating images from synthetic parameters
@@ -87,7 +88,7 @@ print(f"  - {gaussian_img.title}: {gaussian_img.data.shape}")
 print(f"  - {ramp_img.title}: {ramp_img.data.shape}")
 
 # Visualize synthetic images
-vistools.view_images_side_by_side([gaussian_img, ramp_img], title="Synthetic Images")
+viz.view_images_side_by_side([gaussian_img, ramp_img], title="Synthetic Images")
 
 # %%
 # Method 2: Loading images from files
@@ -117,7 +118,7 @@ print(f"  - {img_jpeg.title}: {img_jpeg.data.shape}")
 print(f"  - {img_npy.title}: {img_npy.data.shape}")
 
 # Visualize images loaded from files
-vistools.view_images_side_by_side([img_jpeg, img_npy], title="Images from Files")
+viz.view_images_side_by_side([img_jpeg, img_npy], title="Images from Files")
 
 # %%
 # Method 3: Creating images from NumPy arrays
@@ -161,7 +162,7 @@ print(f"  - {img_interf.title}: {img_interf.data.shape}")
 print(f"  - {img_radial.title}: {img_radial.data.shape}")
 
 # Visualize images created from NumPy arrays
-vistools.view_images_side_by_side([img_interf, img_radial], title="Images from Arrays")
+viz.view_images_side_by_side([img_interf, img_radial], title="Images from Arrays")
 
 # %%
 # Summary

{sigima-1.0.4 → sigima-1.1.0}/doc/examples/getting_started/signal_creation.py

@@ -16,7 +16,7 @@ There are three primary methods to create signals in Sigima:
 Each method has its use cases, and Sigima provides a consistent interface for working
 with data regardless of its origin.
 
-For visualization, we use helper functions from the ``sigima.tests.vistools`` module.
+For visualization, we use helper functions from the ``sigima.viz`` module.
 This allows us to focus on Sigima's functionality rather than visualization details.
 """
 
@@ -30,7 +30,8 @@ from pprint import pprint  # For pretty-printing metadata
 import numpy as np
 
 import sigima
-from sigima.tests import helpers, vistools
+from sigima import viz
+from sigima.tests import helpers
 
 # %%
 # Method 1: Creating signals from synthetic parameters
@@ -90,7 +91,7 @@ print(f"  - {signal_synthetic.title}: {signal_synthetic.y.shape[0]} points")
 print(f"  - {signal_lorentzian.title}: {signal_lorentzian.y.shape[0]} points")
 
 # Visualize synthetic signals
-vistools.view_curves(
+viz.view_curves(
     [signal_synthetic, signal_lorentzian], title="Method 1: Synthetic Signals"
 )
 
@@ -113,7 +114,7 @@ filename = helpers.get_test_fnames("paracetamol.txt")[0]
 signal_from_file = sigima.read_signal(filename)
 
 # Visualize signal loaded from text file
-vistools.view_curves(signal_from_file, title="Signal from Text File")
+viz.view_curves(signal_from_file, title="Signal from Text File")
 
 # Load another signal from a CSV file with multiple curves
 csv_file = helpers.get_test_fnames("oscilloscope.csv")[0]
@@ -122,7 +123,7 @@ signals_from_csv = sigima.read_signals(csv_file)
 signal_from_csv = signals_from_csv[1]
 
 # Visualize signal loaded from csv file
-vistools.view_curves(signal_from_csv, title="Signal from CSV File")
+viz.view_curves(signal_from_csv, title="Signal from CSV File")
 
 print("\n✓ Signals loaded from files")
 print(f"  - {signal_from_file.title}: {signal_from_file.y.shape[0]} points")
@@ -185,7 +186,7 @@ print(f"  - {signal_from_array.title}: {signal_from_array.y.shape[0]} points")
 print(f"  - {signal_envelope.title}: {signal_envelope.y.shape[0]} points")
 
 # Visualize signals created from NumPy arrays
-vistools.view_curves(
+viz.view_curves(
     [signal_from_array, signal_envelope],
     title="Method 3: Signals from NumPy Arrays",
     object_name="signals_from_arrays",

{sigima-1.0.4 → sigima-1.1.0}/doc/examples/use_cases/blob_detection.py

@@ -26,7 +26,7 @@ import skimage.draw
 
 import sigima.objects
 import sigima.proc.image
-from sigima.tests import vistools
+from sigima import viz
 
 # %%
 # Generate synthetic test image with known blobs
@@ -76,7 +76,7 @@ print("✓ Test image created successfully!")
 # to help reducing the impact of GUI code in documentation and let you concentrate in
 # the analysis
 
-vistools.view_images([original_image], title="Original Test Image with Synthetic Blobs")
+viz.view_images([original_image], title="Original Test Image with Synthetic Blobs")
 
 # %%
 # Image preprocessing - Binning
@@ -93,7 +93,7 @@ print(f"Binned size: {binned_image.data.shape}")
 print("Binning reduces computational load and can improve blob detection")
 
 # Compare original and binned images
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [original_image, binned_image],
     titles=["Original Image", "Binned Image (2x2)"],
     title="Image Binning Comparison",
@@ -114,7 +114,7 @@ filtered_image = sigima.proc.image.moving_median(binned_image, n=filter_size)
 print(f"\n✓ Moving median filter applied (window size: {filter_size})")
 
 # Show progression of preprocessing steps
-vistools.view_images_side_by_side(
+viz.view_images_side_by_side(
     [original_image, binned_image, filtered_image],
     titles=["Original", "Binned", "Median Filtered"],
     title="Image Preprocessing Pipeline",
@@ -180,7 +180,7 @@ blobs = sigima.proc.image.blob_opencv(filtered_image, blob_param)
 print("\n✓ Blob detection completed!")
 print(f"  Number of blobs detected: {len(blobs.coords) if blobs else 0}")
 
-vistools.view_images(
+viz.view_images(
     [filtered_image],
     title="Filtered Image with Blob Detection",
     results=blobs,