pypeit.spectrographs.lbt_luci module

Module for LBT/LUCI specific methods.

class pypeit.spectrographs.lbt_luci.LBTLUCI1Spectrograph[source]

Bases: LBTLUCISpectrograph

Child to handle LBT/LUCI1 specific code

camera = 'LUCI1': Name of the spectrograph camera or arm. This is used by specdb, so use that naming convention

config_specific_par(inp, inp_par=None)[source]

Modify the PypeIt parameters to hard-wired values used for specific instrument configurations.

Parameters:

inp (str, list, Path, astropy.io.fits.Header, astropy.table.Table) – Input filename, an astropy.io.fits.Header object, or a list of astropy.io.fits.Header objects. Or a row from the metadata table.
inp_par (ParSet, optional) – Parameter set used for the full run of PypeIt. If None, use default_pypeit_par().

Returns:

The PypeIt parameter set adjusted for configuration specific parameter values.

Return type:

ParSet

classmethod default_pypeit_par()[source]

Return the default parameters to use for this instrument.

Returns:: Parameters required by all of PypeIt methods.
Return type:: PypeItPar

get_detector_par(det, hdu=None)[source]

Return metadata for the selected detector.

Parameters:

det (int) – 1-indexed detector number.
hdu (astropy.io.fits.HDUList, optional) – The open fits file with the raw image of interest. If not provided, frame-dependent parameters are set to a default.

Returns:

Object with the detector metadata.

Return type:

DetectorContainer

get_rawimage(raw_file, det)[source]

Read raw images and generate a few other bits and pieces that are key for image processing.

Warning

When reading multiple detectors for a mosaic, this function expects all detector arrays to have exactly the same shape.

Parameters:

raw_file (str) – File to read
det (int, tuple) – 1-indexed detector(s) to read. An image mosaic is selected using a tuple with the detectors in the mosaic, which must be one of the allowed mosaics returned by allowed_mosaics().

Returns:

detector (DetectorContainer, Mosaic) – Detector metadata parameters for one or more detectors.
raw (numpy.ndarray) – Raw image for this detector. Shape is 2D if a single detector image is read and 3D if multiple detectors are read. E.g., the image from the first detector in the tuple is accessed using raw_img[0].
hdu (astropy.io.fits.HDUList) – Opened fits file
texp (float) – Exposure time in seconds.
rawdatasec (numpy.ndarray) – Data (Science) section of the detector as provided by setting the (1-indexed) number of the amplifier used to read each detector pixel. Pixels unassociated with any amplifier are set to 0. Shape is identical to raw_img.
oscansec (numpy.ndarray) – Overscan section of the detector as provided by setting the (1-indexed) number of the amplifier used to read each detector pixel. Pixels unassociated with any amplifier are set to 0. Shape is identical to raw_img.

header_name = 'LUCI1': Name of the spectrograph camera or arm from the Header. Usually the INSTRUME card.

name = 'lbt_luci1': The name of the spectrograph. See Spectrographs for the currently supported spectrographs.

supported = True: Flag that PypeIt code base has been sufficiently tested with data from this spectrograph that it is officially supported by the development team.

class pypeit.spectrographs.lbt_luci.LBTLUCI2Spectrograph[source]

Bases: LBTLUCISpectrograph

Child to handle LBT/LUCI2 specific code

camera = 'LUCI2': Name of the spectrograph camera or arm. This is used by specdb, so use that naming convention

config_specific_par(inp, inp_par=None)[source]

Modify the PypeIt parameters to hard-wired values used for specific instrument configurations.

Parameters:

inp (str, list, Path, astropy.io.fits.Header, astropy.table.Table) – Input filename, an astropy.io.fits.Header object, or a list of astropy.io.fits.Header objects. Or a row from the metadata table.
inp_par (ParSet, optional) – Parameter set used for the full run of PypeIt. If None, use default_pypeit_par().

Returns:

The PypeIt parameter set adjusted for configuration specific parameter values.

Return type:

ParSet

classmethod default_pypeit_par()[source]

Return the default parameters to use for this instrument.

Returns:: Parameters required by all of PypeIt methods.
Return type:: PypeItPar

get_detector_par(det, hdu=None)[source]

Return metadata for the selected detector.

Parameters:

det (int) – 1-indexed detector number.
hdu (astropy.io.fits.HDUList, optional) – The open fits file with the raw image of interest. If not provided, frame-dependent parameters are set to a default.

Returns:

Object with the detector metadata.

