pypeit.spectrographs.magellan_fire module
Module for Magellan/FIRE specific methods.
Important Notes:
If you are reducing old FIRE data (before the broken happened in 2016), please change the ord_spat_pos array (see lines from ~220 to ~230)
- class pypeit.spectrographs.magellan_fire.MagellanFIREEchelleSpectrograph[source]
Bases:
MagellanFIRESpectrograph
Child to handle Magellan/FIRE Echelle data
Note
For FIRE Echelle, we usually use high gain and SUTR read mode. The exposure time is usually around 900s. The detector parameters below are based on such mode. Standard star and calibrations are usually use Fowler 1 read mode in which case the read noise is ~20 electron.
- 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 typeftype
. Seepypeit.core.framematch.check_frame_exptime()
.
- Returns:
Boolean array with the flags selecting the exposures in
fitstbl
that areftype
type frames.- Return type:
- comment = 'Magellan/FIRE in echelle mode'
A brief comment or description regarding PypeIt usage with this spectrograph.
- classmethod default_pypeit_par()[source]
Return the default parameters to use for this instrument.
- Returns:
Parameters required by all of PypeIt methods.
- Return type:
- property dloglam
Return the logarithmic step in wavelength for output spectra.
- ech_fixed_format = True
If an echelle spectrograph, this will be set to a boolean indicating whether it is a fixed format or tiltable echelle.
- 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:
- property loglam_minmax
Return the base-10 logarithm of the first and last wavelength for ouput spectra.
- name = 'magellan_fire'
The name of the spectrograph. See Spectrographs for the currently supported spectrographs.
- property norders
Number of orders for this spectograph. Should only defined for echelle spectrographs, and it is undefined for the base class.
- order_platescale(order_vec, binning=None)[source]
Return the platescale for each echelle order.
Note that FIRE has no binning.
- Parameters:
order_vec (numpy.ndarray) – The vector providing the order numbers.
binning (
str
, optional) – The string defining the spectral and spatial binning. This is always ignored.
- Returns:
An array with the platescale for each order provided by
order
.- Return type:
- property order_spat_pos
Return the expected spatial position of each echelle order.
- property orders
Return the order number for each echelle order.
- pypeline = 'Echelle'
String used to select the general pipeline approach for this spectrograph.
- property spec_min_max
Return the minimum and maximum spectral pixel expected for the spectral range of each order.
- 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.magellan_fire.MagellanFIRELONGSpectrograph[source]
Bases:
MagellanFIRESpectrograph
Child to handle Magellan/FIRE high-throughput data
Note
For FIRE longslit, science data are usually taken with SUTR readout mode with ~600s exposure (at least for quasar hunting people) and the readout noise is ~6 e-
- 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 typeftype
. Seepypeit.core.framematch.check_frame_exptime()
.
- Returns:
Boolean array with the flags selecting the exposures in
fitstbl
that areftype
type frames.- Return type:
- comment = 'Magellan/FIRE in long-slit/high-throughput mode'
A brief comment or description regarding PypeIt usage with this spectrograph.
- classmethod default_pypeit_par()[source]
Return the default parameters to use for this instrument.
- Returns:
Parameters required by all of PypeIt methods.
- Return type:
- 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:
- name = 'magellan_fire_long'
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.magellan_fire.MagellanFIRESpectrograph[source]
Bases:
Spectrograph
Child to handle Magellan/FIRE specific code
Note
For FIRE Echelle, we usually use high gain and SUTR read mode. The exposure time is usually around 900s. The detector parameters below are based on such mode. Standard star and calibrations are usually use Fowler 1 read mode in which case the read noise is ~20 electron.
- camera = 'FIRE'
Name of the spectrograph camera or arm. This is used by specdb, so use that naming convention
- header_name = 'FIRE'
Name of the spectrograph camera or arm from the Header. Usually the INSTRUME card.
- 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:
- telescope = Parameter Value Default Type Callable ---------------------------------------------------------------- name MAGELLAN KECK str False longitude -70.70166666666665 None int, float False latitude -29.003333333333334 None int, float False elevation 2281.9999999994607 None int, float False fratio None None int, float False diameter 6.5 None int, float False eff_aperture None None int, float False
Instance of
TelescopePar
providing telescope-specific metadata.
- url = 'http://web.mit.edu/~rsimcoe/www/FIRE/index.html'
Reference url