Skip to content

Add quick start guide for batch processing workflow#79

Open
jewzaam wants to merge 3 commits into
jewzaam:mainfrom
thelenorith:claude/document-batch-scripts-ykPIF
Open

Add quick start guide for batch processing workflow#79
jewzaam wants to merge 3 commits into
jewzaam:mainfrom
thelenorith:claude/document-batch-scripts-ykPIF

Conversation

@jewzaam

@jewzaam jewzaam commented Feb 15, 2026

Copy link
Copy Markdown
Owner

Summary

This PR adds comprehensive documentation for setting up and running the astrophotography processing pipeline using Windows batch scripts. The new quick start guide provides step-by-step instructions for configuring and executing the three-phase workflow.

Key Changes

  • New Quick Start Guide (docs/quick-start.md): Complete walkthrough covering:

    • Prerequisites and workflow overview with visual flowchart
    • Script layout and directory structure
    • Detailed configuration instructions for shared and per-rig settings
    • Threshold guidance for culling poor frames based on focal length
    • Phase-by-phase breakdown with example batch scripts
    • Instructions for managing multiple rigs with a shared calibration library
    • Dry-run testing recommendations
  • Updated Documentation Index (docs/index.md): Added link to the new quick start guide

  • Updated README (README.md): Added reference to quick start guide in documentation section

Notable Details

The guide includes:

  • Concrete examples for two different rigs (C8E and SQA55) showing how configuration varies by focal length
  • Complete, copy-paste-ready batch script examples for all three workflow phases
  • Clear explanation of the manual blink review step between automated phases
  • Guidance on choosing appropriate culling thresholds (RMS and HFR) for different equipment
  • Instructions for adding, deactivating, and managing multiple rigs sharing a single calibration library

https://claude.ai/code/session_01KSYcbGLfeCyxK2J8hQE9fF

Documents the three-phase workflow (prepare-for-blink, blink review,
post-blink) with template Windows batch scripts. Introduces a per-rig
configuration pattern using separate .bat files so rig-specific paths
and culling thresholds are isolated from the shared pipeline scripts.

https://claude.ai/code/session_01KSYcbGLfeCyxK2J8hQE9fF
Extract the inline batch script examples from quick-start.md into
standalone .bat files under templates/ so they can be copied and
customized directly. The quick start guide now links to the template
files instead of embedding the full script contents.

templates/
├── config.bat              # Shared paths and settings
├── rigs/
│   ├── example-rig1.bat    # Longer FL rig example
│   └── example-rig2.bat    # Shorter FL rig example
├── 01-prepare-for-blink.bat
└── 02-post-blink.bat

https://claude.ai/code/session_01KSYcbGLfeCyxK2J8hQE9fF
Adding the templates/ directory caused setuptools to find multiple
top-level packages (standards, templates) and refuse to build.
Explicitly set packages=[] since ap-base has no Python packages.

https://claude.ai/code/session_01KSYcbGLfeCyxK2J8hQE9fF
@thelenorith thelenorith force-pushed the claude/document-batch-scripts-ykPIF branch from de6a7d8 to ffc8995 Compare February 15, 2026 15:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants