Crate pleiades_data

Expand description

Packaged compressed ephemeris backend for the default 1900-2100 range.

Wider coverage is available as an opt-in: regenerate the artifact over a custom window with the generate-artifact <kernel> --out <path> [--start --end] CLI subcommand.

This crate now ships a small stage-5 draft artifact backed by the pleiades-compression codec. The bundled data is regenerated from the checked-in JPL reference snapshot and validated against a deterministic binary fixture that covers the comparison-body planetary set plus the source-backed custom asteroid asteroid:433-Eros, and the backend falls back to other providers when callers request bodies outside that packaged slice. The packaged artifact stores J2000 ecliptic coordinates directly, reconstructs equatorial coordinates from the stored channels and mean-obliquity transform when requested, and adds residual correction channels on high-curvature spans when they improve the fit. A maintainer-facing regeneration helper can rebuild the checked-in fixture from the bundled JPL reference snapshot without introducing any native tooling. When the packaged-artifact-path feature is enabled, callers can also load an explicit artifact file for larger or externally distributed packaged datasets. See docs/time-observer-policy.md for the explicit packaged request/lookup-epoch policy, and spec/data-compression.md for the stored-vs-derived artifact contract.

§Examples

use pleiades_backend::{CelestialBody, Instant, JulianDay, TimeScale};
use pleiades_data::{packaged_backend, packaged_lookup};

let _backend = packaged_backend();
let instant = Instant::new(JulianDay::from_days(2_451_545.0), TimeScale::Tt);
let sun = packaged_lookup(&CelestialBody::Sun, instant)
    .expect("Sun should be in the packaged artifact");

assert!(sun.distance_au.is_some());

Modules§

thresholds: Published per-body-class accuracy ceilings and size/latency budgets (the public contract). The hold-out gate (accuracy_baseline.rs) asserts measured <= ceiling; the tight golden drift test stays as the regression catcher.

Structs§

BodyChannelError: Per-body accuracy summary comparing the artifact to an independent hold-out corpus.
PackagedArtifactAccessSummary: Structured packaged-artifact access summary.
PackagedArtifactBodyCadenceSummary: Structured summary for the packaged-artifact body cadence.
PackagedArtifactBodyClassSpanCapSummary: Structured summary for the packaged-artifact body-class span caps.
PackagedArtifactFitBodyOutlierSummary
PackagedArtifactFitChannelOutlier
PackagedArtifactFitChannelOutlierSummary
PackagedArtifactFitEnvelopeSummary: Structured fit envelope for the packaged artifact.
PackagedArtifactFitMarginSummary: Structured fit margins for the packaged artifact.
PackagedArtifactFitOutlierSummary
PackagedArtifactFitThresholdSummary: Calibrated fit thresholds for the packaged artifact.
PackagedArtifactFitThresholdViolation: A packaged-artifact fit threshold violation.
PackagedArtifactFitThresholdViolationsSummary: Packaged-artifact fit threshold violations captured for the current posture.
PackagedArtifactGenerationManifest: Structured deterministic manifest for the packaged artifact generator.
PackagedArtifactGenerationPolicySummary: Structured summary for the packaged-artifact generation policy.
PackagedArtifactGeneratorParameters: Structured generation parameters for the packaged artifact generator.
PackagedArtifactNormalizedIntermediateSummary: Structured normalized-intermediate provenance for the packaged artifact.
PackagedArtifactOutputSupportSummary: Structured output-support semantics for the packaged artifact profile.
PackagedArtifactPhase2CorpusAlignmentSummary: Phase-2 corpus evidence used to keep the packaged-artifact threshold policy aligned with the current reference, fixture-exactness, comparison, hold-out, selected-asteroid, boundary-overlay, and production-generation corpora.
PackagedArtifactProductionProfileSummary: Structured production-profile skeleton for the packaged artifact generator.
PackagedArtifactProfileSummary
PackagedArtifactRegenerationSummary: Structured regeneration provenance for the packaged artifact.
PackagedArtifactSourceFitHoldoutSyncSummary: Structured sync summary for the packaged-artifact source-fit and hold-out checks.
PackagedArtifactSpeedPolicySummary: Structured speed-policy semantics for the packaged artifact profile.
PackagedArtifactStorageSummary: Structured storage/reconstruction summary for the packaged artifact.
PackagedArtifactTargetThresholdScopeEnvelopesSummary
PackagedArtifactTargetThresholdScopeSummary
PackagedArtifactTargetThresholdSummary: Structured target-threshold posture for the packaged artifact generator.
PackagedBatchParitySummary: Structured mixed batch-parity summary for the packaged artifact.
PackagedBodyCoverageSummary: Structured coverage summary for the bodies bundled into the packaged artifact.
PackagedDataBackend: A packaged compressed-data backend.
PackagedFrameTreatmentSummary: Structured frame-treatment summary for the packaged artifact.
PackagedLookupEpochPolicySummary: Structured summary for the packaged-data lookup-epoch policy.
PackagedRequestPolicySummary: Structured request-policy summary for the packaged-data backend.
PackagedTimeScaleBatchParitySummary: Structured mixed TT/TDB batch-parity summary for the packaged artifact.

