Current release: see the project home page; koprgit.py publishes the canonical repository release identity there. The structural baseline is R515/C8: all active implementation is canonical under src/kopr/; root Python files are compatibility/source-launcher surfaces only.

Developer documentation

Architecture, numerical algorithms, performance boundaries, regression strategy and maintained integration contracts for the current KOPR Python 3 source line.

Core chapters

Architecture

Runtime entry point, module ownership, state, workers and scientific boundaries.

Open architecture

Algorithms

Calibration, astrometry, stacking, photometry and scientific transformations.

Open algorithms

Testing

Release gates, regression families and required target-system acceptance.

Open testing

WStack integration

Host callbacks, settings mapping, matched-stack contracts and rebase policy.

Open integration contract

Architecture and performance foundations

WPlanner

R130 bounded execution/persistence foundation plus R255 source roles, accepted-row-only final N-body refinement and immutable map-scene export.

R130 performance foundation · Planner source-role & maps

WLightCurves

R144 one-tab runtime, R149 target-aware formula documents and R179 draft/Refresh/Save/Analyse transaction separation.

Open Comet Analyzer architecture · Formula documents · Formula transactions & Qt gate

Modal ephemeris

R121 scientific profiles with the R144 canonical analytical client identity.

Open modal architecture

Comet Analyzer GUI state

R154 immutable capability projection, worker terminal-state recovery and strict real-PyQt5 qualification boundary.

Open state machine and Qt gate

Comet Analyzer display encoding

R161 dual identity encoding and persistent styles, R164 artist invariance and the R169 global observation Point size.

Open R161 contract

Comet Analyzer plot ranges

R163 AUTO/USER ownership, immutable rendered-data identity, deliberate field intent and centralized automatic-limit resolution.

Open R163 contract

Formula transactions

R179 canonical parser, draft-only editor signals, explicit Refresh runtime commit, independent atomic Save and typed Analyse commit.

Open R179 contract and Qt gate

Custom-elements foundation and current overlays

R217 foundation: The current repair-flow authority covers apparition-aware mutation, stable repository snapshots, catalogue/open-widget impact resolution, selector rollback, typed WStack preview and the current NASA/JPL SBDB identity boundary. The current Database manager separates add-only creation from editing existing records; R211 remains the historical atomic-persistence baseline.

Open R217 flow architecture · R211 baseline · User workflow

Current Comet Analyzer behavior

The current documented behavior extends the historical R187 integration foundation through the Theta-60 Analyzer updates: bounded manual-X model extrapolation, independent X/Y intent, transactional multi-target projection defaults, responsive external Plot key, current Settings organization, aligned Formulae parameters and dimensionless Marcus d_90.

Open the integration chapter · Theta-38 → Theta-60 history

Historical analytical stages

R114–R133 Analyzer/Comparison architecture · R131–R133 compute/render foundation · R123 prepared-binding stage

Current WPlanner and source-role behavior

R255 remains the source-role/two-stage computation foundation. Later Theta updates add per-comet failure isolation and dense-remainder finding-chart robustness without changing the accepted-row-only N-body principle.

Open Planner architecture · User finding-chart guide