Release 1.1.4: replace noisy preview modes with patch denoising and fixed stretch
All checks were successful
Release AstroFrame / packages (push) Successful in 59s

This commit is contained in:
Elijah 2026-10-04 14:27:04 -07:00
parent d3362c8341
commit b8ffe97c46
17 changed files with 143 additions and 270 deletions

View file

@ -57,11 +57,11 @@ Version 1.1.0 selects up to 16 workers from CPU capacity, leaving two logical pr
Small JSON metadata stores decisions, notes, evidence and compact masks. Binary versioned caches hold stars, sky maps and forced photometry, validated against source size and modification time and reference identity. A new engine version invalidates analysis without losing human labels. Repeated analysis uses cached measurements and forced apertures when valid. Project writes replace a temporary file atomically. Cancellation leaves analysis incomplete and export disabled.
Display caches have a separate version. They contain compressed, linear, area-averaged thumbnails rather than a permanently stretched byte image. **Frame view** retains its noise-aware black point and adjustable median brightness. **Nebula view** applies a 3×3 median and four separable binomial smoothing passes at the existing thumbnail dimensions, suppressing small stars and noise while retaining faint filaments. Its black point also includes the lower background percentile, and its median is displayed slightly brighter. **Asinh view** applies an adjustable inverse-hyperbolic-sine transfer to this same smoothed plane, with a brightness-adjusted gamma fallback when its normalized median already exceeds the requested brightness.
Display caches have a separate version. They contain compressed, linear, area-averaged thumbnails rather than a permanently stretched byte image. **Frame view** retains its noise-aware black point and adjustable median brightness. **Denoised** is the only alternative. It performs non-local means on the linear thumbnail using 5×5 patches, a 13×13 search window, reflected borders, noise-bias subtraction and a filter strength of 0.8 times the estimated noise sigma. Its black point, white point and normalized median come from the original thumbnail; they are never recomputed from the denoised result. This prevents the stretch from amplifying residual noise after denoising. It adds 0.07 to the requested display median, matching the approved samples' default brightness of 0.25 at slider value 0.18.
**Color nebula** reads recognized RGGB, GRBG, GBRG or BGGR Bayer layouts and their offsets through a separate streaming display reader. It bins linear RGB superpixels, uses the same diffuse luminance preview, neutralizes each channel's median sky, smooths chroma and suppresses departures consistent with noise. A linked channel scale limits saturation and preserves neutral black and white highlights. Color is approximate and uncalibrated; no color is invented for monochrome or unknown Bayer layouts, which show the grayscale nebula preview with an explanatory label. Color has a separate fingerprinted linear cache generated only on demand. Neither display reader changes the monochrome analysis path, classifications, or original FITS files.
The previous Nebula, Asinh and Color nebula modes are removed. The denoised result stays in the selected viewer's memory and is computed only when requested. It needs no new disk cache or FITS reader and works on monochrome and Bayer-derived grayscale thumbnails alike. Existing linear caches remain compatible, and existing color caches are simply unused. The analysis path, classifications and original FITS files are unaffected.
Prepared display statistics are cached in the viewer so slider changes remain responsive. Disk loading and first-time thumbnail creation run off the UI thread, with cancellation and a single preview-loading gate preventing queued FITS reads during rapid navigation. Both comparison panes use the selected mode and shared zoom/pan. Old projects regenerate only requested displays on demand. Single-frame previews cannot recover signal absent from the exposure and can remain noisy; these are human-readable viewing aids, not stacked images.
Prepared display statistics and the denoised plane are retained in the viewer so slider changes remain responsive. Loading and denoising run off the UI thread, with cancellation, atomic memory reservations and a single preview-loading gate preventing queued work during rapid navigation. The original Frame preview remains available while denoising runs. Both comparison panes use the selected mode and shared zoom/pan. Old projects regenerate only requested displays on demand. Denoising is a viewing aid and may soften weak detail; Frame view and source-star inspection remain available for judging unfiltered morphology.
The preview is not an input to classification. Source-star inspection reads two originals, maps identical stars through their stored alignment, and displays enlarged source superpixels without interpolation. Crops are independently normalized to judge morphology. See [Siril's screen-transfer discussion](https://siril.readthedocs.io/en/latest/processing/stretching.html) for the distinction between display stretching and linear image data.