adam_core.coordinates.units module¶

Unit conversion utilities for coordinate systems.

This module provides functions to convert between different units commonly used in astrodynamics, particularly between AU/day and km/s systems.

adam_core.coordinates.units.au_to_km(values_au: float | ndarray) → float | ndarray[source]¶

Convert position values from AU to km.

Parameters:: values_au (float or np.ndarray) – Position values in AU
Returns:: Position values in km
Return type:: float or np.ndarray

adam_core.coordinates.units.km_to_au(values_km: float | ndarray) → float | ndarray[source]¶

Convert position values from km to AU.

Parameters:: values_km (float or np.ndarray) – Position values in km
Returns:: Position values in AU
Return type:: float or np.ndarray

adam_core.coordinates.units.au_per_day_to_km_per_s(values_au_day: float | ndarray) → float | ndarray[source]¶

Convert velocity values from AU/day to km/s.

Parameters:: values_au_day (float or np.ndarray) – Velocity values in AU/day
Returns:: Velocity values in km/s
Return type:: float or np.ndarray

adam_core.coordinates.units.km_per_s_to_au_per_day(values_km_s: float | ndarray) → float | ndarray[source]¶

Convert velocity values from km/s to AU/day.

Parameters:: values_km_s (float or np.ndarray) – Velocity values in km/s
Returns:: Velocity values in AU/day
Return type:: float or np.ndarray

adam_core.coordinates.units.convert_cartesian_covariance_au_to_km(covariance_au: ndarray) → ndarray[source]¶

Convert CartesianCoordinates covariance matrix from AU units to km units.

Parameters:: covariance_au (np.ndarray (N, 6, 6)) – Covariance matrices in AU and AU/day units
Returns:: Covariance matrices in km and km/s units
Return type:: np.ndarray (N, 6, 6)

Notes

The covariance matrix elements are converted as follows: - Position-position terms (AU²) → km² - Position-velocity terms (AU·AU/day) → km·km/s - Velocity-velocity terms ((AU/day)²) → (km/s)²

adam_core.coordinates.units.convert_cartesian_covariance_km_to_au(covariance_km: ndarray) → ndarray[source]¶

Convert CartesianCoordinates covariance matrix from km units to AU units.

Parameters:: covariance_km (np.ndarray (N, 6, 6)) – Covariance matrices in km and km/s units
Returns:: Covariance matrices in AU and AU/day units
Return type:: np.ndarray (N, 6, 6)

Notes

The covariance matrix elements are converted as follows: - Position-position terms (km²) → AU² - Position-velocity terms (km·km/s) → AU·AU/day - Velocity-velocity terms ((km/s)²) → (AU/day)²

adam_core.coordinates.units.convert_cartesian_values_au_to_km(values_au: ndarray) → ndarray[source]¶

Convert CartesianCoordinates values from AU/AU-day to km/km-s units.

Parameters:: values_au (np.ndarray (N, 6)) – Coordinate values in AU and AU/day units: [x, y, z, vx, vy, vz] where positions are in AU and velocities in AU/day
Returns:: Coordinate values in km and km/s units: [x, y, z, vx, vy, vz] where positions are in km and velocities in km/s
Return type:: np.ndarray (N, 6)

adam_core.coordinates.units.convert_cartesian_values_km_to_au(values_km: ndarray) → ndarray[source]¶

Convert CartesianCoordinates values from km/km-s to AU/AU-day units.

Parameters:: values_km (np.ndarray (N, 6)) – Coordinate values in km and km/s units: [x, y, z, vx, vy, vz] where positions are in km and velocities in km/s
Returns:: Coordinate values in AU and AU/day units: [x, y, z, vx, vy, vz] where positions are in AU and velocities in AU/day
Return type:: np.ndarray (N, 6)