Crate empyrean_sys

Expand description

Raw FFI bindings to libempyrean, the C shared library for empyrean’s astrodynamics engine.

Prefer the safe wrapper crate empyrean unless you need direct access to the C ABI.

§How `libempyrean` is loaded

The library is opened at run time with libloading — there is no link-time native dependency and no install_name_tool / patchelf / rpath / LD_LIBRARY_PATH setup. Its path is resolved on first use, in order:

EMPYREAN_LIB — an explicit path to the library, passed straight to dlopen (override / offline use / a locally built engine). A bare name defers to the OS loader search; pass a full path for an exact file.
A libempyrean.{dylib,so} sitting next to the currently loaded module — the .so/.dylib/executable that statically links this crate — located via dladdr. This makes prebuilt, relocatable artifacts self-contained: a Python wheel can bundle the engine beside its extension and it is found with no build-machine path baked in.
The absolute path recorded at build time (LIB_PATH): a sibling ../target/release build, an EMPYREAN_LIB_DIR override, or a version-matched, checksum-pinned prebuilt downloaded (in pure Rust — no curl/tar) into ~/.cache/empyrean. This covers cargo add empyrean, where the build script runs on the consumer’s own machine.

The bindings are pre-generated and committed, so building needs no C header and no libclang / bindgen. Callers use the free empyrean_* functions exactly as with a statically linked library; each delegates to the loaded EmpyreanLib.

Structs§

