gemini_instruments.gmos package
- class gemini_instruments.gmos.AstroDataGmos(nddata=None, tables=None, phu=None, indices=None, is_single=False)[source]
Bases:
AstroDataGemini- amp_read_area()[source]
Returns a list of amplifier read areas, one per extension, made by combining the amplifier name and detector section. Or returns a string if called on a single-extension slice.
- Returns:
read_area of each extension
- Return type:
list/str
- array_name()[source]
Returns a list of the names of the arrays of the extensions, or a string if called on a single-extension slice
- Returns:
names of the arrays
- Return type:
list/str
- central_wavelength(asMicrometers=False, asNanometers=False, asAngstroms=False, pretty=False)[source]
Returns the central wavelength in meters or specified units
- Parameters:
- Returns:
The central wavelength setting
- Return type:
- detector_name(pretty=False)[source]
Returns the name(s) of the detector(s), from the PHU DETID keyword. Calling with pretty=True will provide a single descriptive string.
- detector_roi_setting()[source]
Looks at the first ROI and returns a descriptive string describing it These are more or less the options in the OT
- Returns:
Name of the ROI setting used or “Custom” if the ROI doesn’t match “Undefined” if there’s no ROI in the header
- Return type:
- detector_rois_requested()[source]
Returns a list of ROIs, as tuples in a 1-based inclusive (IRAF-like) format (x1, x2, y1, y2), in physical (unbinned) pixels.
- Return type:
list of tuples, one per ROI
- detector_x_bin()[source]
Returns the detector binning in the x-direction
- Returns:
The detector binning
- Return type:
- detector_x_offset()[source]
Returns the offset from the reference position in pixels along the positive x-direction of the detector
- Returns:
The offset in pixels
- Return type:
- detector_y_bin()[source]
Returns the detector binning in the y-direction
- Returns:
The detector binning
- Return type:
- detector_y_offset()[source]
Returns the offset from the reference position in pixels along the positive y-direction of the detector
- Returns:
The offset in pixels
- Return type:
- disperser(stripID=False, pretty=False)[source]
Returns the name of the disperser used for the observation. In GMOS, the disperser is a grating.
- dispersion(asMicrometers=False, asNanometers=False, asAngstroms=False)[source]
Returns the dispersion in meters per binned pixel as a list (one value per extension) or a float if used on a single-extension slice. It is possible to control the units of wavelength using the input arguments.
- dispersion_axis()[source]
Returns the axis along which the light is dispersed.
- Returns:
Dispersion axis.
- Return type:
(list of) int (1)
- gain()
Returns the gain (electrons/ADU) for each extension
- Returns:
Gains used for the observation
- Return type:
list of floats/float
- gain_setting()[source]
Returns the gain settings of the observation.
- Returns:
Gain setting
- Return type:
- group_id()[source]
Returns a string representing a group of data that are compatible with each other. This is used when stacking, for example. Each instrument and mode of observation will have its own rules.
GMOS uses the detector binning, amp_read_area, gain_setting, and read_speed_setting. Flats and twilights have the pretty version of the filter name included. Science data have the pretty filter name and observation_id as well. And spectroscopic data have the grating. Got all that?
- Returns:
A group ID for compatible data.
- Return type:
- instrument(generic=False)[source]
Returns the name of the instrument making the observation
- Parameters:
generic (boolean) – If set, don’t specify the specific instrument if there are clones (e.g., return “GMOS” rather than “GMOS-N” or “GMOS-S”)
- Returns:
instrument name
- Return type:
- nod_count()[source]
Returns a tuple with the number of integrations made in each of the nod-and-shuffle positions
- Returns:
number of integrations in the A and B positions
- Return type:
- nod_offsets()[source]
Returns a tuple with the offsets from the default telescope position of the A and B nod-and-shuffle positions (in arcseconds)
- Returns:
offsets in arcseconds
- Return type:
- nominal_photometric_zeropoint()[source]
Returns the nominal zeropoints (i.e., the magnitude corresponding to a pixel value of 1) for the extensions in an AD object. Zeropoints in table are for electrons, so subtract 2.5*lg(gain) if the data are in ADU
- Returns:
zeropoint values, one per SCI extension
- Return type:
float/list
- non_linear_level()[source]
Returns the level at which the data become non-linear, in the units of the data. For GMOS, this is just the saturation level.
- Returns:
Value(s) at which the data become non-linear
- Return type:
int/list
- overscan_section(pretty=False)[source]
Returns the overscan (or bias) section. If pretty is False, a tuple of 0-based coordinates is returned with format (x1, x2, y1, y2). If pretty is True, a keyword value is returned without parsing as a string. In this format, the coordinates are generally 1-based.
One tuple or string is return per extension/array. If more than one array, the tuples/strings are return in a list. Otherwise, the section is returned as a tuple or a string.
- Parameters:
pretty (bool) – If True, return the formatted string found in the header.
- Returns:
tuple of integers or list of tuples – Position of the overscan section using Python slice values.
string or list of strings – Position of the overscan section using an IRAF section format (1-based).
- pixel_scale()[source]
Returns the image scale in arcsec per pixel, accounting for binning
- Returns:
pixel scale
- Return type:
- position_angle()[source]
Returns the position angle of the instruement
- Returns:
the position angle (East of North) of the +ve y-direction
- Return type:
- read_mode()[source]
Returns a string describing the readout mode, which sets the gain and readout speed
- Returns:
read mode used
- Return type:
- read_noise()
Returns the read noise in electrons for each extension. A list is returned unless called on a single-extension slice, when a float
- Returns:
the read noise
- Return type:
float/list of floats
- read_speed_setting()[source]
Returns the setting for the readout speed (slow or fast)
- Returns:
the setting for the readout speed
- Return type:
- saturation_level()
Returns the saturation level of the data, in the units of the data. This is expected to be overridden by the individual instruments, so at the Gemini level it returns the values of the SATLEVEL keyword (or None).
- Returns:
saturation level (in units of the data)
- Return type:
list/float
- shuffle_pixels()[source]
Returns the number of rows that the charge has been shuffled, in nod-and-shuffle data
- Returns:
The number of rows by which the charge is shuffled
- Return type:
- slit_width()[source]
Returns the width of the slit in arcseconds
- Returns:
the slit width in arcseconds
- Return type:
float/None
Submodules
gemini_instruments.gmos.adclass module
- class gemini_instruments.gmos.adclass.AstroDataGmos(nddata=None, tables=None, phu=None, indices=None, is_single=False)[source]
Bases:
AstroDataGemini- amp_read_area()[source]
Returns a list of amplifier read areas, one per extension, made by combining the amplifier name and detector section. Or returns a string if called on a single-extension slice.
- Returns:
read_area of each extension
- Return type:
list/str
- array_name()[source]
Returns a list of the names of the arrays of the extensions, or a string if called on a single-extension slice
- Returns:
names of the arrays
- Return type:
list/str
- central_wavelength(asMicrometers=False, asNanometers=False, asAngstroms=False, pretty=False)[source]
Returns the central wavelength in meters or specified units
- Parameters:
- Returns:
The central wavelength setting
- Return type:
- detector_name(pretty=False)[source]
Returns the name(s) of the detector(s), from the PHU DETID keyword. Calling with pretty=True will provide a single descriptive string.
- detector_roi_setting()[source]
Looks at the first ROI and returns a descriptive string describing it These are more or less the options in the OT
- Returns:
Name of the ROI setting used or “Custom” if the ROI doesn’t match “Undefined” if there’s no ROI in the header
- Return type:
- detector_rois_requested()[source]
Returns a list of ROIs, as tuples in a 1-based inclusive (IRAF-like) format (x1, x2, y1, y2), in physical (unbinned) pixels.
- Return type:
list of tuples, one per ROI
- detector_x_bin()[source]
Returns the detector binning in the x-direction
- Returns:
The detector binning
- Return type:
- detector_x_offset()[source]
Returns the offset from the reference position in pixels along the positive x-direction of the detector
- Returns:
The offset in pixels
- Return type:
- detector_y_bin()[source]
Returns the detector binning in the y-direction
- Returns:
The detector binning
- Return type:
- detector_y_offset()[source]
Returns the offset from the reference position in pixels along the positive y-direction of the detector
- Returns:
The offset in pixels
- Return type:
- disperser(stripID=False, pretty=False)[source]
Returns the name of the disperser used for the observation. In GMOS, the disperser is a grating.
- dispersion(asMicrometers=False, asNanometers=False, asAngstroms=False)[source]
Returns the dispersion in meters per binned pixel as a list (one value per extension) or a float if used on a single-extension slice. It is possible to control the units of wavelength using the input arguments.
- dispersion_axis()[source]
Returns the axis along which the light is dispersed.
- Returns:
Dispersion axis.
- Return type:
(list of) int (1)
- gain()
Returns the gain (electrons/ADU) for each extension
- Returns:
Gains used for the observation
- Return type:
list of floats/float
- gain_setting()[source]
Returns the gain settings of the observation.
- Returns:
Gain setting
- Return type:
- group_id()[source]
Returns a string representing a group of data that are compatible with each other. This is used when stacking, for example. Each instrument and mode of observation will have its own rules.
GMOS uses the detector binning, amp_read_area, gain_setting, and read_speed_setting. Flats and twilights have the pretty version of the filter name included. Science data have the pretty filter name and observation_id as well. And spectroscopic data have the grating. Got all that?
- Returns:
A group ID for compatible data.
- Return type:
- instrument(generic=False)[source]
Returns the name of the instrument making the observation
- Parameters:
generic (boolean) – If set, don’t specify the specific instrument if there are clones (e.g., return “GMOS” rather than “GMOS-N” or “GMOS-S”)
- Returns:
instrument name
- Return type:
- nod_count()[source]
Returns a tuple with the number of integrations made in each of the nod-and-shuffle positions
- Returns:
number of integrations in the A and B positions
- Return type:
- nod_offsets()[source]
Returns a tuple with the offsets from the default telescope position of the A and B nod-and-shuffle positions (in arcseconds)
- Returns:
offsets in arcseconds
- Return type:
- nominal_photometric_zeropoint()[source]
Returns the nominal zeropoints (i.e., the magnitude corresponding to a pixel value of 1) for the extensions in an AD object. Zeropoints in table are for electrons, so subtract 2.5*lg(gain) if the data are in ADU
- Returns:
zeropoint values, one per SCI extension
- Return type:
float/list
- non_linear_level()[source]
Returns the level at which the data become non-linear, in the units of the data. For GMOS, this is just the saturation level.
- Returns:
Value(s) at which the data become non-linear
- Return type:
int/list
- overscan_section(pretty=False)[source]
Returns the overscan (or bias) section. If pretty is False, a tuple of 0-based coordinates is returned with format (x1, x2, y1, y2). If pretty is True, a keyword value is returned without parsing as a string. In this format, the coordinates are generally 1-based.
One tuple or string is return per extension/array. If more than one array, the tuples/strings are return in a list. Otherwise, the section is returned as a tuple or a string.
- Parameters:
pretty (bool) – If True, return the formatted string found in the header.
- Returns:
tuple of integers or list of tuples – Position of the overscan section using Python slice values.
string or list of strings – Position of the overscan section using an IRAF section format (1-based).
- pixel_scale()[source]
Returns the image scale in arcsec per pixel, accounting for binning
- Returns:
pixel scale
- Return type:
- position_angle()[source]
Returns the position angle of the instruement
- Returns:
the position angle (East of North) of the +ve y-direction
- Return type:
- read_mode()[source]
Returns a string describing the readout mode, which sets the gain and readout speed
- Returns:
read mode used
- Return type:
- read_noise()
Returns the read noise in electrons for each extension. A list is returned unless called on a single-extension slice, when a float
- Returns:
the read noise
- Return type:
float/list of floats
- read_speed_setting()[source]
Returns the setting for the readout speed (slow or fast)
- Returns:
the setting for the readout speed
- Return type:
- saturation_level()
Returns the saturation level of the data, in the units of the data. This is expected to be overridden by the individual instruments, so at the Gemini level it returns the values of the SATLEVEL keyword (or None).
- Returns:
saturation level (in units of the data)
- Return type:
list/float
- shuffle_pixels()[source]
Returns the number of rows that the charge has been shuffled, in nod-and-shuffle data
- Returns:
The number of rows by which the charge is shuffled
- Return type:
- slit_width()[source]
Returns the width of the slit in arcseconds
- Returns:
the slit width in arcseconds
- Return type:
float/None