timeline

jwst_novt.timeline.timeline(ra, dec, start_date=None, end_date=None, instrument=None)[source]

Retrieve a visibility timeline for NIRSpec and NIRCam.

Calls jwst_gtvt.Ephemeris for target visibility and position angle (PA). PA values for times at which the target is not visible are set to NaN.

Parameters:

  • ra (float) – Instrument center RA in degrees.

  • dec (float) – Instrument center Dec in degrees.

  • start_date (astropy.time.Time, optional) – If not specified, the current time is used.

  • end_date (astropy.time.Time, optional) – If not specified, the start_date plus one year is used.

  • instrument ({'NIRSpec', 'NIRCam'}, optional) – If not specified, both NIRSpec and NIRCam data are returned, using the same RA and Dec for the instrument center.

Returns:

timeline_dataframe – Columns are Time (datetime), V3PA (JWST V3 PA), {instrument}_min_PA (minimum PA for instrument), and {instrument}_max_PA (maximum PA for instrument), where instrument may be NIRCAM, NIRSPEC, or both.

Return type:

pandas.DataFrame