Context
CoordinateState: Flat C-ABI compatible coordinate state.
EmpyreanAcceptabilityReport: Acceptability sub-checks computed post-DC.
EmpyreanAcceptabilityThresholds: Acceptability thresholds for the post-DC fit-quality checks (mirrors [scott::od::AcceptabilityThresholds]). Sentinel: 0.0 → upstream default.
EmpyreanAdvancedIntegratorConfig: Integrator tuning. Mirrors [villeneuve::propagation::AdvancedIntegratorConfig]. The default integrator backend is Gauss-Radau 15 (GR15), derived solely from the published papers; epsilon is interpreted as the relative b₆ truncation tolerance.
EmpyreanAutoEscalationPolicy: Auto-escalation policy for [SolveForParams::Auto] (mirrors [scott::od::AutoEscalationPolicy]). Sentinel: 0 / 0.0 → upstream default.
EmpyreanBPlane: One B-plane breakdown emitted by empyrean_compute_b_planes. Mirrors [empyrean_core::impact::BPlaneData] flattened to primitives. Nullable f64 fields use NaN sentinels.
EmpyreanBPlanesResult
EmpyreanBandStat: Per-band photometric statistics (mirrors scott’s BandStat). Owned heap entry, freed by empyrean_od_result_free.
EmpyreanBuiltSystem: Opaque handle wrapping a pre-assembled force model plus the kernel-identity snapshot taken from the context at construction (so empyrean_builtsystem_describe is self-contained). Construct with empyrean_builtsystem_new; release with empyrean_builtsystem_free.
EmpyreanCovarianceMetrics: Covariance summary metrics (prior, posterior, or per-candidate cumulative).
EmpyreanDataDirOptions: Options for empyrean_context_from_data_dir_with.
EmpyreanDebiasingConfig: Catalog-bias-correction configuration. Mirrors scott’s Option<Arc<DebiasingTable>> field on ODConfig.
EmpyreanDetermineResults: Result table of a batch empyrean_determine — one EmpyreanODObjectResult per ADES object found in the observations, in ascending object_id order.
EmpyreanDiagnosticsConfig: Per-trajectory diagnostic outputs (sensitivity, nonlinearity, …). Mirrors [villeneuve::diagnostics::DiagnosticsConfig].
EmpyreanEphemerisConfig: Ephemeris-generation configuration.
EmpyreanEphemerisEntry: A single predicted ephemeris entry.
EmpyreanEphemerisResult: Result containing an array of ephemeris entries and, when an uncertainty method traced the STM, the observation-sensitivity chains.
EmpyreanEvaluateResult: Result of orbit evaluation (residuals without fitting).
EmpyreanEvent: A detected dynamical event from propagation.
EmpyreanEventConfig: Event-detection configuration. Mirrors [villeneuve::events::EventConfig] (less the enrichment sub-config, which carries internal nested data that doesn’t translate cleanly through C — it always uses upstream defaults).
EmpyreanFitSummary: One row of the per-object fit summary: what a batch orbit determination did with one input object, delivered or not.
EmpyreanGateRecord: One model-ladder gate decision (mirrors scott’s GateRecord). Owned heap entry, freed by empyrean_od_result_free.
EmpyreanIODConfig: IOD ranging tuning (mirrors the IOD section of [scott::od::ODConfig]).
EmpyreanImpactProbabilitiesResult
EmpyreanImpactProbability: One impact-probability record emitted by empyrean_compute_impact_probabilities. Mirrors [empyrean_core::impact::ImpactProbability] flattened to primitives; nullable fields use NaN sentinels (Option) or 0 / null (Option).
EmpyreanKernelRecord: One entry of the kernel-identity manifest captured by a handle.
EmpyreanLib
EmpyreanMissingDataFiles: The data files a strict-offline construction found absent.
EmpyreanMixtureChain: Per-orbit AGM mixture decomposition retained by Auto / Mixture.
EmpyreanMixtureComponent: One Gaussian sub-component of an AGM mixture decomposition.
EmpyreanNonGravParams: A complete non-gravitational acceleration model, flattened for the C ABI.
EmpyreanODConfig: Orbit-determination configuration.
EmpyreanODObjectResult: One object’s slot in a batch empyrean_determine result.
EmpyreanODPhotometryResult: Post-OD photometric solution (mirrors scott’s PhotometryResult). Present only when photometry was requested and ran (EmpyreanODResult::has_photometry). H carries honest σ via the covariance block.
EmpyreanODResult: Mirrors scott’s ODResult. Carries the fitted orbit, the 6×6 (or 9×9 when non-grav was solved) formal covariance, the per-observation result array, the summary, the structured acceptability report, and the per-station nuisance-bias array when fit_station_biases was active.
EmpyreanObservation: A single optical observation for orbit determination — full ADES schema.
EmpyreanObservationResult: Per-observation result from orbit determination or evaluation.
EmpyreanObservationSensitivity: One observation-sensitivity row — the partial derivatives of the sky-plane observable w.r.t. the input state, for a single (orbit, observer, epoch). One row per observation epoch within each (orbit_id, obs_code) chain. Owning struct: free the whole result with empyrean_ephemeris_result_free.
EmpyreanObservatoryConfig: Per-observatory assumptions: astrometric σ + observability filters.
EmpyreanObserver: A single observer state for the C API.
EmpyreanObserverResult: Result containing an array of observer states.
EmpyreanOrbit: An orbit with optional non-gravitational parameters, continuous-thrust arcs, and photometry.
EmpyreanOrbitBatch: A batch of orbits with their identifiers.
EmpyreanOrbitCovariance: A joint cross-covariance the library HANDS BACK — the half of a covariance that is not a diagonal block.
EmpyreanOriginPolicy: Origin-policy selector for the OD pipeline (mirrors [OriginPolicy]).
EmpyreanOriginSwitchingConfig: Origin-switching configuration for trajectory splitting at body Laplace spheres of influence (Amato/Baù/Bombardelli 2017 §6).
EmpyreanOutputEpoch: Output epoch specification (mirrors [OutputEpoch]).
EmpyreanParamColumn: The identity of one solved-parameter column, independent of the wide slot it happens to occupy on any particular orbit.
EmpyreanParamPairCross: One parameter-to-parameter cross term.
EmpyreanPhotometryConfig: Post-OD photometric-fit request (mirrors scott’s PhotometryConfig). Enabled by EmpyreanODConfig::has_photometry; the fit runs after the orbit is solved and never touches the state (photometry has no astrometric partials). Zero-init reproduces scott’s defaults.
EmpyreanPlanCandidate: Per-candidate information-gain analysis.
EmpyreanPlanEphemerisPoint: One predicted sky-plane point of the plan’s optical ephemeris: the target’s predicted topocentric right ascension and declination (degrees, ICRF) at an optical candidate’s epoch (MJD, TDB).
EmpyreanPlanResult: Result of a plan evaluation. The caller allocates the struct; the orbit_id string, the candidates array (with their obs_code and radar_provenance strings), and the ephemeris array are heap-allocated here and must be released with empyrean_plan_result_free.
EmpyreanPlannedObservation: A single planned (candidate) observation: an epoch plus either an optical or a radar measurement spec. Optical fields are read when kind == 0, radar fields when kind == 1; absent optional radar target properties use NaN (the link budget refuses, rather than silently defaults, a missing value).
EmpyreanPlanningConfig: Planning configuration: force model, integration tolerance, the per-observatory astrometric assumptions, and threading.
EmpyreanPropagatedState: A single propagated Cartesian state.
EmpyreanPropagationConfig: Propagation configuration.
EmpyreanPropagationResult: Propagation result containing states, events, and object identifiers.
EmpyreanRadarObservation: A single radar (delay or Doppler) observation for orbit determination — the ADES <radar> schema.
EmpyreanRejectionConfig: Outlier rejection configuration. Selects between two strategies via the kind discriminator:
EmpyreanResidualSummary: Aggregate residual statistics.
EmpyreanSRPParams: The fitted orbit’s absolute solar-radiation-pressure slot, flattened for the C ABI.
EmpyreanSessionDiff: Pairwise diagnostic returned by empyrean_session_diff.
EmpyreanSolveFor: Result of orbit determination (determine or refine).
EmpyreanSolvedCovariance: Full solved-parameter covariance at the ABI-frozen width EMPYREAN_SOLVE_WIDTH (mirrors scott’s SolvedCovariance tag-for-tag). The leading width × width block is meaningful; rows and columns beyond width are zero (RESERVED, not defaulted covariance). Consumers MUST read the slot tags to locate a parameter — the width alone is ambiguous (width 9 is Marsden OR a one-segment thrust). An absent tag carries EMPYREAN_SLOT_NONE.
EmpyreanState: A single body state for the C API.
EmpyreanStateParamCross: One state-to-parameter cross column: the 6-vector of covariances between the six state elements and one solved parameter.
EmpyreanStateResult: Result containing an array of body states.
EmpyreanStationBias: One per-station bias estimate from a Schur-eliminated nuisance fit.
EmpyreanStationRaDecConfig: Per-station RA/Dec bias-fit configuration (mirrors [scott::nuisance::BiasKind::StationRaDec]).
EmpyreanSystemDescription: A reproducibility summary of a handle’s frozen force model plus its captured kernel-identity manifest.
EmpyreanTaggedCovariance: Flattened, owned form of empyrean_core::propagation::TaggedCovariance (villeneuve’s provenance-tagged covariance). Self-describing: the 6×6 matrix together with the co-located nominal state, how the covariance was derived, its definiteness, its basis, the solved-for parameters, and the functional it describes — so a consumer can never read a second-order CA ellipsoid as a linear one.
EmpyreanTaggedCovarianceSeries: Owned series of EmpyreanTaggedCovariance, one entry per output epoch. Free with empyrean_tagged_covariance_series_free.
EmpyreanThrustArc: A single continuous-thrust arc, mirroring [empyrean_core::nongrav::ThrustArc] as a flat #[repr(C)] record.
EmpyreanUncertaintyMethod: Uncertainty-propagation method, mirroring [empyrean_core::propagation::UncertaintyMethod] as a flat C struct. Fields outside the active variant are ignored — set them to zero / NaN.
EmpyreanVersions: Per-crate version strings reported by the empyrean stack.
EmpyreanWeightingConfig: Weighting configuration. Mirrors [scott::weighting::WeightingConfig] structurally; extends it with an enabled toggle and a preset selector for the common case of “use the production preset” without constructing layers by hand.
EmpyreanWeightingLayer: One element of EmpyreanWeightingConfig::additional_layers. Tagged-union shape: the active fields depend on kind, and the inactive fields MUST be left at their unset values (zeroed bytes / 0.0 / NaN epochs) — a layer carrying fields its kind does not read is rejected with an error rather than silently ignored. In particular a NIGHTLY_DEWEIGHTING layer reads only max_gap_days: nightly de-weighting cannot be scoped by station or time range.
Session

