Package index • sagui

Core segmentation

Exact and sparse photometric SED segmentation, plus region-count selection.

segment_regions(): Segment photometric regions from a spectral cube
segment_regions_large(): Segment photometric regions from large spectral cubes
choose_ncomp_by_snr(): Choose the Number of SAGUI Regions from a Target S/N

Cube conversion, display transforms, masking, and spectrum transforms.

cube_to_matrix(): Flatten a spectral cube into a pixel-by-band matrix
collapse_white_light(): Collapse a spectral cube into a white-light image (robust, weighted)
mask_cube(): Mask a 3D cube by a spatial label map
pretransform_cube(): Apply a spectral pretransform to a full cube
pretransform_spectra(): Apply a spectral pretransform before segmentation
median_scale(): Center a spectrum by its median
asinh_stretch(): Asinh-stretch an image or numeric array

Multiscale support builders and mask refinement.

build_starlet_mask(): Build a starlet-based segmentation mask from a spectral cube
starlet_mask(): Starlet (à trous) decomposition
starlet_reconstruct(): Reconstruct from a subset of starlet scales
b3_kernel(): B3-spline low-pass kernel (1D)
upsample_kernel(): Insert zeros between kernel taps
build_adaptive_support(): Build an adaptive multi-band support mask
build_contourlet_mask(): Build a contourlet-like directional support mask from a spectral cube
clean_segmentation_mask(): Clean a logical segmentation support mask
threshold_starlet_regions(): Reconstruct and threshold starlet scales to produce a region mask

Flux-preserving regional photometry and background summaries.

RegionPhotometry(): Region-level photometry on hyperspectral cubes (no background subtraction)
extract_region_sed(): Extract integrated SEDs for segmented regions
summarize_region_sed(): Summarize integrated SEDs for segmented regions
estimate_bkg_mad_per_lambda(): Robust per-wavelength background and scatter

Categorical maps, region properties, relabelling, and smoothing.

plot_region_map(): Plot a segmented region map with dissolved Voronoi-style polygons
plot_region_property_map(): Plot a region property map in Voronoi-style polygons
plot_region_property_raster(): Plot a region property map on a pixel grid
reindex_regions(): Reindex positive region labels to a compact sequence
fill_region_holes(): Fill zero-valued holes inside each labeled region
filter_regions_by_size(): Filter regions by pixel count
reject_background_regions(): Reject background-like regions after segmentation
smooth_region_field_laplacian(): Smooth region values over an adjacency graph

Optional candidate detection and diagnostic helpers.

detect_sed_clumps(): Detect compact SED-clump seeds
segment_clumps(): Segment compact SED clumps and the diffuse galaxy body
segment_clump_profiles(): Split clump footprints into internal profile regions
compute_clump_score(): Compute a compact SED-clump score
clump_evidence_table(): Summarise evidence for candidate clumps
grow_clump_footprints(): Grow clump seeds into compact footprints
plot_clump_diagnostics(): Plot clump-segmentation diagnostics