imap_processing.spice.geometry.instrument_pointing

imap_processing.spice.geometry.instrument_pointing(et: float | ndarray[tuple[int, ...], dtype[_ScalarType_co]], instrument: SpiceFrame, to_frame: SpiceFrame, cartesian: bool = False) → ndarray[tuple[int, ...], dtype[_ScalarType_co]]

Compute the instrument pointing at the specified times.

By default, the coordinates returned are (Longitude, Latitude) coordinates in the reference frame to_frame. Cartesian coordinates can be returned if desired by setting cartesian=True.

Parameters:

• et (float or np.ndarray) – Ephemeris time(s) to at which to compute instrument pointing.

• instrument (SpiceFrame) – Instrument reference frame to compute the pointing for.

• to_frame (SpiceFrame) – Reference frame in which the pointing is to be expressed.

• cartesian (bool) – If set to True, the pointing is returned in Cartesian coordinates. Defaults to False.

Returns:

pointing – The instrument pointing at the specified times.

Return type:

np.ndarray