Work

B612-Asteroid-Institute/adam_core: adam-core 0.8.0

Year: 2026
Type: software
Abstract: adam-core 0.8.0 adds CPython 3.14 support, advances PyO3/NumPy to 0.28 and Arrow/Parquet to 58, and publishes the aligned six-crate Rust API at Rust 1.87. Install pip install "adam-core==0.8.0" PyPI package Rust umbrella crate Full comparison Added Added per-axis VFC2017 uncertainty floor and replacement, performance-weighted covariance scaling, and measured-bias uncertainty flooring as typed optional transforms in the ordered observation pipeline. Canonical OD batches can execute independent groups concurrently on Rayon's shared pool while preserving deterministic product, failure, and fatal-error ordering. Changed Native Python bindings use PyO3/NumPy 0.28 and Arrow/Parquet 58. Standard wheels, CI, and release validation now cover CPython 3.11-3.14 on all existing manylinux and macOS targets. Optional JAX availability remains outside the standard support gate. Python calculate_perturber_moids removes the ignored chunk_size and max_processes arguments and requires explicit setup_SPICE() initialization. setup_SPICE and setup_mpc_obscodes remove the ineffective force argument; repeated setup remains idempotent from the Rust backend's actual state. NumPy, PyO3, Rust, SPICE-backed, and benchmark MOID entry points remove the obsolete max_iter and xtol controls. MOID iteration and convergence policy are owned by the global solver. SPICE kernel initialization is one typed Rust-owned operation. The process-global backend now uses an RwLock; canonical OD holds a shared read guard across each non-empty invocation. Runtime kernel/site mutation, including missing-path initialization, fails immediately while scientific readers are active, while setup of an already-registered exact path remains an idempotent read-side no-op. Rust consumers migrate immutable queries from .lock() to .read() and perform initialization-only mutation under .write() before concurrent work; runtime mutation uses .try_write() and fails instead of waiting behind readers. The public Rust OD expert surface is limited to prepare_observations, solve_prepared_iod, refine_prepared_orbit, and PreparedObservations. The 0.7 to 0.8 migration is: run_iod_with_predictor is renamed to solve_prepared_iod; refine_with_predictor is renamed to refine_prepared_orbit; run_od_with_predictors and ConfiguredRunOdOutput are removed; use canonical adam_core::run_od; external_provider_metadata is replaced by ProviderMetadata::from_external_propagator; ErfaTimeProvider is replaced by a caller-owned TimeScaleProvider implementation, which may delegate to TimeArray::rescale; GlobalSpiceTranslation is replaced by a global_backend().read() guard passed as the translation provider; CanonicalStageSettings and canonical_stage_settings are internal; canonical callers pass typed stage configuration; and two_body_provider_metadata is internal; canonical callers read actual identities from OdBatchResult::providers(). The exhaustive public ObservationTransform enum adds Vfc2017AstrometricUncertaintyFloor, Vfc2017AstrometricUncertaintyReplace, PerformanceWeightedCovarianceScaling, and MeasuredBiasAstrometricUncertaintyFloor. Removed the redundant private legacy differential-correction and full-OD implementations and their parity-oracle tests. Canonical workflow numerical behavior and provider/request contracts are unchanged. Fixed MOID calculations use the pure-Rust global Baluev-Mikryukov/DISTLINK critical-point solver through scalar, batch, and SPICE-backed paths, with deterministic witnesses and row-specific typed failures instead of the old NaN compatibility result. Compatibility Python: adam-core==0.8.0 supports CPython 3.11-3.14. Callers must remove the retired MOID/setup arguments and initialize SPICE explicitly before perturber-MOID calls. Rust: all six public crates advance together to 0.8.0 with exact internal requirements and Rust 1.87 as the MSRV. The Arrow 54 to Arrow 58 transition, OD migration map, exhaustive-enum additions, and backend synchronization change are source-breaking for direct Rust consumers.
Language: English
Subfield: Software
Open Access status: green
OpenAlex ID: W7204643698
Cites:
Cited by:
Related to: 10