Repository navigation
v0.2.2-alpha
Pre-releaseOPIPP 0.2.2-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.2-alpha-win-x64.zip |
| Size | 53541398 bytes |
| SHA-256 | f0e459f2371488eeb2d271c4c8b3da9d0e772361bf09f2d45989706dd57af5fe |
| Tag | v0.2.2-alpha |
| Commit | c06fe53 |
| Workflow run | https://github.com/openpipp/opipp/actions/runs/40060092637 |
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.2
This release is about evidence: real captures, measured memory, and the working path for raw Bayer
data. No integration arithmetic changed.
Real-capture validation
Integration was run on captures that are not Saturn-2016 or synthetic:
| Capture | Object / date | Result |
|---|---|---|
| Slooh AVI, 49 extracted frames | Jupiter + Ganymede, 2011-09-08 | joined mean → one 640×480 colour image; visually clean disc and moon |
| Strata SER, 200-frame subset of 8,984 | Saturn, 2022-10-25 | raw CFA + centring rejected as designed; -db + mean → one 619×598 colour image in ~3 s, clean rings and globe |
| Strata TIFF | Jupiter, 2023-11-02 | conversion correct (IR685 green cast expected) |
| Wikimedia stills | Moon (2010) and Mars (2003) | PNG→FITS→PNG and PNG→TIFF round-trips correct |
Two real input gaps were found and are documented rather than hidden: the Slooh AVI is I420
(planar YUV), and an ffmpeg rawvideo bgr24 AVI reports its first frame as truncated. Both are
rejected with clear messages; extracting PNG frames is the current workaround. See
docs/validation.md for sources, licences and commands.
Debayer guidance
A raw mosaic can only move by whole pixels without changing its CFA phase, and centring commonly
produces odd shifts. The help section and every Bayer-phase error now say so and name -db /
-db=<pattern> and the GUI's "Debayer Monochrome Frames" option, instead of only saying "debayer".
A fixture-gated regression runs the real Saturn capture both ways: rejection without -db, one
correct colour image with it, and a plain 30-frame conversion as control.
Measured memory
tools/Opipp.IntegrationProbe runs each configuration in its own process and samples peak working
set every 20 ms. Measured on this machine (i5-13600K, 128 GB, .NET 10.0.13):
| Case | Route | Peak working set |
|---|---|---|
| 300 × 512×256 mono8 mean, spilled | streaming | 46 MB |
| 300 × 512×256 mono8 median, spilled | streamed | 89 MB |
| 100 × 1920×1080 RGB16 median | in memory | 2,476 MB |
| 200 × 1920×1080 RGB16 median, 4 GB scratch | tiled | 11,679 MB |
Two honest findings: the in-memory median holds two copies of the selection (2.5 GB for 1.2 GB
of frames), and the tiled route's process peak is dominated by allocation churn (6,800 temporary
full-frame buffers), even though live data is ~2.5 GB. The default 512 MiB scratch budget refuses
the 200-frame case before writing anything. docs/memory.md records all numbers and commands.
Run-owned staging
Integration stages inside <output>/.opipp-staging/<run-guid>/ and deletes that directory on
success, failure or cancellation. A later run removes stale GUID directories older than an hour;
nothing outside .opipp-staging is enumerated, so an operator's files are never at risk. The GUI's
stale comments about a flat .integrating file were corrected; it still deletes only registered
paths.
Cancellation and restart
The GUI reused a single Process object for every run. After a cancel, that object's stdin pipe was
already disposed, so the next run could fail at launch with "The pipe is being closed" — a supported
workflow (cancel, then try again) broken by resource reuse. Each run now creates a fresh process,
restores the SynchronizingObject the designer had set (without it, engine callbacks arrive on pool
threads and the transcript verdict races the form), and a shutdown exception while a run is being
cancelled keeps the verdict CANCELLED instead of being re-labelled a start failure. The cancellation
test now uses a long-enough selection for Cancel to end the run, and its assertion reports the
engine's exit code, output and captured errors if it ever diverges.
Verification
- 1,324 tests, 0 failures, nine projects.
- Parity unchanged: 27 compared, 27 matched, 2 deliberate differences, 0 gaps.
- Real-capture outcomes reproduced from the built CLI; images inspected, not just exit codes.
Known limits
- No sigma-clipped or robust rejection yet; that is the 0.3.0 milestone.
- In-memory median holds two copies of the selection; tiled median's process peak grows with
allocation churn even though live memory stays bounded. - AVI input: I420/planar YUV and ffmpeg rawvideo layouts are not supported.
- Integration output is still quantised to the input depth; no float FITS delivery.
- No lunar or solar sequence validation yet; Moon/Mars coverage is stills only.
OPIPP 0.2.2-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.2-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/40060092637
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
f0e459f2371488eeb2d271c4c8b3da9d0e772361bf09f2d45989706dd57af5fe OPIPP-0.2.2-alpha-win-x64.zip