Enums§

PackagedArtifactAccessSummaryValidationError: Validation error for a packaged artifact access summary that drifted away from the current build posture.
PackagedArtifactBodyCadenceSummaryValidationError: Validation error for a packaged-artifact body cadence summary that drifted from the current posture.
PackagedArtifactBodyClassSpanCapSummaryValidationError: Validation error for a packaged-artifact body-class span cap summary that drifted from the current posture.
PackagedArtifactFitChannelOutlierSummaryValidationError: Validation error for a packaged-artifact fit outlier-by-channel summary that drifted from the current posture.
PackagedArtifactFitEnvelopeSummaryValidationError: Validation error for a packaged-artifact fit envelope that drifted from the current posture.
PackagedArtifactFitThresholdSummaryValidationError: Validation error for a packaged-artifact fit threshold summary that drifted from the current posture.
PackagedArtifactFitThresholdViolationsSummaryValidationError: Validation error for a packaged-artifact fit threshold violation summary that drifted from the current posture.
PackagedArtifactGenerationPolicy: Structured generation policy for the packaged artifact.
PackagedArtifactGenerationPolicySummaryValidationError: Validation error for the packaged-artifact generation policy summary.
PackagedArtifactGenerationPolicyValidationError: Validation error for the packaged-artifact generation policy.
PackagedArtifactLoadError: Errors that can occur while loading an external packaged artifact.
PackagedArtifactPhase2CorpusAlignmentSummaryValidationError: Validation error for a phase-2 corpus alignment summary that drifted from the current posture.
PackagedArtifactProductionProfileSummaryValidationError: Validation error for a packaged artifact production-profile skeleton that drifted from the current posture.
PackagedArtifactSourceFitHoldoutSyncSummaryValidationError: Validation error for a packaged-artifact source-fit and hold-out sync summary that drifted from the current posture.
PackagedArtifactSpeedPolicySummaryValidationError: Validation error for the packaged-data speed-policy summary.
PackagedArtifactStorageSummaryValidationError: Validation error for a packaged storage/reconstruction summary that drifted away from the compact posture line.
PackagedArtifactTargetThresholdScopeEnvelopesSummaryValidationError: Validation error for a packaged-artifact target-threshold scope envelopes summary that drifted from the current posture.
PackagedArtifactTargetThresholdState: Release-state for the packaged-artifact target thresholds.
PackagedArtifactTargetThresholdStateValidationError: Validation error for a packaged-artifact target-threshold state that is not release-ready.
PackagedArtifactTargetThresholdSummaryValidationError: Validation error for a packaged-artifact target-threshold summary that drifted from the current posture.
PackagedBatchParitySummaryValidationError: Validation error for a packaged mixed-frame batch-parity summary.
PackagedBodyCoverageSummaryValidationError: Validation error for a packaged-body coverage summary that drifted from the bundled body set.
PackagedFrameTreatmentSummaryValidationError: Validation error for a packaged frame-treatment summary that drifted away from the compact posture line.
PackagedLookupEpochPolicy: Structured policy for how packaged-data lookup epochs are handled.
PackagedLookupEpochPolicySummaryValidationError: Validation error for the packaged-data lookup-epoch policy summary.
PackagedLookupEpochPolicyValidationError: Validation error for the packaged-data lookup-epoch policy.
PackagedRequestPolicySummaryValidationError: Validation error for the packaged-data request-policy summary.
PackagedTimeScaleBatchParitySummaryValidationError: Validation error for a packaged mixed TT/TDB batch-parity summary.