Constants§

EMPYREAN_ABI_VERSION
EMPYREAN_BUILTSYSTEM_ALLOC
EMPYREAN_BUILTSYSTEM_CONFIG_MUTATES_KEY
EMPYREAN_BUILTSYSTEM_DATA_MISMATCH
EMPYREAN_BUILTSYSTEM_INVALID_ARGUMENT
EMPYREAN_BUILTSYSTEM_KEY_MISMATCH_DIVISOR
EMPYREAN_BUILTSYSTEM_KEY_MISMATCH_FORCE_MODEL
EMPYREAN_BUILTSYSTEM_KEY_MISMATCH_FRAME
EMPYREAN_BUILTSYSTEM_NULL_POINTER
EMPYREAN_BUILTSYSTEM_OK
EMPYREAN_BUILTSYSTEM_PANIC
EMPYREAN_BUILTSYSTEM_PROPAGATION
EMPYREAN_BUILTSYSTEM_STALE
EMPYREAN_COVARIANCE_KIND_LINEAR
EMPYREAN_COVARIANCE_KIND_MIXTURE
EMPYREAN_COVARIANCE_KIND_MONTE_CARLO
EMPYREAN_COVARIANCE_KIND_SECOND_ORDER
EMPYREAN_COVARIANCE_KIND_SIGMA_POINT
EMPYREAN_COVARIANCE_KIND_THIRD_ORDER
EMPYREAN_COVARIANCE_QUALITY_EXPANSION_SUSPECT
EMPYREAN_COVARIANCE_QUALITY_INDEFINITE
EMPYREAN_COVARIANCE_QUALITY_POSITIVE_DEFINITE
EMPYREAN_COVARIANCE_QUALITY_REPAIRED
EMPYREAN_COVARIANCE_TRUST_ENCOUNTER_INTERVENES
EMPYREAN_COVARIANCE_TRUST_NOT_EVALUATED
EMPYREAN_COVARIANCE_TRUST_TRUSTED
EMPYREAN_COVARIANCE_TRUST_WEAKLY_DETERMINED_HIGH_N
EMPYREAN_DATA_REFRESH_DEFAULT
EMPYREAN_DATA_REFRESH_OFF
EMPYREAN_DATA_REFRESH_ON
EMPYREAN_DATA_TIER_APPROXIMATE
EMPYREAN_DATA_TIER_BASIC
EMPYREAN_DATA_TIER_DEFAULT
EMPYREAN_DATA_TIER_FULL
EMPYREAN_DATA_TIER_STANDARD
EMPYREAN_DEBIASING_RESOLUTION_HIRES
EMPYREAN_DEBIASING_RESOLUTION_STANDARD
EMPYREAN_DEBIASING_TABLE_EFCC2020
EMPYREAN_DETERMINE_NONE_DELIVERED
EMPYREAN_EPHEMERIS_OVERLAP_POLICY_EXCLUDE_AND_INTEGRATE
EMPYREAN_EPHEMERIS_OVERLAP_POLICY_SUBSTITUTE_SPK
EMPYREAN_INTEGRATOR_DOP853
EMPYREAN_INTEGRATOR_GR15
EMPYREAN_KERNEL_KIND_BPC
EMPYREAN_KERNEL_KIND_GRAVITY
EMPYREAN_KERNEL_KIND_OBSCODES
EMPYREAN_KERNEL_KIND_SPK
EMPYREAN_KERNEL_KIND_TPC
EMPYREAN_KERNEL_PROVENANCE_BUILT_IN
EMPYREAN_KERNEL_PROVENANCE_FILE
EMPYREAN_KERNEL_PROVENANCE_IN_MEMORY
EMPYREAN_MAX_THRUST_SEGMENTS
EMPYREAN_OD_FAILURE_DUPLICATE_OBS_IDS
EMPYREAN_OD_FAILURE_EARTH_ORIENTATION_COVERAGE
EMPYREAN_OD_FAILURE_IOD
EMPYREAN_OD_FAILURE_NONE
EMPYREAN_OD_FAILURE_NON_GRAV_NOT_RECOVERED
EMPYREAN_OD_FAILURE_OBSERVATION_CONVERSION
EMPYREAN_OD_FAILURE_OBSERVER_CONSTRUCTION
EMPYREAN_OD_FAILURE_OD
EMPYREAN_OD_FAILURE_RADAR_ONLY
EMPYREAN_OD_FAILURE_UNSUPPORTED_COORDINATE_SYSTEM
EMPYREAN_ORIGIN_POLICY_AUTO
EMPYREAN_ORIGIN_POLICY_EXPLICIT
EMPYREAN_ORIGIN_SWITCHING_DEFAULT
EMPYREAN_ORIGIN_SWITCHING_OFF
EMPYREAN_ORIGIN_SWITCHING_ON
EMPYREAN_OUTPUT_EPOCH_EXPLICIT
EMPYREAN_OUTPUT_EPOCH_IOD_EPOCH
EMPYREAN_OUTPUT_EPOCH_LAST_OBSERVATION
EMPYREAN_OUTPUT_EPOCH_MID_ARC
EMPYREAN_PARAM_COLUMN_AMRAT
EMPYREAN_PARAM_COLUMN_DT
EMPYREAN_PARAM_COLUMN_MARSDEN
EMPYREAN_PARAM_COLUMN_THRUST
EMPYREAN_PARAM_CONSIDERED
EMPYREAN_PARAM_FIXED
EMPYREAN_PARAM_SOLVED
EMPYREAN_PHASE_FUNCTION_HG
EMPYREAN_PHASE_FUNCTION_HG1G2
EMPYREAN_PHASE_FUNCTION_HG12
EMPYREAN_PHASE_FUNCTION_NONE
EMPYREAN_PHOTOMETRY_MODEL_AUTO
EMPYREAN_PHOTOMETRY_MODEL_HG
EMPYREAN_PHOTOMETRY_MODEL_HG1G2
EMPYREAN_PHOTOMETRY_MODEL_HG12
EMPYREAN_PHOTOMETRY_MODEL_HONLY
EMPYREAN_RADAR_KIND_DELAY
EMPYREAN_RADAR_KIND_DOPPLER
EMPYREAN_REJECTION_ACCEPTED
EMPYREAN_REJECTION_ADAPTIVE
EMPYREAN_REJECTION_CHI_SQUARED
EMPYREAN_REJECTION_CMC2003
EMPYREAN_REJECTION_COOKS_DISTANCE
EMPYREAN_REJECTION_KIND_ADAPTIVE
EMPYREAN_REJECTION_KIND_CMC2003
EMPYREAN_REJECTION_MISSING_JACOBIAN
EMPYREAN_REJECTION_NEVER_ABSORBED
EMPYREAN_REJECTION_NON_FINITE_CHI2
EMPYREAN_REJECTION_NOT_EVALUATED
EMPYREAN_REJECTION_OBSERVER_CONSTRUCTION_FAILED
EMPYREAN_REJECTION_OCCULTATION_UNSUPPORTED
EMPYREAN_REJECTION_OUTSIDE_ARC
EMPYREAN_REJECTION_PER_OBSERVATION_SITE_REQUIRED
EMPYREAN_REJECTION_RADAR_UNSUPPORTED
EMPYREAN_REJECTION_SIGMA_CLIP
EMPYREAN_REJECTION_SPACECRAFT_KERNEL_MISSING
EMPYREAN_REJECTION_UNSUPPORTED_OBSERVATORY
EMPYREAN_REPRESENTATION_CARTESIAN
EMPYREAN_REPRESENTATION_COMETARY
EMPYREAN_REPRESENTATION_KEPLERIAN
EMPYREAN_REPRESENTATION_SPHERICAL
EMPYREAN_SENSITIVITY_ROW_DEC
EMPYREAN_SENSITIVITY_ROW_RA
EMPYREAN_SENSITIVITY_ROW_RANGE
EMPYREAN_SENSITIVITY_ROW_VDEC
EMPYREAN_SENSITIVITY_ROW_VRA
EMPYREAN_SENSITIVITY_ROW_VRANGE
EMPYREAN_SIGMA_POLICY_DEFAULT_ONLY
EMPYREAN_SIGMA_POLICY_FLOOR
EMPYREAN_SLOT_NONE
EMPYREAN_SOLVER_STOP_COST_TOLERANCE
EMPYREAN_SOLVER_STOP_DAMPING_EXHAUSTED
EMPYREAN_SOLVER_STOP_GRADIENT_TOLERANCE
EMPYREAN_SOLVER_STOP_INNER_TRIALS_EXHAUSTED
EMPYREAN_SOLVER_STOP_MAX_ITERATIONS
EMPYREAN_SOLVER_STOP_NOT_REPORTED
EMPYREAN_SOLVER_STOP_SCHUR_STEP_TOLERANCE
EMPYREAN_SOLVER_STOP_STALLED_DELIVERED
EMPYREAN_SOLVER_STOP_STEP_TOLERANCE
EMPYREAN_SOLVER_STOP_UNRECOGNIZED
EMPYREAN_SOLVE_FOR_AUTO
EMPYREAN_SOLVE_FOR_EXPLICIT
EMPYREAN_SOLVE_FOR_STATE_AND_NONGRAV
EMPYREAN_SOLVE_FOR_STATE_ONLY
EMPYREAN_SOLVE_WIDTH
EMPYREAN_STEERING_LAW_CONSTANT_RTN
EMPYREAN_STEERING_LAW_INERTIAL_FIXED
EMPYREAN_STEERING_LAW_VELOCITY_TANGENT
EMPYREAN_TAGGED_COV_CHAIN_ORBIT_COUNT_MISMATCH
EMPYREAN_TAGGED_COV_EPOCH_INDEX_OUT_OF_RANGE
EMPYREAN_TAGGED_COV_NO_DENSE_TRAJECTORY
EMPYREAN_TAGGED_COV_NO_INITIAL_COVARIANCE
EMPYREAN_TAGGED_COV_NULL_POINTER
EMPYREAN_TAGGED_COV_OK
EMPYREAN_TAGGED_COV_ORBIT_INDEX_OUT_OF_RANGE
EMPYREAN_TAGGED_COV_PANIC
EMPYREAN_TAGGED_COV_SAMPLE_COVARIANCE_MISSING
EMPYREAN_TAGGED_COV_SAMPLE_ROW_EPOCH_MISMATCH
EMPYREAN_TAGGED_COV_STATE_MISSING
EMPYREAN_TAGGED_COV_TRANSFORM
EMPYREAN_TAGGED_COV_UNCERTAINTY
EMPYREAN_TARGET_FUNCTIONAL_CARTESIAN_STATE
EMPYREAN_TARGET_FUNCTIONAL_CLOSE_APPROACH_MISS_DISTANCE
EMPYREAN_TRUST_EVENT_CLOSE_APPROACH
EMPYREAN_TRUST_EVENT_HIGH_NONLINEARITY
EMPYREAN_TRUST_EVENT_NONE
EMPYREAN_UNCERTAINTY_AUTO
EMPYREAN_UNCERTAINTY_FIRST
EMPYREAN_UNCERTAINTY_MIXTURE
EMPYREAN_UNCERTAINTY_MONTE_CARLO
EMPYREAN_UNCERTAINTY_SECOND
EMPYREAN_UNCERTAINTY_SIGMA_POINT
EMPYREAN_WEIGHTING_LAYER_NIGHTLY_DEWEIGHTING
EMPYREAN_WEIGHTING_LAYER_OBSERVATORY_RULE
EMPYREAN_WEIGHTING_PRESET_NEODYS
EMPYREAN_WEIGHTING_PRESET_NONE
EMPYREAN_WEIGHTING_PRESET_VFCC2017
LIB_PATH

