[14/29] Configure editable ZShooter detector alternatives and operating points

ZShooter_v2/README.md

@@ -0,0 +1,16 @@
+# ZShooter detector engineering configurations
+
+`SPEC` loads the baseline package in `ZShooter_DET.yaml`; `SPEC_ALTDETECT` adds the editable overrides in `ZShooter_ALTDETECT.yaml`. These names select engineering configurations, not permanent detector identities. The current baseline uses tapered qCCDs in B/G/R and 15 um LmAPDs in YJ/H/K; the current alternative uses untapered CCDs and 18 um H2RGs in YJ/H/K.
+Detector dimensions remain 2048 x 4096 in B/G/R and 2048 x 2048 in YJ/H/K. Optical prescription, focal-plane offsets and selected orders are shared. Use the configured effects and output headers as the source of detector properties when comparing a revised package.
+
+Select one mode when constructing `UserCommands`, then construct an `OpticalTrain`. Reconstruct the train when changing the detector package or its initialization parameters, including pitch and QE. Exposure parameters can be supplied independently per arm through `readout(dit_blue=..., ndit_blue=..., ...)`.
+
+The `!DET` operating points use input-referred electrons. LmAPDs have avalanche gain 10, usable well 15000 e, effective read noise 0.5 e RMS and photon-variance multiplier F=1.2. Their physical QE uses `H2RG_TER.dat`, the existing provisional NIR QE estimate; `APD_TER.dat` is the historical QE/F proxy and is no longer active. The adopted dark term remains independent of F. Changing F does not change the configured usable well or divide the already input-referred read noise again.
+
+Other usable wells default to 60000 e. Read noise is 0.1 e for qCCDs, 2.5 e for CCDs and 6 e for H2RGs per independent integration. Dark rates are 0.5976, 2, 0.36 and 23 e/hour/pixel for qCCD, CCD, LmAPD and H2RG respectively. These are engineering specifications. The settings in `ZShooter_DET.yaml` and `ZShooter_ALTDETECT.yaml` are individually editable per detector.
+
+DIT/NDIT are observing settings: no effect changes them automatically. `ExposureLimit` warns if the expected source+sky+thermal+dark charge per integration exceeds the usable well, after CCD charge summation and before random noise or software binning. It records `PEAKDIT` and `WELLDEP` without clipping. An integration means an independent exposure or completed ramp, not a nondestructive sample. The current CCD charge-packet limit is conservatively the same 60000 e as the native-pixel limit.
+
+Native headers record `DETMODE`, `DETTYPE`, `PIXEL_SIZE` (mm), `EXNOISE` (variance factor), `AVGAIN` and `WELLDEP`, alongside actual exposure and detector WCS. Image charge stays input-referred; avalanche gain is distinct from the electronic electron/ADU conversion.
+
+Analytical traces resolve their pixel pitch from the same detector commands. Seven along-slit samples and a sixth-degree transform fit keep the common physical footprint consistent across detector pitches. The current larger YJ/H/K area changes coverage and sampling without retuning optics or reinstating the omitted YJ order.

ZShooter_v2/ZShooter_ALTDETECT.yaml

