setiastrosuitepro 1.6.0__py3-none-any.whl

setiastro/saspro/resources.py

@@ -0,0 +1,472 @@
+# pro/resources.py
+"""
+Centralized resource paths for Seti Astro Suite Pro.
+
+This module provides a single source of truth for all icon and resource paths,
+handling both PyInstaller frozen builds and development environments.
+
+Usage:
+    from setiastro.saspro.resources import Icons, Resources
+    
+    icon = QIcon(Icons.WRENCH)
+    data_path = Resources.SASP_DATA
+"""
+from __future__ import annotations
+import os
+import sys
+from functools import lru_cache
+
+
+def _get_base_path() -> str:
+    """Get base path for resources (PyInstaller, installed package, or development)."""
+    if hasattr(sys, '_MEIPASS'):
+        return sys._MEIPASS
+    
+    # First, check if we're running from source (setiastrosuitepro.py exists)
+    # This takes priority when running the script directly from source
+    try:
+        # Check if we can find it via __main__ module (most reliable)
+        if '__main__' in sys.modules:
+            main_module = sys.modules['__main__']
+            if hasattr(main_module, '__file__') and main_module.__file__:
+                main_file = main_module.__file__
+                main_dir = os.path.dirname(os.path.abspath(main_file))
+                
+                # Case 1: Running setiastrosuitepro.py directly
+                if os.path.basename(main_file) == 'setiastrosuitepro.py':
+                    images_dir = os.path.join(main_dir, 'images')
+                    if os.path.exists(images_dir):
+                        return main_dir
+                
+                # Case 2: Running as module (python -m setiastro.saspro)
+                # __main__.py is at src/setiastro/saspro/__main__.py
+                # Need to go up 4 levels to reach project root
+                if os.path.basename(main_file) == '__main__.py':
+                    # Walk up from __main__.py to find project root with images/
+                    search_dir = main_dir
+                    for _ in range(6):  # Don't go too far up
+                        images_dir = os.path.join(search_dir, 'images')
+                        if os.path.exists(images_dir):
+                            return search_dir
+                        parent = os.path.dirname(search_dir)
+                        if parent == search_dir:  # Reached filesystem root
+                            break
+                        search_dir = parent
+        
+        # Check current working directory for setiastrosuitepro.py
+        # This handles the case where user runs: python setiastrosuitepro.py
+        cwd = os.getcwd()
+        main_script = os.path.join(cwd, 'setiastrosuitepro.py')
+        if os.path.exists(main_script):
+            images_dir = os.path.join(cwd, 'images')
+            if os.path.exists(images_dir):
+                return cwd
+        
+        # Also check parent directories (in case we're in a subdirectory)
+        # Walk up from current file location looking for images/ directory
+        current_file = os.path.abspath(__file__)
+        search_dir = os.path.dirname(current_file)
+        for _ in range(6):  # Don't go too far up
+            images_dir = os.path.join(search_dir, 'images')
+            if os.path.exists(images_dir):
+                return search_dir
+            parent = os.path.dirname(search_dir)
+            if parent == search_dir:  # Reached filesystem root
+                break
+            search_dir = parent
+    except Exception:
+        pass
+    
+    # Development: resources are in project root
+    # File is at: src/setiastro/saspro/resources.py
+    # Need to go up 4 levels to reach project root
+    current_file = os.path.abspath(__file__)
+    # Go up from resources.py -> saspro -> setiastro -> src -> project root
+    base = os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname(current_file))))
+    
+    # Verify we found the right directory by checking for images/ folder
+    images_dir = os.path.join(base, 'images')
+    if os.path.exists(images_dir):
+        return base
+    
+    # Fallback: try going up one more level (in case structure is different)
+    base = os.path.dirname(base)
+    if os.path.exists(os.path.join(base, 'images')):
+        return base
+    
+    # Check if we're in an installed package (last resort)
+    # When installed via pip, the package is in site-packages
+    try:
+        import setiastro
+        package_dir = os.path.dirname(os.path.abspath(setiastro.__file__))
+        # Check if images/ exists at package root level (for pip-installed packages)
+        # The images/ directory should be at the same level as setiastro/ in site-packages
+        package_parent = os.path.dirname(package_dir)
+        images_dir = os.path.join(package_parent, 'images')
+        if os.path.exists(images_dir):
+            return package_parent
+        
+        # Also check if images/ is inside the package directory
+        images_in_package = os.path.join(package_dir, 'images')
+        if os.path.exists(images_in_package):
+            return package_dir
+    except (ImportError, AttributeError):
+        pass
+    
+    # Last resort: return the calculated path anyway
+    return os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname(current_file))))
+
+
+def _resource_path(filename: str) -> str:
+    """Get full path to a resource file."""
+    base = _get_base_path()
+    
+    # Check if it's an image file - look in images/ subdirectory
+    if filename.endswith(('.png', '.ico', '.gif', '.icns', '.svg')):
+        images_path = os.path.join(base, 'images', filename)
+        if os.path.exists(images_path):
+            return images_path
+    
+    # Fallback to root directory (for data files like .csv, .fits, etc.)
+    return os.path.join(base, filename)
+
+
+class Icons:
+    """
+    Centralized icon paths.
+    
+    All paths are computed lazily and cached.
+    Access via class attributes: Icons.WRENCH, Icons.HISTOGRAM, etc.
+    """
+    
+    # Application
+    APP = property(lambda self: _resource_path('astrosuitepro.png'))
+    APP_ICO = property(lambda self: _resource_path('astrosuitepro.ico'))
+    BACKGROUND = property(lambda self: _resource_path('background.png')) 
+    
+    # Processing tools
+    GREEN = property(lambda self: _resource_path('green.png'))
+    NEUTRAL = property(lambda self: _resource_path('neutral.png'))
+    WHITE_BALANCE = property(lambda self: _resource_path('whitebalance.png'))
+    MORPHOLOGY = property(lambda self: _resource_path('morpho.png'))
+    CLAHE = property(lambda self: _resource_path('clahe.png'))
+    HDR = property(lambda self: _resource_path('hdr.png'))
+    INVERT = property(lambda self: _resource_path('invert.png'))
+    
+    # Star operations
+    STARNET = property(lambda self: _resource_path('starnet.png'))
+    STAR_ADD = property(lambda self: _resource_path('staradd.png'))
+    STAR_ALIGN = property(lambda self: _resource_path('staralign.png'))
+    STAR_REGISTRATION = property(lambda self: _resource_path('starregistration.png'))
+    STAR_SPIKE = property(lambda self: _resource_path('starspike.png'))
+    ASTRO_SPIKE = property(lambda self: _resource_path('Astro_Spikes.png'))
+    STAR_STRETCH = property(lambda self: _resource_path('starstretch.png'))
+    
+    # Luminance
+    L_EXTRACT = property(lambda self: _resource_path('LExtract.png'))
+    L_INSERT = property(lambda self: _resource_path('LInsert.png'))
+    
+    # Slots (0-9)
+    SLOT_0 = property(lambda self: _resource_path('slot0.png'))
+    SLOT_1 = property(lambda self: _resource_path('slot1.png'))
+    SLOT_2 = property(lambda self: _resource_path('slot2.png'))
+    SLOT_3 = property(lambda self: _resource_path('slot3.png'))
+    SLOT_4 = property(lambda self: _resource_path('slot4.png'))
+    SLOT_5 = property(lambda self: _resource_path('slot5.png'))
+    SLOT_6 = property(lambda self: _resource_path('slot6.png'))
+    SLOT_7 = property(lambda self: _resource_path('slot7.png'))
+    SLOT_8 = property(lambda self: _resource_path('slot8.png'))
+    SLOT_9 = property(lambda self: _resource_path('slot9.png'))
+    
+    # RGB operations
+    RGB_COMBO = property(lambda self: _resource_path('rgbcombo.png'))
+    RGB_EXTRACT = property(lambda self: _resource_path('rgbextract.png'))
+    RGB_ALIGN = property(lambda self: _resource_path('rgbalign.png'))
+    COPY_SLOT = property(lambda self: _resource_path('copyslot.png'))
+    
+    # External tools
+    GRAXPERT = property(lambda self: _resource_path('graxpert.png'))
+    COSMIC = property(lambda self: _resource_path('cosmic.png'))
+    COSMIC_SAT = property(lambda self: _resource_path('cosmicsat.png'))
+    
+    # Image operations
+    CROP = property(lambda self: _resource_path('cropicon.png'))
+    OPEN_FILE = property(lambda self: _resource_path('openfile.png'))
+    ABE = property(lambda self: _resource_path('abeicon.png'))
+    BLASTER = property(lambda self: _resource_path('blaster.png'))
+    
+    # Undo/Redo
+    UNDO = property(lambda self: _resource_path('undoicon.png'))
+    REDO = property(lambda self: _resource_path('redoicon.png'))
+    
+    # Transformations
+    FLIP_HORIZONTAL = property(lambda self: _resource_path('fliphorizontal.png'))
+    FLIP_VERTICAL = property(lambda self: _resource_path('flipvertical.png'))
+    ROTATE_CW = property(lambda self: _resource_path('rotateclockwise.png'))
+    ROTATE_CCW = property(lambda self: _resource_path('rotatecounterclockwise.png'))
+    ROTATE_180 = property(lambda self: _resource_path('rotate180.png'))
+    RESCALE = property(lambda self: _resource_path('rescale.png'))
+    
+    # Masks
+    MASK_CREATE = property(lambda self: _resource_path('maskcreate.png'))
+    MASK_APPLY = property(lambda self: _resource_path('maskapply.png'))
+    MASK_REMOVE = property(lambda self: _resource_path('maskremove.png'))
+    
+    # Analysis
+    PIXEL_MATH = property(lambda self: _resource_path('pixelmath.png'))
+    HISTOGRAM = property(lambda self: _resource_path('histogram.png'))
+    MOSAIC = property(lambda self: _resource_path('mosaic.png'))
+    PLATE_SOLVE = property(lambda self: _resource_path('platesolve.png'))
+    PSF = property(lambda self: _resource_path('psf.png'))
+    ISOPHOTE = property(lambda self: _resource_path('isophote.png'))
+    
+    # Stacking
+    STACKING = property(lambda self: _resource_path('stacking.png'))
+    LIVE_STACKING = property(lambda self: _resource_path('livestacking.png'))
+    IMAGE_COMBINE = property(lambda self: _resource_path('imagecombine.png'))
+    
+    # Special features
+    SUPERNOVA = property(lambda self: _resource_path('supernova.png'))
+    PEDESTAL = property(lambda self: _resource_path('pedestal.png'))
+    APERTURE = property(lambda self: _resource_path('aperture.png'))
+    JWST_PUPIL = property(lambda self: _resource_path('jwstpupil.png'))
+    SIGNATURE = property(lambda self: _resource_path('pen.png'))
+    HR_DIAGRAM = property(lambda self: _resource_path('HRDiagram.png'))
+    EXOPLANET = property(lambda self: _resource_path('exoicon.png'))
+    
+    # Deconvolution & filters
+    CONVO = property(lambda self: _resource_path('convo.png'))
+    FREQ_SEP = property(lambda self: _resource_path('freqsep.png'))
+    MULTISCALE_DECOMP = property(lambda self: _resource_path('multiscale_decomp.png'))
+    CONT_SUB = property(lambda self: _resource_path('contsub.png'))
+    HALO = property(lambda self: _resource_path('halo.png'))
+    ABERRATION = property(lambda self: _resource_path('aberration.png'))
+    
+    # Color
+    SPCC = property(lambda self: _resource_path('spcc.png'))
+    DSE = property(lambda self: _resource_path('dse.png'))
+    COLOR_WHEEL = property(lambda self: _resource_path('colorwheel.png'))
+    SELECTIVE_COLOR = property(lambda self: _resource_path('selectivecolor.png'))
+    NB_TO_RGB = property(lambda self: _resource_path('nbtorgb.png'))
+    
+    # Stretching
+    STAT_STRETCH = property(lambda self: _resource_path('statstretch.png'))
+    CURVES = property(lambda self: _resource_path('curves.png'))
+    UHS = property(lambda self: _resource_path('uhs.png'))
+    
+    # UI elements
+    WRENCH = property(lambda self: _resource_path('wrench_icon.png'))
+    EYE = property(lambda self: _resource_path('eye.png'))
+    DISK = property(lambda self: _resource_path('disk.png'))
+    NUKE = property(lambda self: _resource_path('nuke.png'))
+    GRID = property(lambda self: _resource_path('gridicon.png'))
+    FONT = property(lambda self: _resource_path('font.png'))
+    CSV = property(lambda self: _resource_path('cvs.png'))
+    PPP = property(lambda self: _resource_path('ppp.png'))
+    SCRIPT = property(lambda self: _resource_path('script.png'))
+    
+    # Blink & comparison
+    BLINK = property(lambda self: _resource_path('blink.png'))
+    HUBBLE = property(lambda self: _resource_path('hubble.png'))
+    COLLAGE = property(lambda self: _resource_path('collage.png'))
+    ANNOTATED = property(lambda self: _resource_path('annotated.png'))
+    
+    # WIMS/WIMI
+    WIMS = property(lambda self: _resource_path('wims.png'))
+    WIMI = property(lambda self: _resource_path('wimi_icon_256x256.png'))
+    
+    # Other
+    LINEAR_FIT = property(lambda self: _resource_path('linearfit.png'))
+    DEBAYER = property(lambda self: _resource_path('debayer.png'))
+    FUNCTION_BUNDLES = property(lambda self: _resource_path('functionbundle.png'))
+    VIEW_BUNDLES = property(lambda self: _resource_path('viewbundle.png'))
+
+
+class Resources:
+    """
+    Centralized data resource paths.
+    """
+    SASP_DATA = property(lambda self: _resource_path('data/SASP_data.fits'))
+    ASTROBIN_FILTERS_CSV = property(lambda self: _resource_path('data/catalogs/astrobin_filters.csv'))
+    SPINNER_GIF = property(lambda self: _resource_path('spinner.gif'))
+
+
+# Singleton instances for easy access
+_icons_instance = None
+_resources_instance = None
+
+
+def get_icons() -> Icons:
+    """Get the Icons singleton instance."""
+    global _icons_instance
+    if _icons_instance is None:
+        _icons_instance = Icons()
+    return _icons_instance
+
+
+def get_resources() -> Resources:
+    """Get the Resources singleton instance."""
+    global _resources_instance
+    if _resources_instance is None:
+        _resources_instance = Resources()
+    return _resources_instance
+
+
+# Convenience functions for direct path access
+@lru_cache(maxsize=128)
+def get_icon_path(name: str) -> str:
+    """
+    Get icon path by name.
+    
+    Args:
+        name: Icon filename (with or without extension)
+        
+    Returns:
+        Full path to icon file
+        
+    Example:
+        path = get_icon_path('wrench_icon.png')
+        path = get_icon_path('histogram')  # .png added automatically
+    """
+    if not name.endswith(('.png', '.ico', '.gif', '.svg')):
+        name = f"{name}.png"
+    return _resource_path(name)
+
+
+@lru_cache(maxsize=32)
+def get_data_path(name: str) -> str:
+    """
+    Get data file path by name.
+    
+    Args:
+        name: Data filename
+        
+    Returns:
+        Full path to data file
+    """
+    return _resource_path(name)
+
+
+# Legacy compatibility: export paths as module-level variables
+# These match the original variable names in setiastrosuitepro.py
+def _init_legacy_paths():
+    """Initialize legacy path variables for backward compatibility."""
+    return {
+        'icon_path': get_icon_path('astrosuitepro.png'),
+        'windowslogo_path': get_icon_path('astrosuitepro.ico'),
+        'green_path': get_icon_path('green.png'),
+        'neutral_path': get_icon_path('neutral.png'),
+        'whitebalance_path': get_icon_path('whitebalance.png'),
+        'morpho_path': get_icon_path('morpho.png'),
+        'clahe_path': get_icon_path('clahe.png'),
+        'starnet_path': get_icon_path('starnet.png'),
+        'staradd_path': get_icon_path('staradd.png'),
+        'LExtract_path': get_icon_path('LExtract.png'),
+        'LInsert_path': get_icon_path('LInsert.png'),
+        'slot0_path': get_icon_path('slot0.png'),
+        'slot1_path': get_icon_path('slot1.png'),
+        'slot2_path': get_icon_path('slot2.png'),
+        'slot3_path': get_icon_path('slot3.png'),
+        'slot4_path': get_icon_path('slot4.png'),
+        'slot5_path': get_icon_path('slot5.png'),
+        'slot6_path': get_icon_path('slot6.png'),
+        'slot7_path': get_icon_path('slot7.png'),
+        'slot8_path': get_icon_path('slot8.png'),
+        'slot9_path': get_icon_path('slot9.png'),
+        'rgbcombo_path': get_icon_path('rgbcombo.png'),
+        'rgbextract_path': get_icon_path('rgbextract.png'),
+        'copyslot_path': get_icon_path('copyslot.png'),
+        'graxperticon_path': get_icon_path('graxpert.png'),
+        'cropicon_path': get_icon_path('cropicon.png'),
+        'openfile_path': get_icon_path('openfile.png'),
+        'abeicon_path': get_icon_path('abeicon.png'),
+        'undoicon_path': get_icon_path('undoicon.png'),
+        'redoicon_path': get_icon_path('redoicon.png'),
+        'blastericon_path': get_icon_path('blaster.png'),
+        'hdr_path': get_icon_path('hdr.png'),
+        'invert_path': get_icon_path('invert.png'),
+        'fliphorizontal_path': get_icon_path('fliphorizontal.png'),
+        'flipvertical_path': get_icon_path('flipvertical.png'),
+        'rotateclockwise_path': get_icon_path('rotateclockwise.png'),
+        'rotatecounterclockwise_path': get_icon_path('rotatecounterclockwise.png'),
+        'rotate180_path': get_icon_path('rotate180.png'),
+        'maskcreate_path': get_icon_path('maskcreate.png'),
+        'maskapply_path': get_icon_path('maskapply.png'),
+        'maskremove_path': get_icon_path('maskremove.png'),
+        'pixelmath_path': get_icon_path('pixelmath.png'),
+        'histogram_path': get_icon_path('histogram.png'),
+        'mosaic_path': get_icon_path('mosaic.png'),
+        'rescale_path': get_icon_path('rescale.png'),
+        'staralign_path': get_icon_path('staralign.png'),
+        'mask_path': get_icon_path('maskapply.png'),
+        'platesolve_path': get_icon_path('platesolve.png'),
+        'psf_path': get_icon_path('psf.png'),
+        'supernova_path': get_icon_path('supernova.png'),
+        'starregistration_path': get_icon_path('starregistration.png'),
+        'stacking_path': get_icon_path('stacking.png'),
+        'pedestal_icon_path': get_icon_path('pedestal.png'),
+        'starspike_path': get_icon_path('starspike.png'),
+        'astrospike_path': get_icon_path('Astro_Spikes.png'),
+        'aperture_path': get_icon_path('aperture.png'),
+        'jwstpupil_path': get_icon_path('jwstpupil.png'),
+        'signature_icon_path': get_icon_path('pen.png'),
+        'livestacking_path': get_icon_path('livestacking.png'),
+        'hrdiagram_path': get_icon_path('HRDiagram.png'),
+        'convoicon_path': get_icon_path('convo.png'),
+        'spcc_icon_path': get_icon_path('spcc.png'),
+        'sasp_data_path': get_data_path('data/SASP_data.fits'),
+        'exoicon_path': get_icon_path('exoicon.png'),
+        'peeker_icon': get_icon_path('gridicon.png'),
+        'dse_icon_path': get_icon_path('dse.png'),
+        'astrobin_filters_csv_path': get_data_path('data/catalogs/astrobin_filters.csv'),
+        'isophote_path': get_icon_path('isophote.png'),
+        'statstretch_path': get_icon_path('statstretch.png'),
+        'starstretch_path': get_icon_path('starstretch.png'),
+        'curves_path': get_icon_path('curves.png'),
+        'disk_path': get_icon_path('disk.png'),
+        'uhs_path': get_icon_path('uhs.png'),
+        'blink_path': get_icon_path('blink.png'),
+        'ppp_path': get_icon_path('ppp.png'),
+        'nbtorgb_path': get_icon_path('nbtorgb.png'),
+        'freqsep_path': get_icon_path('freqsep.png'),
+        'multiscale_decomp_path': get_icon_path('multiscale_decomp.png'),
+        'contsub_path': get_icon_path('contsub.png'),
+        'halo_path': get_icon_path('halo.png'),
+        'cosmic_path': get_icon_path('cosmic.png'),
+        'satellite_path': get_icon_path('cosmicsat.png'),
+        'imagecombine_path': get_icon_path('imagecombine.png'),
+        'wrench_path': get_icon_path('wrench_icon.png'),
+        'eye_icon_path': get_icon_path('eye.png'),
+        'disk_icon_path': get_icon_path('disk.png'),
+        'nuke_path': get_icon_path('nuke.png'),
+        'hubble_path': get_icon_path('hubble.png'),
+        'collage_path': get_icon_path('collage.png'),
+        'annotated_path': get_icon_path('annotated.png'),
+        'colorwheel_path': get_icon_path('colorwheel.png'),
+        'font_path': get_icon_path('font.png'),
+        'csv_icon_path': get_icon_path('cvs.png'),
+        'spinner_path': get_data_path('spinner.gif'),
+        'wims_path': get_icon_path('wims.png'),
+        'wimi_path': get_icon_path('wimi_icon_256x256.png'),
+        'linearfit_path': get_icon_path('linearfit.png'),
+        'debayer_path': get_icon_path('debayer.png'),
+        'aberration_path': get_icon_path('aberration.png'),
+        'functionbundles_path': get_icon_path('functionbundle.png'),
+        'viewbundles_path': get_icon_path('viewbundle.png'),
+        'selectivecolor_path': get_icon_path('selectivecolor.png'),
+        'rgbalign_path': get_icon_path('rgbalign.png'),
+        'background_path': get_icon_path('background.png'), 
+        'script_icon_path': get_icon_path('script.png'),
+    }
+
+
+# Export all legacy paths as module-level variables
+_legacy = _init_legacy_paths()
+globals().update(_legacy)
+
+# Export list for `from setiastro.saspro.resources import *`
+__all__ = [
+    'Icons', 'Resources', 
+    'get_icons', 'get_resources',
+    'get_icon_path', 'get_data_path',
+] + list(_legacy.keys())

