opihiexarata.ephemeris.solution module

The ephemeris solution class.

class opihiexarata.ephemeris.solution.EphemeriticSolution(orbitals: OrbitalSolution, solver_engine: EphemerisEngine, vehicle_args: dict = {})[source]

Bases: ExarataSolution

This obtains the ephemeris of an asteroid using an ephemeris engine provided the Keplerian orbital elements of the asteroid as determined by orbital solutions.

orbitals

The orbital solution from which the orbital elements will be taken from to determine the orbit of the target.

Type:

OrbitalSolution

ra_velocity

The right ascension angular velocity of the target, in degrees per second.

Type:

float

dec_velocity

The declination angular velocity of the target, in degrees per second.

Type:

float

ra_acceleration

The right ascension angular acceleration of the target, in degrees per second squared.

Type:

float

dec_acceleration

The declination angular acceleration of the target, in degrees per second squared.

Type:

float

__init__(orbitals: OrbitalSolution, solver_engine: EphemerisEngine, vehicle_args: dict = {}) → None[source]

Instantiating the solution class.

Parameters:

  • orbitals (OrbitalSolution) – The orbital solution from which the orbital elements will be taken from to determine the orbit of the target.

  • solver_engine (EphemerisEngine) – The ephemeris solver engine class. This is what will act as the “behind the scenes” and solve the orbit, using this middleware to translate it into something that is easier to read.

  • vehicle_args (dictionary) – If the vehicle function for the provided solver engine needs extra parameters not otherwise provided by the standard input, they are given here.

Return type:

None

forward_ephemeris(future_time: ndarray) → tuple[ndarray, ndarray][source]

A wrapper call around the engine’s ephemeris function. This allows the computation of future positions at a future time using the ephemeris derived from the orbital elements.

Parameters:

future_time (array-like) – The set of future times which to derive new RA and DEC coordinates. The time must be in Julian days.

Returns:

  • future_ra (ndarray) – The set of right ascensions that corresponds to the future times, in degrees.

  • future_dec (ndarray) – The set of declinations that corresponds to the future times, in degrees.

opihiexarata.ephemeris.solution._vehicle_jpl_horizons_web_api(orbitals: OrbitalSolution)[source]

This uses the JPL Horizons web URL API service to derive the ephemeris.

Parameters:

orbitals (OrbitalSolution) – The orbital solution to use to get the orbital elements to send off to the JPL Horizons API.

Returns:

ephemeris_results – The results of the ephemeris engine which then gets integrated into the solution.

Return type:

dictionary