Detector Specifications

Basically anytime a raw image is loaded by PypeIt, it also instantiates a DetectorContainer object to hold salient detector parameters. Many of these parameters are hard-coded for each supported instrument, but they can also be read from the frame in question. The detector parameters used during the data reduction are provided in most of the primary PypeIt output files, including both the Spec2D Output and the Calibrations.

The datamodel for the DetectorContainer object is:

Version: 1.0.1

Attribute	Type	Array Type	Description
binning	str		Binning in PypeIt orientation (not the original)
darkcurr	int, float		Dark current (e-/pixel/hour)
dataext	int		Index of fits extension containing data
datasec	numpy.ndarray	str	Either the data sections or the header keyword where the valid data sections can be obtained, one per amplifier. If defined explicitly should be in FITS format (e.g., [1:2048,10:4096]).
det	int, numpy.integer		PypeIt designation for detector number (1-based).
gain	numpy.ndarray	numpy.floating	Inverse gain (e-/ADU). A list should be provided if a detector contains more than one amplifier.
mincounts	int, float		Counts (e-) in a pixel below this value will be ignored as being unphysical.
nonlinear	int, float		Percentage of detector range which is linear (i.e. everything above nonlinear*saturation will be flagged as saturated)
numamplifiers	int		Number of amplifiers
oscansec	numpy.ndarray	str	Either the overscan section or the header keyword where the valid data sections can be obtained, one per amplifier. If defined explicitly should be in FITS format (e.g., [1:2048,10:4096]).
platescale	int, float		arcsec per pixel in the spatial dimension for an unbinned pixel
ronoise	numpy.ndarray	numpy.floating	Read-out noise (e-). A list should be provided if a detector contains more than one amplifier. If any element of this list is <=0, the readout noise will be determined from the overscan regions defined by oscansec.
saturation	int, float		The detector saturation level in ADU/DN
spatflip	bool		If this is True then the spatial dimension will be flipped. PypeIt expects echelle orders to increase with increasing pixel number. I.e., setting spatflip=True can reorder images so that blue orders appear on the left and red orders on the right.
specaxis	int		Spectra are dispersed along this axis. Allowed values are 0 (first dimension for a numpy array shape) or 1 (second dimension for numpy array shape).
specflip	bool		If this is True then the dispersion dimension (specified by the specaxis) will be flipped. PypeIt expects wavelengths to increase with increasing pixel number. If this is not the case for this instrument, set specflip to True.
xgap	int, float		Gap between the square detector pixels (expressed as a fraction of the x pixel size – x is predominantly the spatial axis)
ygap	int, float		Gap between the square detector pixels (expressed as a fraction of the y pixel size – y is predominantly the spectral axis)
ysize	int, float		The size of a pixel in the y-direction as a multiple of the x pixel size (i.e. xsize = 1.0 – x is predominantly the dispersion axis)

Instrument-Specific Data

The table below provides a subset of the current detector parameters (see the datamodel table above). If the value is always read from the frame being processed, the table entry is set to None. Currently, these parameters cannot be changed programmatically (e.g., via the PypeIt Reduction File). If you see errors, please provide corrections via a PR or Submit an issue.