Return type:

DetectorContainer

get_rawimage(raw_file, det)[source]

Read raw images and generate a few other bits and pieces that are key for image processing.

Warning

When reading multiple detectors for a mosaic, this function expects all detector arrays to have exactly the same shape.

Parameters:

raw_file (str) – File to read
det (int, tuple) – 1-indexed detector(s) to read. An image mosaic is selected using a tuple with the detectors in the mosaic, which must be one of the allowed mosaics returned by allowed_mosaics().

Returns:

detector (DetectorContainer, Mosaic) – Detector metadata parameters for one or more detectors.
raw (numpy.ndarray) – Raw image for this detector. Shape is 2D if a single detector image is read and 3D if multiple detectors are read. E.g., the image from the first detector in the tuple is accessed using raw_img[0].
hdu (astropy.io.fits.HDUList) – Opened fits file
texp (float) – Exposure time in seconds.
rawdatasec (numpy.ndarray) – Data (Science) section of the detector as provided by setting the (1-indexed) number of the amplifier used to read each detector pixel. Pixels unassociated with any amplifier are set to 0. Shape is identical to raw_img.
oscansec (numpy.ndarray) – Overscan section of the detector as provided by setting the (1-indexed) number of the amplifier used to read each detector pixel. Pixels unassociated with any amplifier are set to 0. Shape is identical to raw_img.

header_name = 'LUCI2': Name of the spectrograph camera or arm from the Header. Usually the INSTRUME card.

name = 'lbt_luci2': The name of the spectrograph. See Spectrographs for the currently supported spectrographs.

supported = True: Flag that PypeIt code base has been sufficiently tested with data from this spectrograph that it is officially supported by the development team.

class pypeit.spectrographs.lbt_luci.LBTLUCISpectrograph[source]

Bases: Spectrograph

Class to handle LBT/LUCI specific code

The provided default reduction parameters have been tailored and tested for LUCI1 and LUCI2 using the G200 low resolution grating and the zJspec and HKspec filters.

check_frame_type(ftype, fitstbl, exprng=None)[source]

Check for frames of the provided type.

Parameters:

ftype (str) – Type of frame to check. Must be a valid frame type; see frame-type Definitions.
fitstbl (astropy.table.Table) – The table with the metadata for one or more frames to check.
exprng (list, optional) – Range in the allowed exposure time for a frame of type ftype. See pypeit.core.framematch.check_frame_exptime().

Returns:

Boolean array with the flags selecting the exposures in fitstbl that are ftype type frames.

Return type:

numpy.ndarray

compound_meta(headarr, meta_key)[source]

Methods to generate metadata requiring interpretation of the header data, instead of simply reading the value of a header card.

Parameters:

headarr (list) – List of astropy.io.fits.Header objects.
meta_key (str) – Metadata keyword to construct.

Returns:

Metadata value read from the header(s).

Return type:

object

configuration_keys()[source]

Return the metadata keys that define a unique instrument configuration.

This list is used by PypeItMetaData to identify the unique configurations among the list of frames read for a given reduction.

Returns:: List of keywords of data pulled from file headers and used to constuct the PypeItMetaData object.
Return type:: list

init_meta()[source]

Define how metadata are derived from the spectrograph files.

That is, this associates the PypeIt-specific metadata keywords with the instrument-specific header cards using meta.

ndet = 1: Number of detectors for this instrument.

pypeit_file_keys()[source]

Define the list of keys to be output into a standard PypeIt file.

Returns:: The list of keywords in the relevant PypeItMetaData instance to print to the PypeIt Reduction File.
Return type:: list

raw_header_cards()[source]

Return additional raw header cards to be propagated in downstream output files for configuration identification.

The list of raw data FITS keywords should be those used to populate the configuration_keys() or are used in config_specific_par() for a particular spectrograph, if different from the name of the PypeIt metadata keyword.

This list is used by subheader_for_spec() to include additional FITS keywords in downstream output files.

Returns:: List of keywords from the raw data files that should be propagated in output files.
Return type:: list

telescope = Parameter Value Default Type Callable ---------------------------------------------------------------- name LBT KECK str False longitude -109.87190000000001 None int, float False latitude 32.70159999999999 None int, float False elevation 2901.9999999998176 None int, float False fratio None None int, float False diameter 8.4 None int, float False eff_aperture None None int, float False : Instance of TelescopePar providing telescope-specific metadata.

url = 'https://scienceops.lbto.org/luci/': Reference url