Repository navigation
v0.2.0-alpha
Pre-releaseOPIPP 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|medianproduces one final image.-stack_coverage=crop|canvaschooses
whether the output is cropped to the region every frame can fill (default) or keeps the first
frame's canvas.-stack_subpixel=on|offcontrols fractional registration (default on). These are
OPIPP extensions; the originalpipp_core.exeexits 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.
cropintersects the valid regions (a bilinear tap loses a border
column on the side it samples from) and returns that rectangle;canvaskeeps the first frame's
canvas and reports zero-coverage pixels rather than filling them with invented data.
Precision
- Accumulation is
double.IntegrationResult.PrecisionSamplesexposes 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