Skip to content

index.md

Latest commit

 

History

History
125 lines (94 loc) · 4.23 KB

index.md

File metadata and controls

125 lines (94 loc) · 4.23 KB
Raw

Astrophotography Pipeline Documentation

A modular Python toolkit for processing and managing astrophotography data captured with NINA (Nighttime Imaging 'N' Astronomy).

Overview

This pipeline provides a comprehensive workflow for processing astrophotography data from raw capture through organization, quality control, calibration frame management, and archiving. The tools are designed to work together while remaining independently useful.

flowchart TB
    subgraph Capture
        NINA[NINA Capture]
    end

    subgraph Processing["Processing Pipeline"]
        PH[ap-preserve-header]
        ML[ap-move-raw-light-to-blink]
        CL[ap-cull-light]
        MC[ap-create-master]
        MV[ap-move-master-to-library]
        CP[ap-copy-master-to-blink]
        MD[ap-move-light-to-data]
    end

    subgraph Storage["Storage"]
        BLINK[10_Blink Directory]
        CAL[Calibration Library]
        DATA[20_Data Directory]
    end

    NINA --> PH
    PH --> ML
    PH --> MC
    ML --> CL
    CL --> BLINK
    MC --> MV
    MV --> CAL
    CAL --> CP
    BLINK --> CP
    CP --> MD
    MD --> DATA

    classDef processStyle fill:#e1f5ff,stroke:#0066cc,stroke-width:2px
    classDef dataStyle fill:#fff4e6,stroke:#ff9800,stroke-width:2px

    class PH,ML,CL,MC,MV,CP,MD processStyle
    class NINA,BLINK,CAL,DATA dataStyle
Loading

Tools

Tool Purpose
ap-common Shared utilities for data handling
ap-move-raw-light-to-blink Organize light frames by metadata
ap-cull-light Quality control filtering
ap-empty-directory Directory cleanup utility
ap-preserve-header Preserve path metadata in FITS headers
ap-create-master Generate master calibration frames
ap-move-master-to-library Organize calibration library
ap-copy-master-to-blink Copy masters from library to blink
ap-move-light-to-data Move lights when calibration available

Quick Start

Installation

All tools can be installed from git:

python -m pip install git+https://github.com/jewzaam/ap-move-raw-light-to-blink.git
python -m pip install git+https://github.com/jewzaam/ap-cull-light.git
python -m pip install git+https://github.com/jewzaam/ap-empty-directory.git
python -m pip install git+https://github.com/jewzaam/ap-move-light-to-data.git
python -m pip install git+https://github.com/jewzaam/ap-preserve-header.git
python -m pip install git+https://github.com/jewzaam/ap-create-master.git
python -m pip install git+https://github.com/jewzaam/ap-move-master-to-library.git
python -m pip install git+https://github.com/jewzaam/ap-copy-master-to-blink.git

The ap-common package is installed automatically as a dependency.

Basic Workflow

# 1. Move light frames from raw capture to organized structure
python -m ap_move_raw_light_to_blink /raw/capture /data

# 2. Cull poor quality frames
python -m ap_cull_light /data/10_Blink /reject --max-hfr 2.5 --max-rms 2.0

# 3. Preserve path metadata in FITS headers
python -m ap_preserve_header /data --include CAMERA OPTIC FILTER

# 4. Generate master calibration frames
python -m ap_create_master /raw/calibration /output --pixinsight-binary "/path/to/PixInsight"

# 5. Organize calibration library
python -m ap_move_master_to_library /output/master /calibration_library

# 6. Clean calibration output directory
ap-empty-directory /output --recursive

# 7. Copy masters from library to blink directories
python -m ap_copy_master_to_blink /calibration_library /data/equipment/10_Blink

# 8. Move lights to data when calibration available
python -m ap_move_light_to_data /data/equipment/10_Blink /data/equipment/20_Data

Documentation

Requirements

  • Python 3.10+
  • PixInsight (for master calibration generation)
  • NINA (for image capture - not part of this toolkit)

License

Apache-2.0