Functions§

empyrean_abi_version^⚠: Runtime accessor for EMPYREAN_ABI_VERSION — lets a dynamically linked consumer confirm the loaded library’s frozen-shape contract matches what it compiled against.
empyrean_builtsystem_describe^⚠: Populate out with a full reproducibility summary of the handle’s frozen force model and its captured kernel manifest.
empyrean_builtsystem_description_free^⚠: Free the heap arrays inside a description populated by empyrean_builtsystem_describe (the perturber-id array and the kernel records with their C strings). After this returns desc is zero-initialized — safe to drop on the caller’s stack. Passing null is a no-op.
empyrean_builtsystem_determine^⚠: Run the full orbit-determination pipeline over every object in observations, reusing the pre-built handle for every fit in the batch.
empyrean_builtsystem_evaluate^⚠: Evaluate residuals for a single orbit against observations, reusing the pre-built handle.
empyrean_builtsystem_free^⚠: Free a handle previously returned by empyrean_builtsystem_new. Passing null is a no-op.
empyrean_builtsystem_generate_ephemeris^⚠: Generate predicted ephemeris for orbits and observers through the pre-built handle.
empyrean_builtsystem_new^⚠: Assemble a reusable force-model handle for (force_model, frame) from ctx, freezing encounter_timescale_divisor into its key.
empyrean_builtsystem_new_for_od^⚠: Assemble a handle keyed for the orbit-determination entry points.
empyrean_builtsystem_propagate^⚠: Propagate orbits to times through the pre-built handle.
empyrean_builtsystem_refine^⚠: Refine a single orbit estimate with new observations using a Bayesian prior, reusing the pre-built handle.
empyrean_compute_b_planes^⚠: Run [empyrean_core::impact::compute_b_planes] over a caller- supplied set of [UncertaintyMethod] variants and return the flattened B-plane records tagged by method.
empyrean_compute_b_planes_result_free^⚠: Free the records array allocated by empyrean_compute_b_planes.
empyrean_compute_impact_probabilities^⚠: Run [empyrean_core::impact::compute_impact_probabilities] over a caller-supplied set of [UncertaintyMethod] variants and return the flattened IP records tagged by method.
empyrean_compute_impact_probabilities_result_free^⚠: Free the records array allocated by empyrean_compute_impact_probabilities. After calling, the struct’s records is reset to null and num_records to 0.
empyrean_context_free^⚠: Free an EmpyreanContext previously returned by empyrean_context_from_data_dir, empyrean_context_from_data_dir_with or empyrean_context_new_minimal.
empyrean_context_from_data_dir^⚠: Create a new EmpyreanContext from a data directory.
empyrean_context_from_data_dir_with^⚠: Create a new EmpyreanContext from a data directory under explicit options — the superset of empyrean_context_from_data_dir.
empyrean_context_new_minimal^⚠: Create a minimal EmpyreanContext from a DE440 SPK file and a GM TPC file.
empyrean_context_with_spk^⚠: Load an additional SPK kernel into an existing context, in place.
empyrean_default_data_dir^⚠: Return the platform XDG-compliant default data directory as a heap-allocated, NUL-terminated UTF-8 string.
empyrean_determine^⚠: Run the full orbit determination pipeline over every object in observations.
empyrean_determine_results_free^⚠: Free a batch result table previously written by empyrean_determine().
empyrean_download_data^⚠: Provision the complete Standard-tier kernel set into data_dir without building a context.
empyrean_eigenvector_max_6x6^⚠: Find the dominant eigenvalue and eigenvector of a 6x6 symmetric matrix.
empyrean_ephemeris_result_free^⚠: Free an ephemeris result previously returned by empyrean_generate_ephemeris().
empyrean_ephemeris_write_csv^⚠: Write ephemeris entries to CSV.
empyrean_ephemeris_write_json^⚠: Write ephemeris entries to JSON.
empyrean_ephemeris_write_parquet^⚠: Write ephemeris entries to parquet using the villeneuve schema.
empyrean_evaluate^⚠: Evaluate residuals for a single orbit against observations.
empyrean_evaluate_plan^⚠: Evaluate an observation plan: how much each candidate observation would tighten the prior orbit covariance.
empyrean_evaluate_result_free^⚠: Free an evaluate result previously returned by empyrean_evaluate().
empyrean_events_write_csv^⚠: Write events to CSV.
empyrean_events_write_json^⚠: Write events to JSON.
empyrean_events_write_parquet^⚠: Write events to parquet.
empyrean_fit_summary_write_csv^⚠: Write the per-object fit summary to CSV.
empyrean_fit_summary_write_json^⚠: Write the per-object fit summary to JSON.
empyrean_fit_summary_write_parquet^⚠: Write the per-object fit summary to parquet.
empyrean_generate_ephemeris^⚠: Generate predicted ephemeris for orbits and observers.
empyrean_get_observers^⚠: Compute observer states for given observatory codes and epochs, in a caller-chosen (frame, origin) basis.
empyrean_get_states^⚠: Query body states relative to a center body at given epochs.
empyrean_iso_to_mjd^⚠: Parse an ISO 8601 UTC string (e.g. "2024-08-01T00:00:00.000Z") to MJD in the requested target scale.
empyrean_last_error^⚠: Return a pointer to the last error message (thread-local, null-terminated).
empyrean_missing_data_files^⚠: Retrieve the structured file list from the most recent missing-data-files failure on this thread.
empyrean_missing_data_files_free^⚠: Free an EmpyreanMissingDataFiles populated by empyrean_missing_data_files. Passing a null or zeroed struct is a no-op; the struct is left zeroed so a double free is safe.
empyrean_mjd_to_iso^⚠: Format an MJD value (in the given scale) as an ISO 8601 UTC string.
empyrean_observations_free^⚠
empyrean_observations_from_array^⚠: Free an observation array previously returned by empyrean_read_ades(). Copy a caller-owned array of EmpyreanObservation into a fresh allocation that matches the layout produced by empyrean_read_ades.
empyrean_observer_result_free^⚠: Free an observer result previously returned by empyrean_get_observers().
empyrean_od_result_free^⚠: Free an OD result previously returned by empyrean_refine().
empyrean_orbit_covariance_free^⚠: Release the arrays owned by an EmpyreanOrbitCovariance written by empyrean_propagation_joint_at.
empyrean_orbits_batch_free^⚠: Free a batch previously returned by an empyrean_orbits_read_* function. Passing null is a no-op.
empyrean_orbits_read_csv^⚠: Read an orbits CSV file.
empyrean_orbits_read_json^⚠: Read an orbits JSON file (array of orbit-row objects). Caller frees with empyrean_orbits_batch_free.
empyrean_orbits_read_parquet^⚠: Read an orbits parquet file. Caller frees the result with empyrean_orbits_batch_free.
empyrean_orbits_write_csv^⚠: Write an orbit batch to CSV.
empyrean_orbits_write_json^⚠: Write an orbit batch to JSON.
empyrean_orbits_write_parquet^⚠: Write an orbit batch to a parquet file.
empyrean_plan_result_free^⚠: Free the heap allocations inside a plan result populated by empyrean_evaluate_plan. Does not free the caller-allocated struct.
empyrean_propagate^⚠: Propagate orbits to the requested target times.
empyrean_propagation_covariance_at_cartesian^⚠: Resolved-kind tagged covariance at a single (orbit_index, epoch_index), Cartesian basis (the gm-free point query). out is written on success.
empyrean_propagation_covariance_series_cartesian^⚠: Resolved-kind tagged covariance at every output epoch for one orbit, Cartesian basis. On success out_series owns the array; free with empyrean_tagged_covariance_series_free. On error out_series is left null and the detail is on empyrean_last_error().
empyrean_propagation_joint_at^⚠: The propagated joint’s CROSS terms at a single (orbit_index, epoch_index) — the state↔Marsden border and the wide carrier that EmpyreanTaggedCovariance::matrix is the state block of.
empyrean_propagation_result_free^⚠: Free a propagation result previously returned by empyrean_propagate().
empyrean_query_horizons^⚠: Query JPL Horizons for predicted ephemeris records.
empyrean_query_horizons_vectors^⚠: Query JPL Horizons for a Cartesian state vector at a single epoch.
empyrean_query_observations^⚠: Query the MPC observations API for ADES records of one or more designations.
empyrean_query_radar^⚠: Query the JPL sb_radar API for delay/Doppler radar astrometry of one or more designations.
empyrean_query_sbdb^⚠: Query the JPL Small-Body Database for one or more orbits.
empyrean_radar_observations_free^⚠: Free a radar observation array previously returned by empyrean_read_ades or empyrean_radar_observations_from_array.
empyrean_radar_observations_from_array^⚠: Copy a caller-owned array of EmpyreanRadarObservation into a fresh allocation matching the layout produced by empyrean_read_ades.
empyrean_read_ades^⚠: Read ADES PSV / MPC80 data from a string and pack into the C array.
empyrean_refine^⚠: Refine a single orbit estimate with new observations using a Bayesian prior.
empyrean_residuals_write_csv^⚠: Write OD residuals to CSV.
empyrean_residuals_write_json^⚠: Write OD residuals to JSON.
empyrean_residuals_write_parquet^⚠: Write OD residuals to parquet.
empyrean_session_diff^⚠: Diff the current fit against an earlier history entry. Returns 0 on success, -1 if there is no current fit or prior_idx is out of bounds.
empyrean_session_free^⚠: Free a session previously returned by empyrean_session_new. Passing null is a no-op.
empyrean_session_get_history^⚠: Copy the i-th history entry into result_out. Returns 0 on success, -1 on null/out-of-bounds. Caller frees result_out with empyrean_od_result_free.
empyrean_session_history_len^⚠: Number of fits in the session history.
empyrean_session_is_masked^⚠: Whether the observation at idx is masked. Returns 1 = masked, 0 = active, 255 (-1 cast) on null/out-of-bounds.
empyrean_session_mask^⚠: Mask the observation at idx. Returns 0 on success, -1 on null or out-of-bounds.
empyrean_session_n_active^⚠: Number of observations active (not masked) in the next refine.
empyrean_session_n_masked^⚠: Number of observations currently masked.
empyrean_session_n_observations^⚠: Total number of observations in the session (masked or not). Returns 0 if session is null.
empyrean_session_new^⚠: Construct a new orbit-determination session over a fixed observation set.
empyrean_session_refine^⚠: Run an OD refine using the current mask state.
empyrean_session_unmask^⚠: Unmask the observation at idx. Returns 0 on success, -1 on null or out-of-bounds.
empyrean_session_unmask_all^⚠: Clear all masks. Returns 0 on success, -1 on null.
empyrean_split_gaussian^⚠: Split a 6D Gaussian into K weighted components along the dominant eigenvector of the covariance.
empyrean_state_result_free^⚠: Free a state result previously returned by empyrean_get_states().
empyrean_string_free^⚠: Free a string returned by an empyrean C API function (e.g., empyrean_default_data_dir, empyrean_version_string).
empyrean_tagged_covariance_series_free^⚠: Free a series returned by empyrean_propagation_covariance_series_cartesian.
empyrean_transform_coordinates^⚠: Transform a batch of coordinate states to a new representation, frame, and/or origin.
empyrean_transform_coordinates_single^⚠: Transform one coordinate state to a new representation, frame, and/or origin.
empyrean_version_string^⚠: Multi-line version report — empyrean-core <ver>\nvilleneuve <ver>\n….
empyrean_versions^⚠: Populate out with the per-crate versions of the empyrean stack.
empyrean_versions_free^⚠: Free the version strings inside versions (each was heap-allocated by a previous successful empyrean_versions call). After this returns, versions itself is zero-initialized — safe to drop on the caller’s stack.
lib: The loaded libempyrean, opened lazily on first use.

Type Aliases§

EmpyreanContext: C FFI opaque handle. Internally an [empyrean_core::Context]; the C header forward-declares struct EmpyreanContext — callers only see the pointer.
EmpyreanSession: Opaque handle to an empyrean_core::determination::Session.