Instrument	Det	specaxis	specflip	spatflip	namp	gain	RN	darkcurr	min	sat	nonlinear	platescale
bok_bc	1	1	False	False	1	1.5	3.0	5.4	-1.0e+10	65535.0	1.0000	0.2000
gemini_flamingos1	1	0	False	False	1	3.8	6.0	1080.0	-1.0e+10	320000.0	0.8750	0.1500
gemini_flamingos2	1	0	True	False	1	4.44	5.0	1800.0	-1.0e+10	700000.0	1.0000	0.1787
gemini_gmos_north_e2v	1	1	False	False	2	2.27, 2.27	3.32, 3.32	0.0	-1.0e+10	110900.0	0.9500	0.0728
…	2	1	False	False	2	2.27, 2.27	3.32, 3.32	0.0	-1.0e+10	115500.0	0.9500	0.0728
…	3	1	False	False	2	2.27, 2.27	3.32, 3.32	0.0	-1.0e+10	116700.0	0.9500	0.0728
gemini_gmos_north_ham	1	1	False	False	4	1.63, 1.63, 1.63, 1.63	4.14, 4.14, 4.14, 4.14	0.0	-1.0e+10	129000.0	0.9500	0.0807
…	2	1	False	False	4	1.63, 1.63, 1.63, 1.63	4.14, 4.14, 4.14, 4.14	0.0	-1.0e+10	123000.0	0.9500	0.0807
…	3	1	False	False	4	1.63, 1.63, 1.63, 1.63	4.14, 4.14, 4.14, 4.14	0.0	-1.0e+10	125000.0	0.9500	0.0807
gemini_gmos_north_ham_ns	1	1	False	False	4	1.63, 1.63, 1.63, 1.63	4.14, 4.14, 4.14, 4.14	0.0	-1.0e+10	129000.0	0.9500	0.0807
…	2	1	False	False	4	1.63, 1.63, 1.63, 1.63	4.14, 4.14, 4.14, 4.14	0.0	-1.0e+10	123000.0	0.9500	0.0807
…	3	1	False	False	4	1.63, 1.63, 1.63, 1.63	4.14, 4.14, 4.14, 4.14	0.0	-1.0e+10	125000.0	0.9500	0.0807
gemini_gmos_south_ham	1	1	False	False	4	1.83, 1.83, 1.83, 1.83	3.98, 3.98, 3.98, 3.98	0.0	-1.0e+10	129000.0	0.9500	0.0800
…	2	1	False	False	4	1.83, 1.83, 1.83, 1.83	3.98, 3.98, 3.98, 3.98	0.0	-1.0e+10	123000.0	0.9500	0.0800
…	3	1	False	False	4	1.83, 1.83, 1.83, 1.83	3.98, 3.98, 3.98, 3.98	0.0	-1.0e+10	125000.0	0.9500	0.0800
gemini_gnirs_echelle	1	0	True	True	1	13.5	7.0	540.0	-1.0e+10	150000.0	0.7100	0.1500
gemini_gnirs_ifu	1	0	True	True	1	13.5	7.0	540.0	-1.0e+10	150000.0	0.7100	0.1500
gtc_maat	1	1	True	False	1	1.9	4.3	5.0	0.0e+00	65535.0	0.9500	0.1250
gtc_osiris	1	0	False	False	1	0.95	4.5	0.0	0.0e+00	65535.0	0.9500	0.1270
…	2	0	False	False	1	0.95	4.5	0.0	0.0e+00	65535.0	0.9500	0.1270
gtc_osiris_plus	1	1	True	False	1	1.9	4.3	5.0	0.0e+00	65535.0	0.9500	0.1250
jwst_nircam	1	1	False	False	1	1.84	8.55	120.6	-1.0e+10	59200.0	0.9500	0.0630
…	2	1	False	False	1	1.8	8.57	126.0	-1.0e+10	58500.0	0.9500	0.0630
jwst_nirspec	1	1	False	False	1	0.996	5.17	33.12	-1.0e+10	55100.0	0.9500	0.1000
…	2	1	False	False	1	1.137	6.6	20.52	-1.0e+10	60400.0	0.9500	0.1000
keck_deimos	1	0	False	False	1	1.226	2.57	3.3	-1.0e+10	65535.0	0.9500	0.1185
…	2	0	False	False	1	1.188	2.491	3.6	-1.0e+10	65535.0	0.9500	0.1185
…	3	0	False	False	1	1.248	2.618	3.5	-1.0e+10	65535.0	0.9500	0.1185
…	4	0	False	False	1	1.22	2.557	3.7	-1.0e+10	65535.0	0.9500	0.1185
…	5	0	False	False	1	1.184	2.482	2.7	-1.0e+10	65535.0	0.9500	0.1185
…	6	0	False	False	1	1.177	2.469	3.8	-1.0e+10	65535.0	0.9500	0.1185
…	7	0	False	False	1	1.201	2.518	3.3	-1.0e+10	65535.0	0.9500	0.1185
…	8	0	False	False	1	1.23	2.58	3.7	-1.0e+10	65535.0	0.9500	0.1185
keck_esi	1	0	False	False	2	1.3, 1.3	2.5, 2.5	2.1	-1.0e+10	65535.0	0.9900	0.1542
keck_hires	1	0	False	False	1	1.9	2.8	0.0	-1.0e+10	65535.0	0.7000	0.1350
…	2	0	False	False	1	2.1	3.1	0.0	-1.0e+10	65535.0	0.7000	0.1350
…	3	0	False	False	1	2.1	3.1	0.0	-1.0e+10	65535.0	0.7000	0.1350
keck_kcrm	1	0	None	True	None	None	None	0.0	-1.0e+10	65535.0	0.9500	0.1457
keck_kcwi	1	0	None	False	None	None	None	1.0	-1.0e+10	65535.0	0.9500	0.1457
keck_lris_blue	1	0	False	False	2	1.55, 1.56	3.9, 4.2	0.0	-1.0e+10	65535.0	0.8600	0.1350
…	2	0	False	False	2	1.63, 1.7	3.6, 3.6	0.0	-1.0e+10	65535.0	0.8600	0.1350
keck_lris_blue_orig	1	0	True	False	2	1.55, 1.56	3.9, 4.2	0.0	-1.0e+10	65535.0	0.8600	0.1350
…	2	0	True	False	2	1.63, 1.7	3.6, 3.6	0.0	-1.0e+10	65535.0	0.8600	0.1350
keck_lris_red	1	0	False	False	2	1.255, 1.18	4.64, 4.76	0.0	-1.0e+10	65535.0	0.7600	0.1350
…	2	0	False	False	2	1.191, 1.162	4.54, 4.62	0.0	-1.0e+10	65535.0	0.7600	0.1350
keck_lris_red_mark4	1	0	True	True	2	1.61, 1.60153	3.65, 3.52	0.0	-1.0e+10	65535.0	0.7600	0.1350
keck_lris_red_orig	1	1	False	False	2	1.98, 2.17	6.1, 6.3	0.0	-1.0e+10	65535.0	0.7600	0.2110
keck_mosfire	1	1	False	False	1	2.15	5.8	28.8	-1.0e+10	1000000000.0	1.0000	0.1798
keck_nires	1	1	True	False	1	3.8	5.0	468.0	-1.0e+10	1000000.0	0.7600	0.1500
keck_nirspec_low	1	0	False	False	1	5.8	23.0	2520.0	-1.0e+10	100000.0	1.0000	0.1930
lbt_luci1	1	1	False	False	1	2.0	4.61	0.0	-1.0e+10	100000000.0	0.8000	0.2500
lbt_luci2	1	1	False	False	1	2.0	4.47	0.0	-1.0e+10	100000000.0	0.8000	0.2500
lbt_mods1b	1	0	True	False	4	2.55, 1.91, 2.09, 2.02	3.41, 2.93, 2.92, 2.76	0.5	-1.0e+10	65535.0	0.9900	0.1200
lbt_mods1r	1	0	False	False	4	2.38, 2.5, 2.46, 2.81	3.78, 4.04, 4.74, 4.14	0.4	-1.0e+10	65535.0	0.9900	0.1230
lbt_mods2b	1	0	True	False	4	1.99, 2.06, 1.96, 2.01	3.66, 3.62, 3.72, 3.64	0.5	-1.0e+10	65535.0	0.9900	0.1200
lbt_mods2r	1	0	False	False	4	1.7, 1.67, 1.66, 1.66	2.95, 2.65, 2.78, 2.87	0.4	-1.0e+10	65535.0	0.9900	0.1230
ldt_deveny	1	1	True	False	1	1.52	4.9	4.5	-1.0e+10	65535.0	0.9700	0.3400
magellan_fire	1	1	True	False	1	1.2	5.0	3.06	-1.0e+10	100000.0	1.0000	0.1800
magellan_fire_long	1	0	False	False	1	3.8	6.0	3.06	-1.0e+10	320000.0	0.8750	0.1500
magellan_mage	1	1	True	False	1	1.02	2.9	1.0	-1.0e+10	65535.0	0.9900	0.3000
mdm_modspec	1	0	True	False	1	1.3	7.9	0.0	-1.0e+10	65535.0	0.9700	0.2800
mdm_osmos_mdm4k	1	1	True	False	4	2.2, 2.2, 2.2, 2.2	5.0, 5.0, 5.0, 5.0	0.0	-1.0e+10	65535.0	0.8600	0.2730
mdm_osmos_r4k	1	1	True	False	4	2.2, 2.2, 2.2, 2.2	3.0, 3.0, 3.0, 3.0	0.0	-1.0e+10	65535.0	0.8600	0.2730
mmt_binospec	1	0	False	False	4	1.085, 1.046, 1.042, 0.975	3.2, 3.2, 3.2, 3.2	3.6	-1.0e+10	65535.0	0.9500	0.2400
…	2	0	False	False	4	1.028, 1.115, 1.047, 1.045	3.6, 3.6, 3.6, 3.6	3.6	-1.0e+10	65535.0	0.9500	0.2400
mmt_bluechannel	1	0	False	False	1	None	None	0.0	-1.0e+10	65535.0	0.9500	0.3000
mmt_mmirs	1	0	False	False	1	0.95	3.14	36.0	-1.0e+10	700000.0	1.0000	0.2012
not_alfosc	1	0	True	False	1	None	None	1.3	-1.0e+10	700000.0	0.8600	0.2138
not_alfosc_vert	1	1	False	False	1	None	None	1.3	-1.0e+10	700000.0	0.8600	0.2138
ntt_efosc2	1	0	False	False	1	0.91	10.0	0.0	-1.0e+10	65535	0.8000	0.1200
p200_dbsp_blue	1	0	True	False	1	0.72	2.5	0.0	-1.0e+10	65000.0	0.9538	0.3890
p200_dbsp_red	1	1	False	False	1	2.8	8.5	0.0	-1.0e+10	45000.0	0.8889	0.2930
p200_tspec	1	1	True	False	1	3.8	3.5	306.0	-1.0e+10	28000	0.9000	0.3700
shane_kast_blue	1	1	False	False	2	1.2, 1.2	3.7, 3.7	0.0	-1.0e+10	65535.0	0.7600	0.4300
shane_kast_red	1	0	False	False	2	1.9, 1.9	3.8, 3.8	0.0	-1.0e+10	65535.0	0.7600	0.4300
shane_kast_red_ret	1	1	False	False	1	3.0	12.5	0.0	-1.0e+10	120000.0	0.7600	0.7740
soar_goodman_blue	1	1	False	False	1	None	None	0.0	-1.0e+10	65535.0	1.0000	0.1500
soar_goodman_red	1	1	False	False	1	None	None	0.0	-1.0e+10	65535.0	1.0000	0.1500
tng_dolores	1	1	False	False	1	0.97	9.0	0.0	-1.0e+10	65500.0	0.9900	0.2520
vlt_fors2	1	1	False	False	1	0.7	2.9	2.1	-1.0e+10	200000.0	0.8000	0.1260
…	2	1	False	False	1	0.7	3.15	1.4	-1.0e+10	200000.0	0.8000	0.1260
vlt_sinfoni	1	0	True	False	1	2.42	7.0	540.0	-1.0e+10	1000000000.0	1.0000	0.0125
vlt_xshooter_nir	1	1	False	False	1	2.12	8.0	0.0	-1.0e+10	200000.0	0.8600	0.1970
vlt_xshooter_uvb	1	0	True	True	1	1.61	2.6	0.0	-1.0e+10	65000.0	0.8600	0.1610
vlt_xshooter_vis	1	0	False	False	1	0.595	3.1	0.0	-1.0e+10	65535.0	0.8600	0.1600
wht_isis_blue	1	0	False	False	1	1.2	5.0	0.0	-1.0e+10	65535.0	0.7600	0.2000
wht_isis_red	1	0	False	False	1	0.98	4.0	0.0	-1.0e+10	65535.0	0.7600	0.2200