Constants§

FITTING_OVERSAMPLE: Oversample factor: within-span sample count = (degree + 1) * this.

Functions§

accuracy_baseline_against: Computes per-body accuracy errors between a hold-out slice and an artifact.
apsis_body_claims: Release claims for the derived osculating lunar apsides (True Apogee / Perigee). These are computed from the packaged Moon state at lookup and validated against the Swiss Ephemeris SE_OSCU_APOG corpus by the validate-lilith gate, so their evidence is CorpusValidated.
fit_polynomial_lsq: Fits a degree-degree polynomial to (x, y) samples by least squares. Returns ascending power-basis coefficients, or None if there are fewer samples than coefficients or the normal-equations matrix is singular.
fitting_degree: Per-body polynomial degree for the within-span fit (SP1 default).
fitting_segment_boundaries: Contiguous [t0, t1] spans tiling [start_jd, end_jd], last clamped to end_jd.
fitting_segment_span_days: Per-body segment span in days (initial SP1 defaults; tuned in SP2).
fitting_within_span_sample_count: Number of de440 samples taken within each segment span.
package_name: Returns the canonical package name for this crate.
packaged_artifact: Returns the bundled packed artifact.
packaged_artifact_access_summary: Returns the packaged-artifact access summary.
packaged_artifact_access_summary_details: Returns the structured packaged-artifact access summary.
packaged_artifact_accuracy_baseline: Computes per-body accuracy errors for the committed packaged artifact against the production hold-out corpus.
packaged_artifact_body_cadence_summary_details: Returns the current packaged-artifact body cadence summary record.
packaged_artifact_body_class_span_cap_summary_details: Returns the current packaged-artifact body-class span caps summary record.
packaged_artifact_bytes: Returns the checked-in packaged artifact bytes.
packaged_artifact_fit_channel_outlier_summary_details: Returns the current packaged-artifact fit outliers by channel as a structured summary record.
packaged_artifact_fit_envelope_summary_details: Returns the current packaged-artifact fit envelope summary record.
packaged_artifact_fit_margin_summary_details: Returns the current packaged-artifact fit margins relative to the calibrated thresholds.
packaged_artifact_fit_outlier_summary_details: Returns the current packaged-artifact body/channel fit outlier summary record.
packaged_artifact_fit_threshold_summary_details: Returns the calibrated packaged-artifact fit threshold summary record.
packaged_artifact_fit_threshold_violation_summary_details: Returns the current packaged-artifact fit threshold violations summary record.
packaged_artifact_from_bytes: Decodes a packaged artifact from raw bytes.
packaged_artifact_from_path: Loads a packaged artifact from a file path.
packaged_artifact_generation_manifest: Returns the current deterministic packaged-artifact generation manifest.
packaged_artifact_generation_manifest_details: Returns the current deterministic packaged-artifact generation manifest.
packaged_artifact_generation_policy_summary: Returns the current packaged-artifact generation policy summary.
packaged_artifact_generation_policy_summary_details: Returns the current packaged-artifact generation policy summary record.
packaged_artifact_generation_residual_bodies_summary_details: Returns the current packaged-artifact residual-bearing body coverage summary record.
packaged_artifact_generator_parameters_details: Returns the current packaged-artifact generator parameters.
packaged_artifact_normalized_intermediate_summary_details: Returns the structured normalized-intermediate provenance.
packaged_artifact_output_support_summary_details: Returns the current packaged-artifact output-support summary record.
packaged_artifact_path_loading_enabled: Returns whether this build can load packaged artifacts from an explicit path.
packaged_artifact_phase2_corpus_alignment_summary_details: Returns the structured phase-2 corpus alignment posture used to keep the packaged-artifact threshold policy aligned with the current corpus.
packaged_artifact_production_profile_summary: Returns the current packaged-artifact production-profile draft summary.
packaged_artifact_production_profile_summary_details: Returns the current packaged-artifact production-profile skeleton.
packaged_artifact_profile_coverage_summary_details: Returns the current packaged-artifact profile coverage summary record.
packaged_artifact_profile_summary: Returns the current packaged-artifact profile summary.
packaged_artifact_profile_summary_details: Returns the current packaged-artifact profile summary record.
packaged_artifact_profile_summary_with_body_coverage: Returns the current packaged-artifact profile summary with bundled body coverage.
packaged_artifact_profile_summary_with_output_support: Returns the current packaged-artifact profile summary with the output-support posture.
packaged_artifact_regeneration_summary_details: Returns the structured packaged-artifact regeneration provenance.
packaged_artifact_source_fit_holdout_sync_summary_details: Returns the current packaged-artifact source-fit and hold-out sync summary record.
packaged_artifact_speed_policy_summary_details: Returns the current packaged-artifact speed-policy summary record.
packaged_artifact_storage_summary: Returns the packaged-artifact storage/reconstruction summary.
packaged_artifact_storage_summary_details: Returns the structured packaged-artifact storage/reconstruction summary.
packaged_artifact_target_threshold_scope_envelopes_summary_details: Returns the current packaged-artifact body-class target-threshold scope envelopes after validating the structured posture.
packaged_artifact_target_threshold_summary_details: Returns the current packaged-artifact target-threshold summary record.
packaged_backend: Returns a packaged-data backend instance.
packaged_backend_from_artifact: Returns a packaged-data backend built from an explicit artifact.
packaged_backend_from_bytes: Returns a packaged-data backend built from decoded artifact bytes.
packaged_backend_from_path: Returns a packaged-data backend built from a decoded artifact file.
packaged_body_claims: Returns the per-body release claims for the packaged artifact: every shipped body is release-grade, validated inside the artifact build against the corpus.
packaged_body_coverage_summary_details: Returns the structured packaged body coverage summary.
packaged_frame_treatment_summary: Returns the packaged-artifact frame-treatment summary.
packaged_frame_treatment_summary_details: Returns the structured packaged-artifact frame-treatment summary.
packaged_lookup: Returns a packaged lookup for a body and instant.
packaged_lookup_epoch_policy_summary: Returns the current packaged-data lookup-epoch policy summary.
packaged_lookup_epoch_policy_summary_details: Returns the current packaged-data lookup-epoch policy summary record.
packaged_mixed_frame_batch_parity_request_corpus: This is a compatibility alias for packaged_mixed_frame_batch_parity_requests.
packaged_mixed_frame_batch_parity_requests: Returns the packaged mixed-frame batch-parity request corpus used by downstream tooling.
packaged_mixed_frame_batch_parity_summary: Returns a compact mixed-frame batch-parity summary for the packaged artifact.
packaged_mixed_tt_tdb_batch_parity_request_corpus: This is a compatibility alias for packaged_mixed_tt_tdb_batch_parity_requests.
packaged_mixed_tt_tdb_batch_parity_requests: Returns the packaged mixed TT/TDB batch-parity request corpus used by downstream tooling.
packaged_mixed_tt_tdb_batch_parity_summary: Returns a compact mixed TT/TDB batch-parity summary for the packaged artifact.
packaged_request_policy_summary: Returns the current packaged-data request policy summary.
packaged_request_policy_summary_details: Returns the current packaged-data request-policy summary record.
regenerate_packaged_artifact: Returns the packaged artifact for kernel-free callers.
regenerate_packaged_artifact_bytes: Returns the encoded bytes for the packaged artifact for kernel-free callers.
regenerate_packaged_artifact_from_kernel: Regenerates the packaged artifact from a de440 SPK kernel over the shipped default window (1900–2100).
regenerate_packaged_artifact_from_kernel_over: Regenerates the packaged artifact from a de440 SPK kernel over an explicit coverage window. Major bodies are fit densely from the kernel across window; the constrained asteroid (Eros) is always sourced from its fixed 1900–2100 corpus data and is unaffected by window.
regenerate_packaged_artifact_from_snapshot: Rebuilds the packaged artifact from validated JPL reference-snapshot inputs.
true_node_body_claims: Release claim for the derived osculating lunar ascending node (TrueNode). Computed from the packaged Moon state at lookup (formed in the mean ecliptic of date, emitted in J2000) and validated against the Swiss Ephemeris SE_TRUE_NODE corpus by the validate-true-node gate, so its evidence is CorpusValidated. Supersedes, in the routed chart chain, the pleiades-elp Meeus periodic-term approximation (issue #58).
try_regenerate_packaged_artifact_from_snapshot: Rebuilds the packaged artifact from validated JPL reference-snapshot inputs.