observed_from_pupil_coords¶
- rubin_sim.utils.observed_from_pupil_coords(x_pupil, y_pupil, obs_metadata=None, include_refraction=True, epoch=2000.0)¶
Convert pupil coordinates into observed (RA, Dec)
@param [in] x_pupil – pupil coordinates in radians. Can be a numpy array or a number.
@param [in] y_pupil – pupil coordinates in radians. Can be a numpy array or a number.
@param [in] obs_metadata – an instantiation of ObservationMetaData characterizing the state of the telescope
@param [in] epoch – julian epoch of the mean equinox used for the coordinate transformations (in years; defaults to 2000)
@param[in] include_refraction – a
bool
which controls the effects of refraction (refraction is used when finding the observed coordinates of the boresite specified by obs_metadata)@param [out] a 2-D numpy array in which the first row is observed RA and the second row is observed Dec (both in degrees). Note: these are not ICRS coordinates. These are RA and Dec-like coordinates resulting from applying precession, nutation, diurnal aberration and annual aberration on top of ICRS coordinates.
WARNING: This method does not account for apparent motion due to parallax. This method is only useful for mapping positions on a theoretical focal plane to positions on the celestial sphere.