pynrc.simul.skyvec2ins.skyvec2ins

pynrc.simul.skyvec2ins.skyvec2ins(ra, dec, start_date, npoints=360, nrolls=15, maxvroll=7.0)[source]

JWST coronagraphic target visibility calculator.

Parameters

  • ra (float) – Right ascension of science target in decimal degrees (0-360)

  • dec (float) – Declination of science target in decimal degrees (-90, 90)

  • start_date (datetime.datetime) – Start date of the year-long interval evaluated by skyvec2ins

  • npoints (int) – Number of points to sample in the year-long interval to find observable dates (default: 360)

  • nrolls (int) – Number of roll angles in the allowed roll angle range to sample at each date (default: 15)

  • maxvroll (float) – Maximum number of degrees positive or negative roll around the boresight to allow (as designed: 7.0)

  • .. note:: – lambda_rad0 is the longitude of quadrature at day 0 of the code, so it should be 90 deg W of the solar longitude.

Returns

  • x (numpy.ndarray) – Float array of length npoints containing days from starting date

  • observable (numpy.ndarray) – uint8 array of shape (nrolls, npoints) that is 1 where the target is observable and 0 otherwise

  • elongation_rad (numpy.ndarray) – Float array of length npoints containing elongation of the observatory in radians

  • roll_rad (numpy.ndarray) – Float array of shape (nrolls, npoints) containing V3 PA in radians

  • c1_x, c1_y, c2_x, c2_y, c3_x, c3_y (numpy.ndarray) – Float array of shape (nrolls, npoints) containing the location of the companions in “Idl” (ideal) frame coordinates

  • n_x, n_y, e_x, e_y (numpy.ndarray) – Float array of shape (nrolls, npoints) containing the location of a reference “north” vector and “east” vector from the center in “Idl” (ideal) frame coordinates