Skip to content

v0.3.0-alpha

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 28 Oct 06:21

OPIPP 0.3.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.3.0-alpha-win-x64.zip
Size 53557567 bytes
SHA-256 68f6392555b9221ebb012237b6db3be024cf8d8ce50ff2a1d40022dd9f8c0f10
Tag v0.3.0-alpha
Commit b6c858d
Workflow run https://github.com/openpipp/opipp/actions/runs/40643034911

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.3.0

Field-rotation correction

PIPP has no field-rotation correction. Its only rotation is the fixed 90/180/270 family, and every
alignment path (-ctr, surface-feature tracking, -ctrf, stabilisation) produces translation. A
rotating capture therefore smears with radius: on a 30-frame lunar sequence at 0.05°/frame,
translation-only stacking kept 26% of the single-frame edge sharpness; at 4°/frame it kept 2.6%.
That is the blurry limb reported after a minute of handheld lunar video.

Final-image integration now accepts an OPIPP extension:

-derotate=on                 correct field rotation (default off)
-derotate_search=<deg>       search range either side of frame 0 (default 5, 0.1..45)

Both require -stack=. With the switch off, or absent, output is byte-identical to before.

The stage estimates each frame's angle against frame 0 by normalised cross-correlation on luma —
both images rotated by ±θ/2 so resampling does not favour either side, the full surviving rectangle
scored, 256 px working side, sub-pixel translation, and a predicted search window that widens once
at the edge. It then rotates with a bicubic Keys kernel (a = -1.0), crops every frame to one
centred rectangle all rotations can fill, and finishes with a correlation offset (below 0.05 px is
treated as zero). Mean, sum and median all work because the frames stay rectangular.

Measured on real lunar texture, outer-annulus Laplacian variance:

Sequence Translation-only Derotated Gain
1.45° total rotation 411.7 994.4 2.42×
116° total rotation 40.3 866.0 21.5×
40 frames, 2.34° rotation plus 5 px handheld drift 34.2 (-ctr: 268.4) 813.3 mean, 828.0 median 23.8× plain, 3.0× centred
identical stills 1567.4 1567.4 unchanged (diff 0.0000)

Angle error averages 0.039°, max 0.13°. The mild 1.45° case is the weakest and misses an internal
2.5× target by 3%; realistic handheld rotation is larger, where the gain is an order of magnitude.

GUI: Processing → Final image integration… → Correct field rotation (derotate), persisted as
FINAL_IMAGE_DEROTATE and FINAL_IMAGE_DEROTATE_SEARCH.

Limits: in-plane rotation only; the rotation must be observable (a featureless or perfectly
symmetric disc estimates 0°); -derotate_search bounds the search; cropping shrinks the canvas
(512² → 499² at 1.45°, 640×480 → 575×431 at 5°); raw Bayer frames are refused with -db guidance;
derotated median re-rotates per band and costs more than mean.

Tests and docs

1,446 tests, 0 failing. New coverage: rotation estimation accuracy against analytic truth, crop
containment, bicubic-versus-bilinear margin, correlation offsets against a known shift, fast
rotation (4°/frame), still-sequence equivalence, CLI parsing and error taxonomy, GUI settings,
persistence and a form-to-engine run. docs/derotation.md records the verification, algorithm,
measurements and limits.

OPIPP 0.3.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.3.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/40643034911

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

68f6392555b9221ebb012237b6db3be024cf8d8ce50ff2a1d40022dd9f8c0f10  OPIPP-0.3.0-alpha-win-x64.zip