Release v0.8a4

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: ivh

CHANGELOG.md

@@ -1,6 +1,26 @@
 # Changelog
 
 
+## [0.8a4] - 2026-02-14
+
+### Added
+- HARPSPOL instrument with dual-beam (Wollaston prism) support
+- Otsu+DP beam-pair detection for multi-fiber trace pairing
+- `--use` CLI flag to select fiber groups (e.g., `--use upper,lower`)
+- Wavelength propagation from trace into extracted Spectrum
+
+### Changed
+- Output files go into per-night subdirectory (`reduced/{night}/`)
+- Group filenames use `{prefix}_{group}.{step}.{ext}` convention
+- Traces without order_centers get sequential m values (was None)
+
+### Fixed
+- Fix `create_image_from_lines` row count (use ntrace, not order range)
+- Fix 2D wavecal polynomial eval: use trace index, not physical order m
+- Fix multi-channel filename overwrite (include channel in science/rectify)
+- Fix linelist order drift across re-runs (normalize to 0-based on save)
+- Fix output_dir CLI default (None, so config's `reduced/{night}` is used)
+
 ## [0.8a3] - 2026-02-11
 
 ### Changed

docs/cli.md

@@ -44,6 +44,7 @@ uv run reduce run INSTRUMENT [OPTIONS]
 | `--plot-show` | | Display mode: block, defer, or off |
 | `--order-range` | | Order range to process (e.g., "1,21") |
 | `--settings` | | JSON file with settings overrides |
+| `--use` | | Fiber group(s) to reduce (e.g., "upper" or "upper,lower") |
 
 **Examples:**
 
@@ -193,15 +194,18 @@ PyReduce expects the following directory structure:
 $REDUCE_DATA/
   INSTRUMENT/
     raw/
-      *.fits         # Input FITS files
-    reduced/
-      *_bias.fits    # Master bias
-      *_flat.fits    # Master flat
-      *.traces.fits  # Traces and extraction heights
-      *.science.fits # Extracted spectra
-      *.final.fits   # Final output
+      *.fits                    # Input FITS files
+    reduced/{night}/
+      {inst}_{chan}.bias.fits   # Master bias
+      {inst}_{chan}.flat.fits   # Master flat
+      {inst}_{chan}.traces.fits # Traces and wavelength polynomials
+      *.{chan}.science.fits     # Extracted spectra
+      *.{chan}.final.fits       # Final output
 ```
 
+For multi-fiber instruments, group-specific files use the pattern
+`{inst}_{chan}_{group}.{step}.{ext}` (e.g., `harpspol_blue_upper.linelist.npz`).
+
 The base directory can be set via:
 1. `--base-dir` option
 2. `REDUCE_DATA` environment variable

docs/wavecal_linelist.md

@@ -170,19 +170,19 @@ trace step
 wavecal_master step
   └─ reads traces.fits
   └─ extracts calibration lamp spectrum per fiber group
-  └─ writes wavecal_master.{group}.fits
+  └─ writes {prefix}_{group}.wavecal_master.fits
 
 wavecal_init step
   └─ reads wavecal_master output
   └─ identifies lines by matching peaks to atlas
-  └─ writes linelist.{group}.npz
+  └─ writes {prefix}_{group}.linelist.npz
 
 wavecal step
-  └─ reads linelist.{group}.npz (from wavecal_init or previous wavecal run)
+  └─ reads {prefix}_{group}.linelist.npz (from wavecal_init or previous wavecal run)
   └─ reads wavecal_master output
   └─ reads traces.fits
   └─ aligns, refines positions, fits 2D polynomial
-  └─ overwrites linelist.{group}.npz with refined linelist
+  └─ overwrites {prefix}_{group}.linelist.npz with refined linelist
   └─ updates traces.fits with wavelength polynomials (Trace.wave, Trace.m)
 
 science step

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pyreduce-astro"
-version = "0.8a3"
+version = "0.8a4"
 requires-python = ">=3.13"
 description = "A data reduction package for echelle spectrographs"
 readme = "README.md"