imap_processing.spice.time.et_to_utc

imap_processing.spice.time.et_to_utc(et: float | Iterable[float], format_str: str = 'ISOC', precision: int = 3, utclen: int = 24) → str | ndarray

Convert ephemeris time to UTC.

Decorated wrapper for spiceypy.et2utc that vectorizes the function in addition to wrapping with the @ensure_spice automatic kernel furnishing functionality. https://spiceypy.readthedocs.io/en/main/documentation.html#spiceypy.spiceypy.et2utc

Parameters:

• et (float or Iterable[float]) – Input ephemeris time(s) to be converted to UTC.

• format_str (str) – Format of the output time string. Default is “ISOC”. All options: “C” Calendar format, UTC. “D” Day-of-Year format, UTC. “J” Julian Date format, UTC. “ISOC” ISO Calendar format, UTC. “ISOD” ISO Day-of-Year format, UTC.

• precision (int) – Digits of precision in fractional seconds or days. Default is 3.

• utclen (int) – The length of the output string. Default is 24 (to accommodate the “YYYY-MM-DDT00:00:00.000” format + 1). From the NAIF docs: if the output string is expected to have x characters, utclen` must be x + 1.

Returns:

utc_time – UTC time(s).

Return type:

str or np.ndarray