List of Gemini Standard Descriptors

To run and re-use Gemini primitives and functions this list of Standard Descriptors must be defined for input data. This also applies to data that is to be served by the Gemini Observatory Archive (GOA).

For any AstroData objects, to get the list of the descriptors that are defined use the AstroData.descriptors attribute:

>>> import astrodata
>>> import gemini_instruments
>>> ad = astrodata.open('../playdata/N20170609S0154.fits')

>>> ad.descriptors
('airmass', 'amp_read_area', 'ao_seeing', ..., 'well_depth_setting')

To get the values:

>>> ad.airmass()

>>> for descriptor in ad.descriptors:
...     print(descriptor, getattr(ad, descriptor)())

Note that not all of the descriptors below are defined for all of the instruments. For example, shuffle_pixels is defined only for GMOS data since only GMOS offers a Nod & Shuffle mode.

Descriptor	Short Definition	Python type
		ad[0].desc()
		ad.desc()
airmass	Airmass of the observation.	float
amp_read_area	Combination of amplifier name and 1-indexed section relative to the detector.	str
		list of str
ao_seeing	Estimate of the natural seeing as calculated from the adaptive optics systems.	float
array_name	Name assigned to the array generated by a given amplifier, one array per amplifier.	str
		list of str
array_section	Section covered by the array(s), in 0-indexed pixels, relative to the detector frame (e.g. position of multiple amps read within a CCD). Uses namedtuple “Section” defined in gemini_instruments.common.	Section
		list of Section
azimuth	Pointing position in azimuth, in degrees.	float
calibration_key	Key used in the database that the getProcessed* primitives use to store previous calibration association information.	str
camera	Name of the camera.	str
cass_rotator_pa	Position angle of the Cassegrain rotator, in degrees.	float
central_wavelength	Central wavelength, in meters.	float
coadds	Number of co-adds.	int
data_label	Gemini data label.	str
data_section	Section where the sky-exposed data falls, in 0-indexed pixels. Uses namedtuple “Section” defined in gemini_instruments.common	Section
		list of Section
dec	Declination of the center of the field, in degrees.	float
decker	Name of the decker.	str
detector_name	Name assigned to the detector.	str
detector_roi_setting	Human readable Region of Interest (ROI) setting	str
detector_rois_requested	Section defining the Regions of Interest, in 0-indexed pixels. Uses namedtuple “Section” defined in gemini_instruments.common.	list of Section
detector_section	Section covered by the detector(s), in 0-indexed pixels, relative to the whole mosaic of detectors. Uses namedtuple “Section” defined in gemini_instruments.common.	list
		list of Section
detector_x_bin	X-axis binning.	int
detector_x_offset	Telescope offset along the detector X-axis, in pixels.	float
detector_y_bin	Y-axis binning.	int
detector_y_offset	Telescope offset along the detector Y-axis, in pixels.	float
disperser	Name of the disperser.	str
dispersion	Value for the dispersion, in meters per pixel.	float
		list of float
dispersion_axis	Dispersion axis.	int
		list of int
effective_wavelength	Wavelength representing the bandpass or the spectrum coverage.	float
elevation	Pointing position in elevation, in degrees.	float
exposure_time	Exposure time, in seconds.	float
filter_name	Name of the filter combination.	str
focal_plane_mask	Name of the mask in the focal plane.	str
gain	Gain in electrons per ADU	float
		list of float
gain_setting	Human readable gain setting (eg. low, high)	str
gcal_lamp	Returns the name of the GCAL lamp being used, or “Off” if no lamp is in use.	str
group_id	Gemini observation group ID that identifies compatible data.	str
instrument	Name of the instrument	str
is_ao	Whether or not the adaptive optics system was used.	bool
is_coadds_summed	Whether co-adds are summed or averaged.	bool
local_time	Local time.	datetime
lyot_stop	Name of the lyot stop.	str
mdf_row_id	Mask Definition File row ID of a cut MOS or XD spectrum.	int ??
nod_count	Number of nods to A and B positions.	tuple of int
nod_offsets	Nod offsets to A and B positions, in arcseconds	tuple of float
nominal_atmospheric_extinction	Nomimal atmospheric extinction, from model.	float
nominal_photometric_zeropoint	Nominal photometric zeropoint.	float
		list of float
non_linear_level	Lower boundary of the non-linear regime.	float
		list of int
object	Name of the target (as entered by the user).	str
observation_class	Gemini class name for the observation (eg. ‘science’, ‘acq’, ‘dayCal’).	str
observation_epoch	Observation epoch.	float
observation_id	Gemini observation ID.	str
observation_type	Gemini observation type (eg. ‘OBJECT’, ‘FLAT’, ‘ARC’).	str
overscan_section	Section where the overscan data falls, in 0-indexed pixels. Uses namedtuple “Section” defined in gemini_instruments.common.	Section
		list of Section
pixel_scale	Pixel scale in arcsec per pixel.	float
program_id	Gemini program ID.	str
pupil_mask	Name of the pupil mask.	str ??
qa_state	Gemini quality assessment state (eg. pass, usable, fail).	str
ra	Right ascension, in degrees.	float
raw_bg	Gemini sky background band.	int ??
raw_cc	Gemini cloud coverage band.	int
raw_iq	Gemini image quality band.	int
raw_wv	Gemini water vapor band.	int ??
read_mode	Gemini name for combination for gain setting and read setting.	str
read_noise	Read noise in electrons.	float
		list of float
read_speed_setting	human readable read mode setting (eg. slow, fast).	str
requested_bg	PI requested Gemini sky background band.	int
requested_cc	PI requested Gemini cloud coverage band.	int
requested_iq	PI requested Gemini image quality band.	int
requested_wv	PI requested Gemini water vapor band.	int
saturation_level	Saturation level.	int
		list of int
shuffle_pixels	Charge shuffle, in pixels. (nod and shuffle mode)	int
slit	Name of the slit.	str
target_dec	Declination of the target, in degrees.	float
target_ra	Right Ascension of the target, in degrees.	float
telescope	Name of the telescope.	str
telescope_x_offset	Offset along the telescope’s x-axis.	float
telescope_y_offset	Offset along the telescope’s y-axis.	float
ut_date	UT date of the observation.	datetime.date
ut_datetime	UT date and time of the observation.	datetime
ut_time	UT time of the observation.	datetime.time
wavefront_sensor	Wavefront sensor used for the observation.	str
wavelength_band	Band associated with the filter or the central wavelength.	str
wcs_dec	Declination of the center of field from the WCS keywords. In degrees.	float
wcs_ra	Right Ascension of the center of field from the WCS keywords. In degrees.	float
well_depth_setting	Human readable well depth setting (eg. shallow, deep)	str