Skip to content
GMST --h --m --s FR / EN
Stable Calibration

Dark Frame Analyzer

Analyses your dark-frame series and rejects out-of-spec frames before WBPP stacking.

Download ↗ Source code (GitHub) ↗ Documentation ↗

Overview

A bad dark silently degrades your master dark, and everything calibrated with it. Dark Frame Analyzer inspects a whole series at once: for each subframe it computes robust statistics (clipped median, exact MAD, hot pixels, saturation, thermal drift, spatial uniformity) through PixInsight's C++ engine (a 50-frame series is analysed in seconds), then compares every frame against the series reference. Each dark is graded Valid, Alert or Rejected in a colour-coded table, with a detailed console report, a CSV export and a WBPP-ready exclusion list (or one click to move rejects to a subfolder). Outlier detection ships anti-quantisation floors for CMOS sensors whose distribution is peaked by ADC discretisation. Thresholds, pre-tuned for an IMX585-class sensor, are all adjustable and remembered across sessions. Bilingual FR/EN interface, FITS and XISF input.

Features

Robust outlier detection

Series-relative statistics (clipped median, exact MAD, hot pixels, thermal drift, spatial uniformity) with anti-quantisation floors: ADC steps never become false positives.

Native speed

Histograms and converged iterative sigma clipping computed by PixInsight's C++ engine: a 50-frame series is analysed in seconds.

WBPP-ready workflow

Exclusion list as text or file, or one click to move rejected frames to a subdirectory WBPP never sees.

Full reporting

Colour-coded results table with per-frame tooltips, detailed console report and CSV export with stable machine-readable headers.

Tunable, persistent thresholds

Every detection threshold is adjustable, remembered across sessions and restorable in one click (presets tuned for an IMX585-class sensor).

Bilingual UI

English and French, switchable live, choice remembered. FITS and XISF input.

Screenshots

Dark Frame Analyzer main window: analysed dark series, colour-coded Valid/Alert/Rejected statuses and detection thresholds
WBPP exclusions dialog: list of darks to keep out, .txt export or move to a rejected/ folder

Install

  1. 01

    Add the CaeloWorks repository

    In PixInsight, open Resources → Updates → Manage Repositories and add the URL https://pixinsight-scripts.caelo.works/update/

  2. 02

    Check for updates

    Run Resources → Updates → Check for Updates and accept: PixInsight downloads and installs the script.

  3. 03

    Restart PixInsight

    Relaunch the application: the script shows up in the Script menu. Future updates then arrive automatically.

Once installed, the script shows up under Script → Utilities → Dark Frame Analyzer. Manual alternative: download DarkFrameAnalyzer.js from the GitHub releases and add its folder through Script → Feature Scripts. Requires PixInsight 1.9+, Windows, macOS or Linux.

Changelog

  • 1.8.0 2026-07-02

    First public release (GPL-3.0).