light_time_from_rx_epoch#

pride.astro.light_time_from_rx_epoch(tdb_rx: astropy.time.Time, xrec_bcrf_rx: numpy.ndarray, source_id: str, perturbing_bodies: list[str], precision: float, max_iterations: int) → astropy.time.TimeDelta#

Light-time from source to receiver

Given a reception epoch and the associated position of the receiver in BCRF, calculates the light-time for a source (transmitter) identified by a name or ID known to SPICE, using the Newton-Raphson algorithm as formulated in Duev 2012 (10.1051/0004-6361/201218885).

The estimated light-time results from iteratively solving the light-time equation with precision settings specified by the user, and considering post-Newtonian relativistic perturbations caused by the list of massive bodies passed as input.

The function returns the light-time between source and receiver in TDB seconds.

Parameters:

  • bcrf_rx – RX epoch in TDB

  • xrec_bcrf_rx – BCRF position vector of receiver at RX epoch

  • source_id – Name or ID of source known to SPICE

  • perturbing_bodies – List of names or IDs of massive bodies to be considered for relativistic corrections. Must be known to SPICE

  • precision – Tolerance to be used in the computation of the light-time

  • max_iterations – Maximum number of iterations to perform when computing the light-time when requested precision cannot be achieved.

Returns:

Light-time between source and receiver in TDB seconds