.. _calobs-block-pv-nisp-reciprocity: **CALBLOCK-PV-017:** NISP Reciprocity Failure ============================================= .. include:: definitions.rst Observation configuration file ------------------------------ | :download:`ocf_CALBLOCK-PV-017_PHOTO-H.csv ` | :download:`ocf_CALBLOCK-PV-017_PHOTO-J.csv ` | :download:`ocf_CALBLOCK-PV-017_PHOTO-Y.csv ` Scheduling ---------- Once, during PV phase In case of failure, repeat at next possible opportunity. Objective --------- Validate the reciprocity failure (flux-dependent nonlinearity, charge trapping) for each detector. Trapping and detrapping effects are poorly understood, impact photometric measurements, and exhibit strong spatial variations across detectors. This validation is a spot check to see whether anything has changed since the more extensive ground characterization, and to obtain similar measurements with real targets under in-flight conditions. Trapping/detrapping is likely wavelength independent. However, in-flight and with all instrumental effects "turned on", we must verify this assumption. Hence the procedure outlined below will be repeated for all three filters. Observations ------------ To test the functional behaviour of reciprocity failure or trap filling on photometry, the same sources are observed with and without additional background light. The expectation is that additional background signal passivates the traps more quickly, and hence more source photons are detectable. Execute 8 dithered photo-MACC at the Self-cal field, without LED light. Take 4 more dithered photo-MACC and with additional LED background flux. Repeat this 18x with increasing LED fluxes of 2, 4, 8, ... , 512 e-/s/pixel, providing additional background signal between 170-44000 e-/pixel in a 87s integration-time MACC(4,16,4) image. Ideally, higher resolution at lower LED fluxes is desirable, but the LEDs have not been characterized at extremely low fluxes. LEDs A to C cannot all be commanded to realise the lowest 2 e-/s/pixel and 4 e-/s/pixel flux settings. Typical total background levels (zodi, in-field and out-field straylight) in a photo-MACC exposure are on the order of about 160 e-/pixel in J-band (15-20% lower in Y and H). The procedure is executed 3 times, for Y-band and LED B, J-band and LED C, and H-band with LED D. The stars will fall into different pixels and detectors in the exposures without and with LED illumination. It is sufficient to infer the general behaviour, using a sufficiently large number of stars. .. code-block:: python :caption: Observing instructions for NISP reciprocity failure for filter in [Y,J,H]: if filter == "Y": LED = "B" if filter == "J": LED = "C" if filter == "H": LED = "D" for LED flux_i in [2, 4, 8, ... , 512] e-/s: if low LED fluxes not commandable: continue Repeat 8x: (persistence decay, measurement without LED) "1 NISP photo-MACC exposure" "Random dither offset in a 3' box" Repeat 4x: "Turn on LED with flux_i" "1 NISP photo-MACC exposure" "Turn off LED" "Random dither offset in a 3' box" .. csv-table:: **NISP LED flux lookup table.** Numbers in parentheses were not verified on ground, but are reasonably close to be extrapolated. Missing data values indicate negative PWM values when using linear extrapolation. :download:`CSV file ` :file: tables/NISP_LED_flux_LUT_reciprocity.dat Fulfilling ---------- :ref:`calobs-nisp-reciprocity` Targets and pointing constraints -------------------------------- :command:`Pointing`: Straylight suppression as per MOCDA-SYS-003. .. csv-table:: **Self-cal center.** :download:`CSV file ` :file: tables/targets-selfcal-center.dat Instrument configuration ------------------------ Instrument: NI-CU on, NI-GWA open, VS-CU off Methodology / Uplink procedure ------------------------------ :command:`Entity`: VIS & NISP :command:`Commanding Method`: NISP: Observation :command:`Dither Sequence`: Special; Random dither offsets in a 3' box, taking NISP images only. Inter-operability constraints ----------------------------- None In-orbit duration ----------------- :command:`In-orbit Duration`: 16.9 h Assuming 70 s for each dither offset, plus 20 s (estimate) for NI-CU turn-on/off. 9 sequences with and without LED, 4 dithers, 3 filters. ``((111+70)s*12 + 4*20s) * 9 * 3 = 16.0 h`` Data volume ----------- ``324*NP = 19116 MB`` Processing input ---------------- :command:`Ground Processing Input Data`: All calibration products to run the standard science pipeline (BPM, darks, flat, nonlinearity etc), reference measurement of standard star, RSR curves (relative spectral response of the system (mirrors, optics, instrument) :command:`Data Description`: 324 photo-MACC images Processing output ----------------- Measure the flux of unsaturated stars without and with additional background light. Determine the percentage or decade of flux reciprocity failure, if present. Comparison with a model prediction from ground characterization data if available. Required accuracy, constraints ------------------------------ TBD Processing tools ---------------- L1 science pipeline and absolute calibration pipeline, additional offline trend analysis of flux measurements Quality control parameters -------------------------- DataModel: ``_ Contact person -------------- NISP-P calibration scientist .. raw:: latex \clearpage