KOPR — Software for Comet Observers
Current downloadable application: KOPR Live Theta-43 / 0.1.0.dev558. Documentation revision 10.44.
koprgit.py from src/kopr/config/release_identity.py inside the newly downloaded Python 3 repository ZIP. The structural baseline remains R515/C8: all active implementation is canonical under src/kopr/; root Python files are compatibility/source-launcher surfaces only.Documented integrated state
Main work areas
The current application contains five main tabs, shown below in the same order as in KOPR.
Process Visual Obs.
Process visual comet estimates, add missing local elements explicitly when required and prepare ICQ-format results.
Image Calibration & Stacking
Prepare calibration masters, solve astrometry, create matched stacks and use generation-safe explicit custom-elements actions in preview and astrometry-group workflows.
Process CCD Obs.
Measure total coma brightness with manual or automatic helpers and use an explicit missing-elements action without automatic editor pop-ups.
Observation Planner
Generate ephemerides and visibility diagrams with a shared Selected / Not selected catalogue that refreshes after atomic custom-element edits.
Comet Analyzer
Analyse one or many comet light curves and add or update custom elements through the shared selector with typed-target reload protection.
Download
Live source archives
Offline catalogues
APASS DR10 to magnitude 14
Selection for comet photometry with stars brighter than V = 14 mag. Download size: 298.4 MB.
APASS DR10 to magnitude 16
Selection for comet photometry with stars brighter than V = 16 mag. Download size: 1.3 GB.
Tycho-2 Catalogue
B and V magnitudes from the Tycho-2 catalogue. Download size: 48.1 MB.
Yale Bright Star Catalogue 5
The documentation revision is independent of the current KOPR Live release number. B−V is catalogue provenance only and is never used to colour finding-chart stars.
Installation
The current live build requires Python 3.10 or newer and must be started from the directory containing kopr.py.
Documentation
The documentation has a stable static-HTML structure. Installation, configuration, all five production workflow guides, data/FITS reference, troubleshooting and developer chapters include the R179 formula transaction contract and retained R169 point-size presentation contract together with the retained R164 artist, R163 range, R161 display, R156, R154, R149, R144, R130 and R121 authorities.
Comet designation
Shared syntax, canonicalisation, local-element validation and the R217 Custom-elements repair workflow.
Start here
Installation, first startup, field-by-field configuration and general workflow.
Image workflow
Calibration, astrometry, quality control, stacking and exposure-normalized CCD photometry with the PA-adaptive ACF Review workflow.
Complete WStack guide · Complete CCD photometry guide · ACF / Review
Observation and analysis
Visual reductions, planning and unified one-to-N light-curve analysis with identity-stable display encoding, persistent point-size control, automatic/manual range ownership, controlled Fit Groups, target-aware formula documents and Multi-colour CSV export.
Data and FITS reference
Input metadata, Scientific/Compact storage, unified stack time/exposure contracts, WStack extensions, external FITS inspection, paired stacks and observation outputs.
Troubleshooting
Symptom-based diagnostics for installation, calibration, astrometry, stacking, pair validation, catalogues and photometry.
Developer documentation
Architecture, algorithms, testing and the WStack integration contract for maintainers.
Performance and platforms
Fixed processing limits, modal ephemeris and Planner/Analyzer compute boundaries, plus the R217 repair rule that stable custom-element mutations reconcile repositories, selectors and open widgets without changing scientific calculations.