empyrean.get_states

get_states(target, center, epochs, frame=Frame.ECLIPTICJ2000)[source]

Query Cartesian states of a body from the SPK ephemeris.

Parameters:

  • target (Origin | str) – Target body. Pass an Origin (e.g. Origin.EARTH) or the canonical name (e.g. "Earth").

  • center (Origin | str) – Center body. Same shape as target.

  • epochs (Epochs) – Epochs table, converted to TDB internally. Build one with Epochs.from_mjd(values, scale="tdb") (or scale="utc"); a bare array is refused, as it carries no time scale.

  • frame (Frame | str) – Reference frame (default: EclipticJ2000).

Return type:

CartesianCoordinates

Returns:

CartesianCoordinates – Cartesian states (AU, AU/day) at each epoch.

Raises:

TypeError – epochs is not an Epochs table.