celldetective 1.5.0b4__tar.gz → 1.5.0b6__tar.gz

{celldetective-1.5.0b4 → celldetective-1.5.0b6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: celldetective
-Version: 1.5.0b4
+Version: 1.5.0b6
 Summary: description
 Home-page: http://github.com/remyeltorro/celldetective
 Author: Rémy Torro
@@ -15,11 +15,8 @@ Requires-Dist: sphinx_rtd_theme
 Requires-Dist: sphinx
 Requires-Dist: jinja2
 Requires-Dist: ipykernel
-Requires-Dist: stardist
-Requires-Dist: cellpose<3
 Requires-Dist: scikit-learn
 Requires-Dist: btrack
-Requires-Dist: tensorflow~=2.15.0
 Requires-Dist: napari<0.6.0
 Requires-Dist: tqdm
 Requires-Dist: mahotas
@@ -48,6 +45,19 @@ Requires-Dist: prettyprint
 Requires-Dist: pandas
 Requires-Dist: matplotlib
 Requires-Dist: prettytable
+Requires-Dist: scikit-image
+Requires-Dist: natsort
+Provides-Extra: tensorflow
+Requires-Dist: tensorflow~=2.15.0; extra == "tensorflow"
+Requires-Dist: stardist; extra == "tensorflow"
+Provides-Extra: process
+Requires-Dist: cellpose<3; extra == "process"
+Requires-Dist: stardist; extra == "process"
+Requires-Dist: tensorflow~=2.15.0; extra == "process"
+Provides-Extra: all
+Requires-Dist: cellpose<3; extra == "all"
+Requires-Dist: stardist; extra == "all"
+Requires-Dist: tensorflow~=2.15.0; extra == "all"
 Dynamic: author
 Dynamic: author-email
 Dynamic: description
@@ -55,6 +65,7 @@ Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: license
 Dynamic: license-file
+Dynamic: provides-extra
 Dynamic: requires-dist
 Dynamic: summary
 
@@ -148,10 +159,12 @@ To use the software, you must install python, *e.g.* through
 
 Celldetective requires a version of Python between 3.9 and 3.11 (included). If your Python version is older or more recent, consider using `conda` to create an environment as described below.
 
-With the proper Python version, Celldetective can be directly installed with `pip`:
+With the proper Python version, Celldetective can be directly installed with `pip`.
+**Important**: By default, `pip install celldetective` will **not** install deep-learning libraries (`tensorflow`, `cellpose`, `stardist`) to allow users to manage their own GPU environment (e.g. `torch`, `cuda`).
 
+If you want the standard full installation (recommended for most users), use:
 ``` bash
-pip install celldetective
+pip install celldetective[all]
 ```
 
 We recommend that you create an environment to use Celldetective, to protect your package versions and fix the Python version *e.g.*
@@ -160,7 +173,7 @@ with `conda`:
 ``` bash
 conda create -n celldetective python=3.11 pyqt
 conda activate celldetective
-pip install celldetective
+pip install celldetective[all]
 ```
 
 Need an update? Simply type the following in the terminal (in your

{celldetective-1.5.0b4 → celldetective-1.5.0b6}/README.md

@@ -88,10 +88,12 @@ To use the software, you must install python, *e.g.* through
 
 Celldetective requires a version of Python between 3.9 and 3.11 (included). If your Python version is older or more recent, consider using `conda` to create an environment as described below.
 
-With the proper Python version, Celldetective can be directly installed with `pip`:
+With the proper Python version, Celldetective can be directly installed with `pip`.
+**Important**: By default, `pip install celldetective` will **not** install deep-learning libraries (`tensorflow`, `cellpose`, `stardist`) to allow users to manage their own GPU environment (e.g. `torch`, `cuda`).
 
+If you want the standard full installation (recommended for most users), use:
 ``` bash
-pip install celldetective
+pip install celldetective[all]
 ```
 
 We recommend that you create an environment to use Celldetective, to protect your package versions and fix the Python version *e.g.*
@@ -100,7 +102,7 @@ with `conda`:
 ``` bash
 conda create -n celldetective python=3.11 pyqt
 conda activate celldetective
-pip install celldetective
+pip install celldetective[all]
 ```
 
 Need an update? Simply type the following in the terminal (in your

celldetective-1.5.0b6/celldetective/_version.py

@@ -0,0 +1 @@
+__version__ = "1.5.0b6"

{celldetective-1.5.0b4 → celldetective-1.5.0b6}/celldetective/gui/base/figure_canvas.py

@@ -22,19 +22,33 @@ class FigureCanvas(CelldetectiveWidget):
             from matplotlib.backends.backend_qt5agg import NavigationToolbar2QT
 
             self.toolbar = NavigationToolbar2QT(self.canvas)
+            self.toolbar.setStyleSheet(
+                "QToolButton:hover {background-color: lightgray;} QToolButton {background-color: transparent; border: none;}"
+            )
         self.layout = QVBoxLayout(self)
         self.layout.addWidget(self.canvas, 90)
         if interactive:
             self.layout.addWidget(self.toolbar)
 
-        #center_window(self)
+        self.manual_layout = False
+        # center_window(self)
         self.setAttribute(Qt.WA_DeleteOnClose)
 
     def resizeEvent(self, event):
-
+        print("DEBUG: resizeEvent called")
         super().resizeEvent(event)
         try:
-            self.fig.tight_layout()
+            manual_layout = getattr(self, "manual_layout", False)
+
+            # Double check for profile axes manually (robust fallback)
+            if not manual_layout and hasattr(self.fig, "axes"):
+                for ax in self.fig.axes:
+                    if ax.get_label() == "profile_axes":
+                        manual_layout = True
+                        break
+
+            if not manual_layout:
+                self.fig.tight_layout()
         except:
             pass
 

{celldetective-1.5.0b4 → celldetective-1.5.0b6}/celldetective/gui/viewers/base_viewer.py

@@ -285,6 +285,10 @@ class StackVisualizer(CelldetectiveWidget):
             self.lock_y_action.setEnabled(True)
             self.canvas.toolbar.mode = ""
 
+            # Enable manual layout control to prevent tight_layout interference
+            if hasattr(self.canvas, "manual_layout"):
+                self.canvas.manual_layout = True
+
             # Connect events
             self.cid_press = self.fig.canvas.mpl_connect(
                 "button_press_event", self.on_line_press
@@ -297,8 +301,8 @@ class StackVisualizer(CelldetectiveWidget):
             )
 
             # Save original position if not saved
-            if not hasattr(self, "ax_original_pos"):
-                self.ax_original_pos = self.ax.get_position()
+            # if not hasattr(self, "ax_original_pos"):
+            #     self.ax_original_pos = self.ax.get_position()
 
             # Disable tight_layout/layout engine to prevent fighting manual positioning
             if hasattr(self.fig, "set_layout_engine"):
@@ -334,6 +338,7 @@ class StackVisualizer(CelldetectiveWidget):
                 self.ax_profile.set_position(gs[1].get_position(self.fig))
 
             self.ax_profile.set_visible(True)
+            self.ax_profile.set_label("profile_axes")
             self.ax_profile.set_facecolor("none")
             self.ax_profile.tick_params(axis="y", which="major", labelsize=8)
             self.ax_profile.set_xticks([])
@@ -346,11 +351,40 @@ class StackVisualizer(CelldetectiveWidget):
             self.ax_profile.spines["bottom"].set_color("black")
             self.ax_profile.spines["left"].set_color("black")
 
+            # Update Toolbar Home State to match new layout BUT with full field of view
+            # 1. Save current zoom
+            current_xlim = self.ax.get_xlim()
+            current_ylim = self.ax.get_ylim()
+
+            # 2. Set limits to full extent (Home State)
+            if hasattr(self, "im"):
+                extent = self.im.get_extent()  # (left, right, bottom, top) or similar
+                self.ax.set_xlim(extent[0], extent[1])
+                self.ax.set_ylim(extent[2], extent[3])
+
+            # 3. Reset Stack and save Home
+            self.canvas.toolbar._nav_stack.clear()
+            self.canvas.toolbar.push_current()
+
+            # 4. Restore User Zoom
+            self.ax.set_xlim(current_xlim)
+            self.ax.set_ylim(current_ylim)
+
+            # 5. Push restored zoom state so "Back"/"Forward" logic works from here?
+            # Actually, if we just restore, we are "live" at a new state.
+            # If we don't push, "Home" works. "Back" might not exist yet. That's fine.
+            self.canvas.toolbar.push_current()
+
             self.canvas.draw()
         else:
             self.line_mode = False
             self.lock_y_action.setChecked(False)
             self.lock_y_action.setEnabled(False)
+
+            # Disable manual layout control
+            if hasattr(self.canvas, "manual_layout"):
+                self.canvas.manual_layout = False
+
             # Disconnect events
             if hasattr(self, "cid_press"):
                 self.fig.canvas.mpl_disconnect(self.cid_press)
@@ -372,17 +406,24 @@ class StackVisualizer(CelldetectiveWidget):
                 self.ax_profile = None
 
             # Restore original layout
-            if hasattr(self, "ax_original_pos"):
-                # standard 1x1 GridSpec or manual restore
-                import matplotlib.gridspec as gridspec
-
-                gs = gridspec.GridSpec(1, 1)
-                self.ax.set_subplotspec(gs[0])
-                self.ax.set_position(gs[0].get_position(self.fig))
-                self.fig.subplots_adjust(
-                    top=1, bottom=0, right=1, left=0, hspace=0, wspace=0
-                )
-                # self.ax.set_position(self.ax_original_pos) # tight layout should fix it
+            # if hasattr(self, "ax_original_pos"):
+            # standard 1x1 GridSpec or manual restore
+            import matplotlib.gridspec as gridspec
+
+            gs = gridspec.GridSpec(1, 1)
+            self.ax.set_subplotspec(gs[0])
+            # self.ax.set_position(gs[0].get_position(self.fig))
+            self.fig.subplots_adjust(
+                top=1, bottom=0, right=1, left=0, hspace=0, wspace=0
+            )
+            # self.ax.set_position(self.ax_original_pos) # tight layout should fix it
+
+            # Re-enable tight_layout via standard resize event later or explicit call
+            self.fig.tight_layout()
+
+            # Reset Toolbar Stack for Standard View
+            self.canvas.toolbar._nav_stack.clear()
+            self.canvas.toolbar.push_current()
 
             self.canvas.draw()
             self.info_lbl.setText("")
@@ -553,7 +594,10 @@ class StackVisualizer(CelldetectiveWidget):
             self.mode = "direct"
             self.stack_length = len(self.stack)
             self.mid_time = self.stack_length // 2
-            self.init_frame = self.stack[self.mid_time, :, :, self.target_channel]
+            self.current_time_index = 0
+            self.init_frame = self.stack[
+                self.current_time_index, :, :, self.target_channel
+            ]
             self.last_frame = self.stack[-1, :, :, self.target_channel]
         else:
             self.mode = "virtual"
@@ -566,6 +610,7 @@ class StackVisualizer(CelldetectiveWidget):
 
         self.stack_length = auto_load_number_of_frames(self.stack_path)
         self.mid_time = self.stack_length // 2
+        self.current_time_index = 0
         self.img_num_per_channel = _get_img_num_per_channel(
             np.arange(self.n_channels), self.stack_length, self.n_channels
         )
@@ -578,7 +623,7 @@ class StackVisualizer(CelldetectiveWidget):
         self.loader_thread.start()
 
         self.init_frame = load_frames(
-            self.img_num_per_channel[self.target_channel, self.mid_time],
+            self.img_num_per_channel[self.target_channel, self.current_time_index],
             self.stack_path,
             normalize_input=False,
         )[:, :, 0]
@@ -713,7 +758,7 @@ class StackVisualizer(CelldetectiveWidget):
         layout = QHBoxLayout()
         self.frame_slider = QLabeledSlider(Qt.Horizontal)
         self.frame_slider.setRange(0, self.stack_length - 1)
-        self.frame_slider.setValue(self.mid_time)
+        self.frame_slider.setValue(self.current_time_index)
         self.frame_slider.valueChanged.connect(self.change_frame)
         layout.addWidget(QLabel("Time: "), 15)
         layout.addWidget(self.frame_slider, 85)
@@ -721,7 +766,7 @@ class StackVisualizer(CelldetectiveWidget):
 
     def set_target_channel(self, value):
         self.target_channel = value
-        self.init_frame = self.stack[self.mid_time, :, :, self.target_channel]
+        self.init_frame = self.stack[self.current_time_index, :, :, self.target_channel]
         self.im.set_data(self.init_frame)
         self.canvas.draw()
         self.update_profile()
@@ -739,7 +784,9 @@ class StackVisualizer(CelldetectiveWidget):
             self.change_frame_from_channel_switch(self.frame_slider.value())
         else:
             if self.stack is not None and self.stack.ndim == 4:
-                self.init_frame = self.stack[self.mid_time, :, :, self.target_channel]
+                self.init_frame = self.stack[
+                    self.current_time_index, :, :, self.target_channel
+                ]
                 self.im.set_data(self.init_frame)
                 self.canvas.draw()
                 self.update_profile()
@@ -752,7 +799,8 @@ class StackVisualizer(CelldetectiveWidget):
             p01 = np.nanpercentile(self.init_frame, 0.1)
             p99 = np.nanpercentile(self.init_frame, 99.9)
             self.im.set_clim(vmin=p01, vmax=p99)
-            self.contrast_slider.setValue((p01, p99))
+            if self.create_contrast_slider and hasattr(self, "contrast_slider"):
+                self.contrast_slider.setValue((p01, p99))
             self.channel_trigger = False
             self.canvas.draw()
 
@@ -831,6 +879,14 @@ class StackVisualizer(CelldetectiveWidget):
         # Event handler for closing the widget
         if self.loader_thread:
             self.loader_thread.stop()
+            self.loader_thread = None
         if hasattr(self, "frame_cache") and isinstance(self.frame_cache, OrderedDict):
             self.frame_cache.clear()
         self.canvas.close()
+
+    def __del__(self):
+        try:
+            if hasattr(self, "loader_thread") and self.loader_thread:
+                self.loader_thread.stop()
+        except:
+            pass

{celldetective-1.5.0b4 → celldetective-1.5.0b6}/celldetective/gui/viewers/channel_offset_viewer.py

@@ -9,11 +9,16 @@ from superqt import QLabeledDoubleSlider, QLabeledDoubleRangeSlider
 from celldetective.gui.base.components import QHSeperationLine
 from celldetective.gui.gui_utils import QuickSliderLayout, ThresholdLineEdit
 from celldetective.gui.viewers.base_viewer import StackVisualizer
-from celldetective.utils.image_loaders import load_frames, auto_load_number_of_frames, _get_img_num_per_channel
+from celldetective.utils.image_loaders import (
+    load_frames,
+    auto_load_number_of_frames,
+    _get_img_num_per_channel,
+)
 from celldetective import get_logger
 
 logger = get_logger(__name__)
 
+
 class ChannelOffsetViewer(StackVisualizer):
 
     def __init__(self, parent_window=None, *args, **kwargs):
@@ -22,16 +27,32 @@ class ChannelOffsetViewer(StackVisualizer):
         self.overlay_target_channel = -1
         self.shift_vertical = 0
         self.shift_horizontal = 0
+        self.overlay_init_contrast = False
         super().__init__(*args, **kwargs)
 
         self.load_stack()
+
+        if self.mode == "direct":
+            # Initialize overlay frames for direct mode
+            default_overlay_idx = -1
+            if self.stack.ndim == 4:
+                self.overlay_init_frame = self.stack[
+                    self.current_time_index, :, :, default_overlay_idx
+                ]
+                self.overlay_last_frame = self.stack[-1, :, :, default_overlay_idx]
+            else:
+                # Should rely on 4D stack assumption from StackVisualizer
+                self.overlay_init_frame = self.init_frame
+                self.overlay_last_frame = self.last_frame
+
         self.canvas.layout.addWidget(QHSeperationLine())
 
         self.generate_overlay_channel_cb()
         self.generate_overlay_imshow()
 
         self.generate_overlay_alpha_slider()
-        self.generate_overlay_contrast_slider()
+        if self.create_contrast_slider:
+            self.generate_overlay_contrast_slider()
 
         self.generate_overlay_shift()
         self.generate_add_to_parent_btn()
@@ -190,7 +211,7 @@ class ChannelOffsetViewer(StackVisualizer):
 
         self.im_overlay.set_data(self.overlay_init_frame)
 
-        if self.overlay_init_contrast:
+        if self.overlay_init_contrast and self.create_contrast_slider:
             self.im_overlay.autoscale()
             I_min, I_max = self.im_overlay.get_clim()
             self.overlay_contrast_slider.setRange(
@@ -214,12 +235,13 @@ class ChannelOffsetViewer(StackVisualizer):
             gc.collect()
 
         self.mid_time = self.stack_length // 2
+        self.current_time_index = 0
         self.img_num_per_channel = _get_img_num_per_channel(
             np.arange(self.n_channels), self.stack_length, self.n_channels
         )
 
         self.init_frame = load_frames(
-            self.img_num_per_channel[self.target_channel, self.mid_time],
+            self.img_num_per_channel[self.target_channel, self.current_time_index],
             self.stack_path,
             normalize_input=False,
         ).astype(float)[:, :, 0]
@@ -229,7 +251,9 @@ class ChannelOffsetViewer(StackVisualizer):
             normalize_input=False,
         ).astype(float)[:, :, 0]
         self.overlay_init_frame = load_frames(
-            self.img_num_per_channel[self.overlay_target_channel, self.mid_time],
+            self.img_num_per_channel[
+                self.overlay_target_channel, self.current_time_index
+            ],
             self.stack_path,
             normalize_input=False,
         ).astype(float)[:, :, 0]
@@ -306,6 +330,7 @@ class ChannelOffsetViewer(StackVisualizer):
         )
         self.im_overlay.set_data(self.shifted_frame)
         self.fig.canvas.draw_idle()
+        self.update_profile()
 
     def generate_add_to_parent_btn(self):
 
@@ -318,6 +343,95 @@ class ChannelOffsetViewer(StackVisualizer):
         add_hbox.addWidget(QLabel(""), 33)
         self.canvas.layout.addLayout(add_hbox)
 
+    def update_profile(self):
+        if not self.line_mode or not hasattr(self, "line_x") or not self.line_x:
+            return
+
+        # Calculate profile
+        x0, y0 = self.line_x[0], self.line_y[0]
+        x1, y1 = self.line_x[1], self.line_y[1]
+        length_px = np.hypot(x1 - x0, y1 - y0)
+        if length_px == 0:
+            return
+
+        num_points = int(length_px)
+        if num_points < 2:
+            num_points = 2
+
+        x, y = np.linspace(x0, x1, num_points), np.linspace(y0, y1, num_points)
+
+        # Use self.init_frame and overlay frame
+        profiles = []
+        colors = ["black", "tab:blue"]
+
+        # Main channel profile
+        if hasattr(self, "init_frame") and self.init_frame is not None:
+            from scipy.ndimage import map_coordinates
+
+            profile = map_coordinates(
+                self.init_frame, np.vstack((y, x)), order=1, mode="nearest"
+            )
+            profiles.append(profile)
+        else:
+            profiles.append(None)
+
+        # Overlay channel profile
+        # Use data currently in im_overlay, which accounts for shifts
+        overlay_data = self.im_overlay.get_array()
+        if overlay_data is not None:
+            from scipy.ndimage import map_coordinates
+
+            profile_overlay = map_coordinates(
+                overlay_data, np.vstack((y, x)), order=1, mode="nearest"
+            )
+            profiles.append(profile_overlay)
+        else:
+            profiles.append(None)
+
+        # Basic setup
+        self.ax_profile.clear()
+        self.ax_profile.set_facecolor("none")
+
+        # Distance axis
+        dist_axis = np.arange(num_points)
+        title_str = f"{round(length_px,2)} [px]"
+        if self.PxToUm is not None:
+            title_str += f" | {round(length_px*self.PxToUm,3)} [µm]"
+
+        # Handle Y-Axis Locking
+        current_ylim = None
+        if self.lock_y_action.isChecked():
+            current_ylim = self.ax_profile.get_ylim()
+
+        # Plot profiles
+        for i, (profile, color) in enumerate(zip(profiles, colors)):
+            if profile is not None:
+                if np.all(np.isnan(profile)):
+                    profile = np.zeros_like(profile)
+                    profile[:] = np.nan
+
+                self.ax_profile.plot(
+                    dist_axis, profile, color=color, linestyle="-", label=f"Ch{i}"
+                )
+
+        self.ax_profile.set_xticks([])
+        self.ax_profile.set_ylabel("Intensity", fontsize=8)
+        self.ax_profile.set_xlabel(title_str, fontsize=8)
+        self.ax_profile.tick_params(axis="y", which="major", labelsize=6)
+
+        # Hide spines
+        self.ax_profile.spines["top"].set_visible(False)
+        self.ax_profile.spines["right"].set_visible(False)
+        self.ax_profile.spines["bottom"].set_color("black")
+        self.ax_profile.spines["left"].set_color("black")
+
+        self.fig.set_facecolor("none")
+
+        if current_ylim:
+            self.ax_profile.set_ylim(current_ylim)
+
+        self.fig.canvas.draw_idle()
+
     def set_parent_attributes(self):
 
         idx = self.channels_overlay_cb.currentIndex()

{celldetective-1.5.0b4 → celldetective-1.5.0b6}/celldetective/gui/viewers/threshold_viewer.py

@@ -65,8 +65,6 @@ class ThresholdedStackVisualizer(StackVisualizer):
         self.thresh_min = 0.0
         self.thresh_max = 30.0
 
-        self.thresh_max = 30.0
-
         # Cache for processed images
         self.processed_cache = OrderedDict()
         self.processed_image = None
@@ -74,6 +72,15 @@ class ThresholdedStackVisualizer(StackVisualizer):
 
         self.generate_threshold_slider()
 
+        # Ensure we start at frame 0 for consistent mask caching and UX
+        if self.create_frame_slider and hasattr(self, "frame_slider"):
+            self.frame_slider.blockSignals(True)
+            self.frame_slider.setValue(0)
+            self.frame_slider.blockSignals(False)
+            self.change_frame(0)
+        elif self.stack_length > 0:
+            self.change_frame(0)
+
         if self.thresh is not None:
             self.compute_mask(self.thresh)
 
@@ -138,8 +145,8 @@ class ThresholdedStackVisualizer(StackVisualizer):
             slider_range=(self.thresh_min, np.amax([self.thresh_max, init_value])),
             decimal_option=True,
             precision=4,
+            layout_ratio=(0.15, 0.85),
         )
-        thresh_layout.setContentsMargins(15, 0, 15, 0)
         self.threshold_slider.valueChanged.connect(self.change_threshold)
         if self.show_threshold_slider:
             self.canvas.layout.addLayout(thresh_layout)
@@ -154,8 +161,8 @@ class ThresholdedStackVisualizer(StackVisualizer):
             slider_range=(0, 1),
             decimal_option=True,
             precision=3,
+            layout_ratio=(0.15, 0.85),
         )
