gemini_instruments.gsaoi package

class gemini_instruments.gsaoi.AstroDataGsaoi(nddata=None, tables=None, phu=None, indices=None)[source]

Bases: gemini_instruments.gemini.adclass.AstroDataGemini

array_name()[source]

Returns a list of the array names of each extension

Returns

names of the arrays

Return type

list/str

central_wavelength(asMicrometers=False, asNanometers=False, asAngstroms=False)[source]

Returns the central wavelength in meters or the specified units

Parameters
  • asMicrometers (bool) – If True, return the wavelength in microns

  • asNanometers (bool) – If True, return the wavelength in nanometers

  • asAngstroms (bool) – If True, return the wavelength in Angstroms

Returns

The central wavelength setting

Return type

float

gain()[source]

Returns the gain (electrons/ADU) of the extensions

Returns

gain (e/ADU)

Return type

list/float

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.

Returns

A group ID for compatible data

Return type

str

is_coadds_summed()[source]

Tells whether or not the co-adds have been summed. If not, they have been averaged. GSAOI averages them.

Returns

True if the data has been summed. False if it has been averaged.

Return type

bool

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 ADU.

Returns

Value at which the data become non-linear

Return type

int/list

nonlinearity_coeffs()[source]

For each extension, return a tuple (a0,a1,a2) of coefficients such that the linearized counts are a0 + a1*c _ a2*c^2 for raw counts c

Returns

coefficients

Return type

tuple/list

read_noise()[source]

Returns the read noise of each extension in electrons, as a float or a list of floats

Returns

read noise in electrons

Return type

float/list

read_speed_setting()[source]

Returns a string describing the read speed setting, as used in the OT

Returns

read speed setting

Return type

str

saturation_level()[source]

Returns the saturation level in ADU for each extension, as a list or a single value

Returns

saturation level in ADU

Return type

int/list

wcs_dec()[source]

Returns the Declination of the center of the field based on the WCS rather than the DEC keyword. This just uses the CRVAL2 keyword.

Returns

declination in degrees

Return type

float

wcs_ra()[source]

Returns the Right Ascension of the center of the field based on the WCS rather than the RA keyword. This just uses the CRVAL1 keyword.

Returns

right ascension in degrees

Return type

float

Submodules

gemini_instruments.gsaoi.adclass module

class gemini_instruments.gsaoi.adclass.AstroDataGsaoi(nddata=None, tables=None, phu=None, indices=None)[source]

Bases: gemini_instruments.gemini.adclass.AstroDataGemini

array_name()[source]

Returns a list of the array names of each extension

Returns

names of the arrays

Return type

list/str

central_wavelength(asMicrometers=False, asNanometers=False, asAngstroms=False)[source]

Returns the central wavelength in meters or the specified units

Parameters
  • asMicrometers (bool) – If True, return the wavelength in microns

  • asNanometers (bool) – If True, return the wavelength in nanometers

  • asAngstroms (bool) – If True, return the wavelength in Angstroms

Returns

The central wavelength setting

Return type

float

gain()[source]

Returns the gain (electrons/ADU) of the extensions

Returns

gain (e/ADU)

Return type

list/float

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.

Returns

A group ID for compatible data

Return type

str

is_coadds_summed()[source]

Tells whether or not the co-adds have been summed. If not, they have been averaged. GSAOI averages them.

Returns

True if the data has been summed. False if it has been averaged.

Return type

bool

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 ADU.

Returns

Value at which the data become non-linear

Return type

int/list

nonlinearity_coeffs()[source]

For each extension, return a tuple (a0,a1,a2) of coefficients such that the linearized counts are a0 + a1*c _ a2*c^2 for raw counts c

Returns

coefficients

Return type

tuple/list

read_noise()[source]

Returns the read noise of each extension in electrons, as a float or a list of floats

Returns

read noise in electrons

Return type

float/list

read_speed_setting()[source]

Returns a string describing the read speed setting, as used in the OT

Returns

read speed setting

Return type

str

saturation_level()[source]

Returns the saturation level in ADU for each extension, as a list or a single value

Returns

saturation level in ADU

Return type

int/list

wcs_dec()[source]

Returns the Declination of the center of the field based on the WCS rather than the DEC keyword. This just uses the CRVAL2 keyword.

Returns

declination in degrees

Return type

float

wcs_ra()[source]

Returns the Right Ascension of the center of the field based on the WCS rather than the RA keyword. This just uses the CRVAL1 keyword.

Returns

right ascension in degrees

Return type

float

gemini_instruments.gsaoi.lookup module

class gemini_instruments.gsaoi.lookup.ArrayProperties(readnoise, gain, welldepth, linlimit, coeffs, nonlinlimit)

Bases: tuple

property coeffs

Alias for field number 4

property gain

Alias for field number 1

property linlimit

Alias for field number 3

property nonlinlimit

Alias for field number 5

property readnoise

Alias for field number 0

property welldepth

Alias for field number 2