setiastro/saspro/rgb_combination.py

@@ -0,0 +1,207 @@
+# pro/rgb_combination.py
+from __future__ import annotations
+import os
+import numpy as np
+from PyQt6.QtWidgets import (
+    QDialog, QVBoxLayout, QHBoxLayout, QLabel, QPushButton, QRadioButton,
+    QGroupBox, QFileDialog, QComboBox, QButtonGroup, QMessageBox
+)
+from PyQt6.QtCore import Qt
+
+try:
+    from setiastro.saspro.legacy.image_manager import load_image
+except Exception:
+    load_image = None
+
+
+def _to_f01(x: np.ndarray) -> np.ndarray:
+    a = np.asarray(x)
+    if a.dtype.kind in "ui":
+        a = a.astype(np.float32)
+    elif a.dtype.kind == "f" and a.dtype != np.float32:
+        a = a.astype(np.float32)
+    if a.size:
+        m = float(np.nanmax(a))
+        if m > 1.0 and np.isfinite(m):
+            a = a / m
+    return np.clip(a, 0.0, 1.0).astype(np.float32, copy=False)
+
+
+def _mono_from_any(arr: np.ndarray) -> np.ndarray:
+    a = _to_f01(arr)
+    if a.ndim == 2:
+        return a
+    if a.ndim == 3 and a.shape[2] >= 1:
+        return a[:, :, 0]
+    raise ValueError("Expected mono (HxW) or RGB (HxWx3) image.")
+
+
+class RGBCombinationDialogPro(QDialog):
+    """
+    Combine R/G/B from open views or files and ALWAYS create a new document.
+    """
+    def __init__(self, parent, list_open_docs_fn=None, doc_manager=None):
+        super().__init__(parent)
+        self.setWindowTitle("RGB Combination")
+        self.setWindowFlag(Qt.WindowType.Window, True)
+        self.setModal(False)
+        #self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose, True)
+        self._list_open_docs = list_open_docs_fn or (lambda: [])
+        self._docman = doc_manager
+
+        # file-mode state
+        self.r_path = None
+        self.g_path = None
+        self.b_path = None
+
+        # ── mode choose
+        self.load_files_radio = QRadioButton("Load Individual Files")
+        self.use_views_radio  = QRadioButton("Use Open Views")
+        self.use_views_radio.setChecked(True)
+
+        self.mode_group = QButtonGroup(self)
+        self.mode_group.addButton(self.load_files_radio)
+        self.mode_group.addButton(self.use_views_radio)
+
+        mode_box = QGroupBox("Select RGB Combination Mode")
+        ml = QVBoxLayout(mode_box)
+        ml.addWidget(self.use_views_radio)
+        ml.addWidget(self.load_files_radio)
+
+        # ── file mode widgets
+        self.r_label = QLabel("Red: Not selected")
+        self.g_label = QLabel("Green: Not selected")
+        self.b_label = QLabel("Blue: Not selected")
+        self.btn_load_r = QPushButton("Load Red…");   self.btn_load_r.clicked.connect(lambda: self._pick_file("R"))
+        self.btn_load_g = QPushButton("Load Green…"); self.btn_load_g.clicked.connect(lambda: self._pick_file("G"))
+        self.btn_load_b = QPushButton("Load Blue…");  self.btn_load_b.clicked.connect(lambda: self._pick_file("B"))
+
+        file_box = QGroupBox("Files")
+        fl = QVBoxLayout(file_box)
+        for lab, btn in [(self.r_label, self.btn_load_r),
+                         (self.g_label, self.btn_load_g),
+                         (self.b_label, self.btn_load_b)]:
+            row = QHBoxLayout(); row.addWidget(lab); row.addStretch(); row.addWidget(btn)
+            fl.addLayout(row)
+
+        # ── open-views widgets
+        views_box = QGroupBox("Select Open Views for R / G / B")
+        vl = QHBoxLayout(views_box)
+        self.cmb_r = QComboBox(); self.cmb_g = QComboBox(); self.cmb_b = QComboBox()
+        vl.addLayout(self._labeled("Red:",   self.cmb_r))
+        vl.addLayout(self._labeled("Green:", self.cmb_g))
+        vl.addLayout(self._labeled("Blue:",  self.cmb_b))
+
+        # ── buttons
+        self.btn_combine = QPushButton("Combine")
+        self.btn_cancel  = QPushButton("Cancel")
+        self.btn_cancel.clicked.connect(self.reject)
+        self.btn_combine.clicked.connect(self._combine)
+
+        btns = QHBoxLayout()
+        btns.addStretch(); btns.addWidget(self.btn_combine); btns.addWidget(self.btn_cancel)
+
+        # ── layout
+        L = QVBoxLayout(self)
+        L.addWidget(mode_box)
+        L.addWidget(views_box)
+        L.addWidget(file_box)
+        L.addLayout(btns)
+
+        self.mode_group.buttonClicked.connect(self._refresh_mode)
+        self._populate_views()
+        self._refresh_mode()
+
+    # --- helpers
+    def _labeled(self, text, w):
+        box = QVBoxLayout()
+        box.addWidget(QLabel(text))
+        box.addWidget(w)
+        return box
+
+    def _populate_views(self):
+        self.cmb_r.clear(); self.cmb_g.clear(); self.cmb_b.clear()
+        for title, doc in self._list_open_docs():
+            self.cmb_r.addItem(title, doc)
+            self.cmb_g.addItem(title, doc)
+            self.cmb_b.addItem(title, doc)
+
+    def _refresh_mode(self):
+        use_views = self.use_views_radio.isChecked()
+        for w in (self.cmb_r, self.cmb_g, self.cmb_b):
+            w.setEnabled(use_views)
+        for w in (self.r_label, self.g_label, self.b_label, self.btn_load_r, self.btn_load_g, self.btn_load_b):
+            w.setEnabled(not use_views)
+        if not load_image:
+            self.load_files_radio.setEnabled(False)
+            self.use_views_radio.setChecked(True)
+
+    def _pick_file(self, which):
+        fp, _ = QFileDialog.getOpenFileName(
+            self, f"Select {'Red' if which=='R' else 'Green' if which=='G' else 'Blue'} Image", "",
+            "Images (*.png *.tif *.tiff *.fits *.fit *.xisf *.jpg *.jpeg);;All Files (*)"
+        )
+        if not fp: return
+        base = os.path.basename(fp)
+        if which == "R":
+            self.r_path = fp; self.r_label.setText(f"Red: {base}")
+        elif which == "G":
+            self.g_path = fp; self.g_label.setText(f"Green: {base}")
+        else:
+            self.b_path = fp; self.b_label.setText(f"Blue: {base}")
+
+    def _load_file_mono(self, path: str) -> np.ndarray:
+        if load_image is None:
+            raise RuntimeError("File loading not available.")
+        arr, _, _, _ = load_image(path)
+        if arr is None:
+            raise RuntimeError(f"Failed to load: {path}")
+        return _mono_from_any(arr)
+
+    # --- combine → ALWAYS new document
+    def _combine(self):
+        try:
+            if self.use_views_radio.isChecked():
+                rdoc = self.cmb_r.currentData()
+                gdoc = self.cmb_g.currentData()
+                bdoc = self.cmb_b.currentData()
+                if not (rdoc and gdoc and bdoc):
+                    QMessageBox.information(self, "RGB Combination", "Please select three views.")
+                    return
+                r = _mono_from_any(getattr(rdoc, "image", None))
+                g = _mono_from_any(getattr(gdoc, "image", None))
+                b = _mono_from_any(getattr(bdoc, "image", None))
+                # propose a title from selections
+                title = "RGB_Combined"
+            else:
+                if not (self.r_path and self.g_path and self.b_path):
+                    QMessageBox.information(self, "RGB Combination", "Please choose three files.")
+                    return
+                r = self._load_file_mono(self.r_path)
+                g = self._load_file_mono(self.g_path)
+                b = self._load_file_mono(self.b_path)
+                title = f"RGB_{os.path.splitext(os.path.basename(self.r_path))[0]}"
+
+            if r.shape != g.shape or r.shape != b.shape:
+                raise ValueError("All three images must have identical dimensions.")
+
+            rgb = np.stack([r, g, b], axis=2).astype(np.float32, copy=False)
+            rgb = np.clip(rgb, 0.0, 1.0)
+
+            if not self._docman:
+                raise RuntimeError("No document manager available.")
+            # create new document every time
+            if hasattr(self._docman, "open_array"):
+                newdoc = self._docman.open_array(rgb, metadata={"step_name": "RGB Combination"}, title=title)
+            elif hasattr(self._docman, "open_numpy"):
+                newdoc = self._docman.open_numpy(rgb, metadata={"step_name": "RGB Combination"}, title=title)
+            else:
+                newdoc = self._docman.create_document(image=rgb, metadata={"step_name": "RGB Combination"}, name=title)
+
+            if hasattr(self.parent(), "_spawn_subwindow_for"):
+                self.parent()._spawn_subwindow_for(newdoc)
+
+            self.accept()
+
+        except Exception as e:
+            QMessageBox.critical(self, "RGB Combination", f"Failed to combine:\n{e}")