SirilProcessing

The aim of the scripts I develop is to ease my processing with Siril.

Scripts

darklibupdate.py

A script to create and maintain a library of master dark frames. It groups dark frames by camera, temperature, exposure time, gain, and binning, then stacks them using Siril to create master darks.

Note: This script can also handle bias frames, as the only difference between darks and bias is the exposure time. Bias frames (0s exposure) will be automatically grouped separately from dark frames.

Features:

• Automatic grouping of dark frames by metadata (camera, temperature, exposure, gain, binning)
• Smart update logic based on date, stacking parameters, and dark count thresholds
• Dark frame validation with robust statistical analysis to detect problematic frames
• Flexible update criteria with configurable minimum dark count thresholds
• Comprehensive reporting with detailed validation and processing statistics
• Support for multiple Siril execution modes (native, flatpak, appimage)
• Configuration persistence to save user preferences
• Age-based filtering to exclude old dark frames
• Temperature precision control for grouping similar temperatures
• Interrupt handling for clean cancellation with Ctrl+C

Library

The lib/ directory contains shared modules used by both scripts:

• fits_info.py: FITS file metadata handling
• config.py: Configuration management
• siril_utils.py: Siril script execution utilities

See lib/README.md for more details.

Requirements

pip install -r requirements.txt

Main dependencies:

• astropy: For FITS file handling

Usage

Dark Library (also handles Bias frames)

Basic Usage

# Create master darks from input directories
python3 bin/darklibupdate.py --input-dirs /path/to/darks1 /path/to/darks2

# Process bias frames (0s exposure) along with darks
python3 bin/darklibupdate.py --input-dirs /path/to/darks /path/to/bias

# List existing master darks with details
python3 bin/darklibupdate.py --list-darks

# Test mode (analyze files but don't execute Siril)
python3 bin/darklibupdate.py --input-dirs /path/to/darks --dummy

Advanced Features

# Enable dark frame validation to detect problematic frames
python3 bin/darklibupdate.py --input-dirs /path/to/darks --validate-darks

# Set minimum dark count threshold for updates
python3 bin/darklibupdate.py --input-dirs /path/to/darks --min-darks-threshold 20

# Generate detailed processing and validation report
python3 bin/darklibupdate.py --input-dirs /path/to/darks --report

# Set temperature precision for grouping (default 0.5°C)
python3 bin/darklibupdate.py --input-dirs /path/to/darks --temperature-precision 0.2

# Save current configuration for future use
python3 bin/darklibupdate.py --input-dirs /path/to/darks --validate-darks --min-darks-threshold 15 --save-config

# Force recalculation of all master darks
python3 bin/darklibupdate.py --input-dirs /path/to/darks --force-recalc

Key Options

• --validate-darks: Enable statistical validation to reject problematic dark frames
• --min-darks-threshold N: Only update master darks if ≥N darks available and date is newer
• --report: Generate comprehensive processing and validation report
• --temperature-precision X: Set temperature grouping precision in °C
• --max-age N: Limit dark frame age to N days from newest frame
• --save-config: Save current settings as defaults

For more options, use --help.

Documentation

User Documentation

• Complete Guide - Comprehensive user documentation (French)
• Technical Documentation - Developer and advanced user documentation

Key Technical Documents

• Dark Frame Validation - Minimum dark count threshold feature
• Absolute Paths Management - Automatic path conversion for robust configuration
• Validation Optimization - Conditional validation logic
• Robust Statistics - MAD-based validation methods
• Configuration Guide - Persistent configuration options