@@ -0,0 +1,50 @@
+# Alternative detector engineering package; optical prescription is unchanged.
+object: detector
+alias: DET
+name: zshooter_alternative_detectors
+properties:
+  detector_mode: SPEC_ALTDETECT
+  detector_type_b: CCD
+  ron_b: 2.5
+  dark_b: 0.0005555555555555556  # 2 e/hour/pixel
+  qe_class_b: SpectralQuantumEfficiency
+  qe_kwargs_b:
+    filename: detector_specs/ccd_uv_enhanced_TER.dat
+  detector_type_g: CCD
+  ron_g: 2.5
+  dark_g: 0.0005555555555555556  # 2 e/hour/pixel
+  qe_class_g: SpectralQuantumEfficiency
+  qe_kwargs_g:
+    filename: detector_specs/ccd_ml_uv_enhanced_TER.dat
+  detector_type_r: CCD
+  ron_r: 2.5
+  dark_r: 0.0005555555555555556  # 2 e/hour/pixel
+  qe_class_r: SpectralQuantumEfficiency
+  qe_kwargs_r:
+    filename: detector_specs/ccd_ml2_uv_enhanced_hirho_TER.dat
+  detector_type_yj: H2RG
+  pixel_size_yj: 0.018
+  pixel_scale_yj: 0.1884654  # Same 10.4703 arcsec/mm camera plate scale
+  usable_well_yj: 60000
+  ron_yj: 6.0
+  dark_yj: 0.006388888888888889  # 23 e/hour/pixel
+  excess_noise_factor_yj: 1.0
+  avalanche_gain_yj: 1
+  detector_type_h: H2RG
+  pixel_size_h: 0.018
+  pixel_scale_h: 0.1884654  # Same 10.4703 arcsec/mm camera plate scale
+  usable_well_h: 60000
+  ron_h: 6.0
+  dark_h: 0.006388888888888889  # 23 e/hour/pixel
+  excess_noise_factor_h: 1.0
+  avalanche_gain_h: 1
+  detector_type_k: H2RG
+  pixel_size_k: 0.018
+  pixel_scale_k: 0.1884654  # Same 10.4703 arcsec/mm camera plate scale
+  usable_well_k: 60000
+  ron_k: 6.0
+  dark_k: 0.006388888888888889  # 23 e/hour/pixel
+  excess_noise_factor_k: 1.0
+  avalanche_gain_k: 1
+  x_size_k: 2048
+  y_size_k: 2048

ZShooter_v2/ZShooter_ALTDETECT4k.yaml

@@ -0,0 +1,50 @@
+# Alternative detector engineering package; optical prescription is unchanged.
+object: detector
+alias: DET
+name: zshooter_alternative_detectors_4k
+properties:
+  detector_mode: SPEC_ALTDETECT4K
+  detector_type_b: CCD
+  ron_b: 2.5
+  dark_b: 0.0005555555555555556  # 2 e/hour/pixel
+  qe_class_b: SpectralQuantumEfficiency
+  qe_kwargs_b:
+    filename: detector_specs/ccd_uv_enhanced_TER.dat
+  detector_type_g: CCD
+  ron_g: 2.5
+  dark_g: 0.0005555555555555556  # 2 e/hour/pixel
+  qe_class_g: SpectralQuantumEfficiency
+  qe_kwargs_g:
+    filename: detector_specs/ccd_ml_uv_enhanced_TER.dat
+  detector_type_r: CCD
+  ron_r: 2.5
+  dark_r: 0.0005555555555555556  # 2 e/hour/pixel
+  qe_class_r: SpectralQuantumEfficiency
+  qe_kwargs_r:
+    filename: detector_specs/ccd_ml2_uv_enhanced_hirho_TER.dat
+  detector_type_yj: H2RG
+  pixel_size_yj: 0.018
+  pixel_scale_yj: 0.1884654  # Same 10.4703 arcsec/mm camera plate scale
+  usable_well_yj: 60000
+  ron_yj: 6.0
+  dark_yj: 0.006388888888888889  # 23 e/hour/pixel
+  excess_noise_factor_yj: 1.0
+  avalanche_gain_yj: 1
+  detector_type_h: H2RG
+  pixel_size_h: 0.018
+  pixel_scale_h: 0.1884654  # Same 10.4703 arcsec/mm camera plate scale
+  usable_well_h: 60000
+  ron_h: 6.0
+  dark_h: 0.006388888888888889  # 23 e/hour/pixel
+  excess_noise_factor_h: 1.0
+  avalanche_gain_h: 1
+  detector_type_k: H4RG
+  pixel_size_k: 0.010
+  pixel_scale_k: 0.104703  # Same 10.4703 arcsec/mm camera plate scale
+  usable_well_k: 60000
+  ron_k: 6.0
+  dark_k: 0.006388888888888889  # 23 e/hour/pixel
+  excess_noise_factor_k: 1.0
+  avalanche_gain_k: 1
+  x_size_k: 4096
+  y_size_k: 4096