-        opacity_layout.setContentsMargins(15, 0, 15, 0)
         self.opacity_slider.valueChanged.connect(self.change_mask_opacity)
         if self.show_opacity_slider:
             self.canvas.layout.addLayout(opacity_layout)
@@ -190,7 +197,8 @@ class ThresholdedStackVisualizer(StackVisualizer):
         if self.thresh is not None:
             self.compute_mask(self.thresh)
             mask = np.ma.masked_where(self.mask == 0, self.mask)
-            self.im_mask.set_data(mask)
+            if hasattr(self, "im_mask"):
+                self.im_mask.set_data(mask)
             self.canvas.canvas.draw_idle()
 
     def change_frame(self, value):
@@ -219,7 +227,7 @@ class ThresholdedStackVisualizer(StackVisualizer):
             threshold_image,
         )
 
-        edge = estimate_unreliable_edge(self.preprocessing)
+        edge = estimate_unreliable_edge(self.preprocessing or [])
 
         if isinstance(threshold_value, (list, np.ndarray, tuple)):
             self.mask = threshold_image(

{celldetective-1.5.0b4 → celldetective-1.5.0b6}/celldetective/utils/cellpose_utils/__init__.py

@@ -104,14 +104,27 @@ def _prep_cellpose_model(
       `diam_labels` are attributes of the model.
     """
 
-    import torch
+    try:
+        import torch
+    except ImportError as e:
+        raise RuntimeError(
+            "Torch is not installed. Please install it to use this feature.\n"
+            "You can install the full package with: pip install celldetective[process]\n"
+        ) from e
 
     if not use_gpu:
         device = torch.device("cpu")
     else:
         device = torch.device("cuda")
 
-    from cellpose.models import CellposeModel
+    try:
+        from cellpose.models import CellposeModel
+    except ImportError as e:
+        raise RuntimeError(
+            "Cellpose is not installed. Please install it to use this feature.\n"
+            "You can install the full package with: pip install celldetective[process]\n"
+            "Or specifically: pip install celldetective[cellpose]"
+        ) from e
 
     try:
         model = CellposeModel(