Module truing_uncertainty

Module truing_uncertainty 

Source
Expand description

Uncertainty-aware joint muzzle-velocity / ballistic-coefficient truing.

This is an opt-in companion to the historical truing API. It performs a weighted two-parameter MAP fit using absolute, caller-supplied observation standard deviations and optional explicit independent normal priors. The legacy point fitter and its output remain untouched.

V1 uses a local Laplace/Gaussian approximation at the constrained MAP. It is intentionally conservative about when that approximation is reported: the fitted MAP is still returned if the information matrix is singular or the optimum is on a parameter bound, but intervals and predictive bands are replaced by a structured approximation failure.

Structs§

GaussianIntervalV1
A two-sided interval from the local Gaussian approximation.
NormalPriorV1
An explicit independent normal prior, in the parameter’s physical units.
TruingApproximationFailureV1
Structured approximation failure. Consumers can branch on code while still presenting the explanatory message.
TruingCovarianceV1
Physical-coordinate posterior covariance for (MV fps, BC).
TruingGaussianApproximationV1
Successful local Gaussian approximation around the MAP.
TruingPredictionRequestV1
A range at which to propagate parameter uncertainty into predicted drop.
TruingPredictiveBandV1
Parameter-propagated drop uncertainty at one requested range.
TruingPriorsV1
Optional independent priors used by the V1 MAP approximation.
TruingUncertaintyDiagnosticsV1
Fit and approximation diagnostics.
TruingUncertaintyWarningV1
A warning with stable code and human-readable context.
UncertaintyTruingReportV1
Result of uncertainty-aware joint MV+BC truing.
UncertaintyTruingRequestV1
Complete request for weighted joint MV+BC MAP truing.
WeightedTruingObservationResultV1
Input and residual diagnostics at one observation.
WeightedTruingObservationV1
One measured drop and its absolute one-standard-deviation uncertainty.

Enums§

TruingApproximationFailureCodeV1
Why a local Gaussian approximation was withheld even though a MAP is available.
TruingApproximationV1
Availability of the Laplace/Gaussian approximation.
TruingMapConvergenceCriterionV1
Numerical criterion that verified the reported MAP.
TruingUncertaintyWarningCodeV1
Machine-readable warning categories emitted alongside the fit.
UncertaintyTruingErrorV1
Input or forward-model failure before a report can be produced.

Constants§

TRUING_UNCERTAINTY_INTERVAL_LEVEL_V1
The interval probability reported by V1.
TRUING_UNCERTAINTY_MAX_ITERS_V1
Iteration cap for the separately opt-in weighted joint MAP optimizer.
TRUING_UNCERTAINTY_SCHEMA_VERSION_V1
Schema version for the uncertainty-aware library result.

Functions§

run_uncertainty_truing_v1
Run the opt-in uncertainty-aware joint MV+BC truing path.