Skip to content

v0.2.0-alpha

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 20 Oct 04:16
· 5 commits to main since this release

OPIPP 0.2.0-alpha (Open PIPP) - Windows x64

Self-contained alpha build of the managed PIPP continuation. It was built and
tested, packaged, and smoke-tested from the extracted zip by the tag-triggered
release workflow before this release was created.

Artifact OPIPP-0.2.0-alpha-win-x64.zip
Size 53531333 bytes
SHA-256 dc215f47d1f0a175083e95a4928a902f3c98458034f0aaf7be76d892da3fa65b
Tag v0.2.0-alpha
Commit 21cb533
Workflow run https://github.com/openpipp/opipp/actions/runs/39368574850

Package contents

  • Opipp.App.exe - the GUI, fully managed, no pipp_dll.dll
  • Opipp.Cli.exe - the command-line engine, drop-in for pipp_core.exe
  • README-ALPHA.txt - quick start, status and licence notes

Status and licence

ALPHA: a working preview, not an official PIPP release, and not affiliated
with Chris Garry or the PIPP project. AI was used to build this. GPLv3 or
later for this repository's code and artwork; not a licence to PIPP. See
NOTICE in the repository.

What changed in 0.2.0

Final-image integration is now a first-class operation. Joining captures, building calibration
masters and integrating science frames are three separate things, and the third one is finally
reachable without writing code.

User-facing

  • CLI: -stack=mean|sum|median produces one final image. -stack_coverage=crop|canvas chooses
    whether the output is cropped to the region every frame can fill (default) or keeps the first
    frame's canvas. -stack_subpixel=on|off controls fractional registration (default on). These are
    OPIPP extensions; the original pipp_core.exe exits 127 on them.
  • GUI: Processing → Final image integration… offers the same three choices and shows the
    current setting in the transcript when a run starts. Ordinary runs emit exactly the same switches
    and transcripts as before.
  • Result: exactly one file per run, written under a staging name and moved into place only after
    success, so a cancelled or failed integration leaves nothing that looks finished.

Registration and borders

  • Each frame's alignment offset is applied by the integrator. The whole-pixel part is exact; the
    fractional part is bilinear, and mean, sum and median share one sampler so they register
    identically.
  • Coverage is counted per pixel. crop intersects the valid regions (a bilinear tap loses a border
    column on the side it samples from) and returns that rectangle; canvas keeps the first frame's
    canvas and reports zero-coverage pixels rather than filling them with invented data.

Precision

  • Accumulation is double. IntegrationResult.PrecisionSamples exposes it: a mean of 100 and 101 is
    exactly 100.5 there. The delivered image is quantised to the input depth with half-away-from-zero
    rounding and clamping; sum clamps at the depth maximum. Float FITS output is not implemented yet.

Median at scale

  • Median up to 64 frames stays in memory. Above that, every frame is spilled once and the image is
    produced in horizontal bands, sorting each pixel's contributors per band. Memory is bounded by the
    band, not the selection, and the result is exact: 65 and 1,000-frame cases match an independent
    per-pixel reference. The scratch budget is declared and exceeded budgets fail clearly.

Correctness around integration

  • Mixed Bayer phases, mixed geometry or depth, a colour frame with a CFA tag, and non-uniform weights
    under median are all rejected before any sample, count or provenance changes.
  • Contributors (source, weight, applied shift) and per-pixel coverage are reported with the result;
    the output frame keeps the contributing source's identity.
  • Cancellation is checked per band and per frame read; no partial output or spill file survives.

Verification

  • 1,164 tests, 0 failures across nine projects.
  • Native parity unchanged: 27 compared, 27 matched, 2 deliberate differences, 0 gaps.
  • Reproduced end-to-end from the built CLI: mean of a joined 5 and 6 writes 6; mean of 100 and 101
    writes 101; median of 10/20/30 writes 20; mixed-CFA join exits 1 with no file; unknown method exits 2.

Known limits

  • No sigma-clipped or robust rejection; every selected frame contributes.
  • Alignment is subpixel translation only; no rotation, drizzle or local warping.
  • Integration output is quantised to the input depth (double intermediate, integer delivery).
  • Median above the cap trades speed for bounded memory; it is exact, not approximate.
  • Surface-feature tracking remains 23/30 on one fixture; unequal-frame native master goldens are
    still missing.

OPIPP 0.2.0-alpha (Open PIPP) - Windows x64

An independent, fully managed continuation of PIPP (Planetary Imaging
PreProcessor). ALPHA: a working preview, not an official PIPP release.

NOT AFFILIATED WITH PIPP. Not affiliated with, endorsed by or supported by Chris
Garry or the PIPP project. New C# code, no original binaries redistributed.
Published in the belief that this is fair use.

AI was used to build this and will keep being used. Behaviour claims are backed
by tests or parity cases; unverified items are listed as known gaps.

What is in this folder
Opipp.App.exe the GUI (managed; no native pipp_dll.dll needed)
Opipp.Cli.exe the command-line engine, drop-in for pipp_core.exe

Quick start
GUI: double-click Opipp.App.exe
CLI: Opipp.Cli.exe -help
Opipp.Cli.exe -tif -od=C:\out capture.ser

Status
Built automatically from tag v0.2.0-alpha by the release workflow after the
full test suite passed. This exact zip was extracted and smoke-tested
(a generated SER file converted to TIFF) before the release was published.
Parity against the original PIPP engine is not run in CI because it needs
the original binaries, which are not redistributable; see docs/parity.md
and docs/status.md at the tagged commit for the accounting and known gaps.
Workflow run: https://github.com/openpipp/opipp/actions/runs/39368574850

Licence
GPLv3 or later for this repository's code and artwork. Not a licence to PIPP.

Requires Windows 10/11 x64. Self-contained: no .NET installation needed.

Checksum

dc215f47d1f0a175083e95a4928a902f3c98458034f0aaf7be76d892da3fa65b  OPIPP-0.2.0-alpha-win-x64.zip