imap_processing.spice.geometry.frame_transform_az_el

imap_processing.spice.geometry.frame_transform_az_el(et: float | ndarray[tuple[int, ...], dtype[_ScalarType_co]], az_el: ndarray[tuple[int, ...], dtype[_ScalarType_co]], from_frame: SpiceFrame, to_frame: SpiceFrame, degrees: bool = True) → ndarray[tuple[int, ...], dtype[_ScalarType_co]]

Transform azimuth and elevation coordinates between reference frames.

Parameters:

• et (float or np.ndarray) – Ephemeris time(s) corresponding to position(s).

• az_el (np.ndarray) – <azimuth, elevation> vector or array of vectors in reference frame from_frame. There are several possible shapes for the input az_el and et: 1. A single az_el vector may be provided for multiple et query times 2. A single et may be provided for multiple az_el vectors, 3. The same number of et and az_el vectors may be provided. It is not allowed to have n az_el vectors and m et, where n != m.

• from_frame (SpiceFrame) – Reference frame of input coordinates.

• to_frame (SpiceFrame) – Reference frame of output coordinates.

• degrees (bool) – If True, azimuth and elevation input and output will be in degrees.

Returns:

to_frame_az_el – Azimuth/elevation coordinates in reference frame to_frame. This output coordinate vector will have shape (2,) if a single az_el position vector and single et time are input. Otherwise, it will have shape (n, 2) where n is the number of input position vector or ephemeris times. The last axis of the output vector contains azimuth in the 0th position and elevation in the 1st position.

Return type:

np.ndarray