Calibration of area detectors (common_mode options)

LCLS supports a variety of area detectors, from simple monolithic CCDs to tiled gain-switching detectors that have option noise removal algorithms assigned to them.

smalldata_tools DetObject attempts to do the best for each detector type, but it is important to note that 'best' can depend on your physics through occupancy related effects.

We are using single numbers indicating what corrections should be applied, so the default behavior can be changed.

common_mode	Brief Description	Detector	Comment
-2
-1	raw	Pulnix Opal Zyla, iStar ControlsCamera Alvium AndOR Fli icarus Cspad, cs140
0	pedestal subtracted	Pulnix Opal Zyla, iStar ControlsCamera Alvium AndOR Fli icarus Cspad, cs140
5	unbonded pixels	CsPad, Cs140k
1	asic-wise zero photon peak finding (gated mean method)	CsPad, Cs140k
10	use 1 if possible, otherwise 5	CsPad, Cs140k
71	standard gain/offset corrections, common mode	Jungfrau
80	standard gain/offset corrections, but no common mode	Epix10k2M Epix10k Quad
81	correction applied on det.raw was trying to replicate det.calib during early data taking	Epix10k2M Epix10k Quad	deprecated
84	standard gain/offset corrections, common mode in rows	Epix10k2M Epix10k Quad
85	standard gain/offset corrections, common mode in rows	Epix10k2M Epix10k Quad
180	ghost corrected 80 (use only for Dec 2018 exp)	Epix10k2M	deprecated
181	ghost corrected 81 (use only for Dec 2018 exp)	Epix10k2M	deprecated
5	gated mean, rows&columns	epix100
6	median after 'photon' removal	epix100
45	median after 'photon' removal, smalldata_tools code	epix100
46	median after 'photon' removal, smalldata_tools code	epix100
98	calculate common mode using unbonded rows	icarus
99	calculate&apply common mode using unbonded rows	icarus
30	det.calib()	ALL	can change w/ release w/o notice depending on what is considered best.