nircam_dither_footprint

jwst_novt.footprints.nircam_dither_footprint(ra, dec, pa, *, dither_pattern='NONE', channel='long', add_mosaic=False, mosaic_offset=None, include_center=True, apertures=None)[source]

Dither and/or mosaic the NIRCam aperture footprint.

Parameters:

  • ra (float) – RA of NIRCam center, in degrees.

  • dec (float) – Dec of NIRCam center, in degrees.

  • pa (float) – Position angle for NIRCam, in degrees measured from North to central vertical axis in North to East direction.

  • dither_pattern (str, optional) – Name of the dither pattern to apply. Options are: NONE, FULL3, FULL3TIGHT, FULL6, 8NIRSPEC.

  • channel ({'short', 'long'}, optional) – The NIRCam channel to generate aperture footprints for.

  • add_mosaic (bool, optional) – If False, mosaic offsets are ignored. Otherwise, a two-tile mosaic is computed with window width specified in mosaic_offset.

  • mosaic_offset (tuple or list, optional) – (V2, V3) offset in telescope coordinates to apply as a two-tile mosaic offset. The offset is specified as a window width around the pointing center: the mosaic position will be at the center +/- offset / 2. Ignored if dither_pattern is 8NIRSPEC or instrument is NIRSpec or add_mosaic is not set.

  • include_center (bool, optional) – If set, the center is marked with a Point region. If not, only the apertures are included in the output.

  • apertures (list of str, optional) – If set, only the specified apertures are returned.

Returns:

footprint – NIRCam footprint regions. NIRCam center is marked with a Point region; all other apertures are marked with Polygon regions. Output regions are in sky coordinates.

Return type:

regions.Regions