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. Azimuth and elevation pairs are always the final dimension of the array. 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 (…, 2) where … matches the leading dimensions of the 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