= VIRUS Alignment Characterization Procedures = == Goal == The goal is to take 5 unbinned Hg lamp exposures, 5 dark frames (with same PFIP exposure time), 5 unbinned Cd-A lamp exposures, 5 dark frames (with same PFIP exposure time), and 5 bias frames to test the alignment of newly installed VIRUS units once these units have been stable and cold for (at least) 16 hours. The Hg and Cd-A lamp exposures need 45-55k in the peak line on the target IFUs. The dark frames should be the same exposure times as the lamp PFIP shutter exposure times (not the FCU exposure time). Note we are trying to use the same numbering for engineering tests so for the test exposures please use the 6000s and the final VAC exposures please use 7100-7199. The VG and IP must be OFF while taking the data for this test. Note exposure times for Hg and Cd-A need to be checked every time for new IFUs. Listed below are the exposure times from previous dates/units. == Reporting == When you have completed a successful set of VAC, email astronomer@, Phillip, and Renny. * The email subject line should include 'VAC' and the V-number in the format 'Vnnn' * The email body should include: * the yyyymmdd of the data directory * the observation numbers for each of the bias, Hg, and Cd data. These should be: * 7101 for Hg * 7102 for Cd * 7103 for Bias == Results == ||= Date =||=IFU(s) =||=Hg exp time [s]=||=Cd-A exp time [s]=|| || 20190504 || S081/V327, S105/V051 || 8.8 || 60 || || 20190524 || S072/V405 || 4 || 35 || || 20190528 || S072/V405 || 4 || 30 || || 20190529 || S097/V405, S072/V017 || 5.4 || || || 20190529 || S072/V017 || || 45 || || 20190529 || S097/V405 || || 33 || || 20190712 || ??? || 2.4 || 30 || || 20190719 || S041/V407,S077/V402 || 2.5 || 20 || || 20190819 || S031/V408 || 8.0 || 45 || || 20190915 || V409,V410,V330 || 8.0 || 60 || || 20191009 || V411 || 10.0 || 62 || || 20191011 || V330 || 8.5 || 50 || || 20191017 || V410, V412 || 9.0 || 53 || || 20191022 || V413, V414, V330 || 9 (V413), 6 || 65 (V413), 48 || || 20191031 || V410 || 9 || 81 || || 20191105 || V317 || 10.3 || 80 || == New script (testing mode for now) == #newscript Run {{{~sir/dev/astro/operations/virus_tests.sh [-skipip]}}} "skipip" only if you do not need that script deal with IP and VG. [[br]] Script first warm up lamps and entering test mode to determine correct exposure time. It will ask for max flux level after each test exposure and will display corrected exposure time. Type "next" when happy with exp time and script will ask run exposure or not. In case of "n" answer it just display correct command to run Here is an example VAC run {{{ [astronomer@mcs tmp]$ ~sir/dev/astro/operations/virus_tests.sh vac 2019-11-09T04:59:00 Warming up Cd and Hg 2019-11-09T04:59:08 Acquiring VIRUS unbinned biases 2019-11-09T04:59:10.252 INFO [vlcal : : 563] - Attaching to VIRUS 2019-11-09T04:59:10.773 INFO [vlcal : : 596] - Attaching to PFIP 2019-11-09T04:59:11.302 INFO [vlcal :setup_fcu_light_path: 157] - Retracting ACAM pickoff mirror 2019-11-09T04:59:11.545 INFO [vlcal :setup_fcu_light_path: 160] - Retracting CWFS/PV pickoff mirror 2019-11-09T04:59:11.548 INFO [vlcal :setup_fcu_light_path: 163] - Deploying the FCU Head 2019-11-09T04:59:21.034 INFO [vlcal : : 613] - Starting VIRUS calibration run 2019-11-09T04:59:21.036 INFO [vlcal :biases_darks : 271] - Initiating VIRUS bias 6110:1 with exp time: 0s 2019-11-09T04:59:32.275 INFO [vlcal :biases_darks : 280] - Completed unbinned_bias exposure 6110:1 2019-11-09T05:00:10.414 INFO [vlcal :biases_darks : 271] - Initiating VIRUS bias 6110:2 with exp time: 0s 2019-11-09T05:00:50.518 INFO [vlcal :biases_darks : 280] - Completed unbinned_bias exposure 6110:2 2019-11-09T05:01:28.660 INFO [vlcal : : 765] - Calibration run complete 2019-11-09T05:01:32 Warming up Cd for extra 156 sec 00:00:00 Cd exp time ('next' to exit test mode, 'quit' to exit the script): 20 2019-11-09T05:04:19 Running test cal: 1 Cd with 20 s 2019-11-09T05:04:22.536 INFO [vlcal : : 563] - Attaching to VIRUS 2019-11-09T05:04:23.055 INFO [vlcal : : 596] - Attaching to PFIP 2019-11-09T05:04:23.589 INFO [vlcal :setup_fcu_light_path: 157] - Retracting ACAM pickoff mirror 2019-11-09T05:04:23.839 INFO [vlcal :setup_fcu_light_path: 160] - Retracting CWFS/PV pickoff mirror 2019-11-09T05:04:23.843 INFO [vlcal :setup_fcu_light_path: 163] - Deploying the FCU Head 2019-11-09T05:04:23.846 INFO [vlcal : : 613] - Starting VIRUS calibration run 2019-11-09T05:04:23.848 INFO [vlcal : : 658] - Enabling controlling the pfip shutter from VIRUS 2019-11-09T05:04:23.851 INFO [vlcal :expose : 204] - Exposing Cd-A (Cd-A) lamp on slider a with blue light guide 2019-11-09T05:04:23.852 INFO [vlcal :expose : 210] - positioning slider A HW 2019-11-09T05:04:26.365 INFO [vlcal :expose : 224] - Initiating VIRUS observation 6510:1 with exp time: 20.0s 2019-11-09T05:04:26.367 INFO [vlcal :expose : 225] - expose() command sent 2019-11-09T05:04:46.518 INFO [vlcal :expose : 236] - expose() command returned 2019-11-09T05:04:46.520 INFO [vlcal :expose : 237] - FCUExpose() command sent 2019-11-09T05:04:50.590 INFO [vlcal :expose : 251] - FCUExpose() command returned 2019-11-09T05:05:44.150 INFO [vlcal :expose : 257] - Completed 6510:1 2019-11-09T05:05:44.153 INFO [vlcal : : 765] - Calibration run complete Max flux from histogram [6510:1] ('next' to exit test mode, 'quit' to exit the script) : 52400 2019-11-09T05:06:32 exp time is 19.1 Cd exp time ('next' to exit test mode, 'quit' to exit the script): next Run exposure? [Y/N]:y 2019-11-09T05:06:44 Getting 5 Cd with 19.1 s 2019-11-09T05:06:46.544 INFO [vlcal : : 563] - Attaching to VIRUS 2019-11-09T05:06:47.074 INFO [vlcal : : 596] - Attaching to PFIP 2019-11-09T05:06:47.602 INFO [vlcal :setup_fcu_light_path: 157] - Retracting ACAM pickoff mirror 2019-11-09T05:06:47.859 INFO [vlcal :setup_fcu_light_path: 160] - Retracting CWFS/PV pickoff mirror 2019-11-09T05:06:47.863 INFO [vlcal :setup_fcu_light_path: 163] - Deploying the FCU Head 2019-11-09T05:06:47.868 INFO [vlcal : : 613] - Starting VIRUS calibration run 2019-11-09T05:06:47.870 INFO [vlcal : : 658] - Enabling controlling the pfip shutter from VIRUS 2019-11-09T05:06:47.873 INFO [vlcal :expose : 204] - Exposing Cd-A (Cd-A) lamp on slider a with blue light guide 2019-11-09T05:06:47.875 INFO [vlcal :expose : 210] - positioning slider A HW 2019-11-09T05:06:51.438 INFO [vlcal :expose : 224] - Initiating VIRUS observation 6111:1 with exp time: 19.1s 2019-11-09T05:06:51.440 INFO [vlcal :expose : 225] - expose() command sent 2019-11-09T05:07:12.916 INFO [vlcal :expose : 236] - expose() command returned 2019-11-09T05:07:12.918 INFO [vlcal :expose : 237] - FCUExpose() command sent 2019-11-09T05:07:14.760 INFO [vlcal :expose : 251] - FCUExpose() command returned 2019-11-09T05:08:10.323 INFO [vlcal :expose : 257] - Completed 6111:1 2019-11-09T05:08:10.327 INFO [vlcal :expose : 224] - Initiating VIRUS observation 6111:2 with exp time: 19.1s 2019-11-09T05:08:10.328 INFO [vlcal :expose : 225] - expose() command sent 2019-11-09T05:08:46.487 INFO [vlcal :expose : 236] - expose() command returned 2019-11-09T05:08:46.489 INFO [vlcal :expose : 237] - FCUExpose() command sent 2019-11-09T05:08:48.586 INFO [vlcal :expose : 251] - FCUExpose() command returned 2019-11-09T05:09:42.943 INFO [vlcal :expose : 257] - Completed 6111:2 2019-11-09T05:09:42.959 INFO [vlcal : : 765] - Calibration run complete 2019-11-09T05:09:47 Warming up Hg for extra 141 sec 00:00:00 Hg exp time ('next' to exit test mode, 'quit' to exit the script): 1 2019-11-09T05:16:36 Running test cal: 1 Hg with 1 s 2019-11-09T05:16:39.190 INFO [vlcal : : 563] - Attaching to VIRUS 2019-11-09T05:16:39.712 INFO [vlcal : : 596] - Attaching to PFIP 2019-11-09T05:16:40.241 INFO [vlcal :setup_fcu_light_path: 157] - Retracting ACAM pickoff mirror 2019-11-09T05:16:40.476 INFO [vlcal :setup_fcu_light_path: 160] - Retracting CWFS/PV pickoff mirror 2019-11-09T05:16:40.480 INFO [vlcal :setup_fcu_light_path: 163] - Deploying the FCU Head 2019-11-09T05:16:40.484 INFO [vlcal : : 613] - Starting VIRUS calibration run 2019-11-09T05:16:40.486 INFO [vlcal : : 658] - Enabling controlling the pfip shutter from VIRUS 2019-11-09T05:16:40.488 INFO [vlcal :expose : 204] - Exposing Hg (Hg) lamp on slider a with blue light guide 2019-11-09T05:16:40.490 INFO [vlcal :expose : 210] - positioning slider A HW 2019-11-09T05:16:44.126 INFO [vlcal :expose : 224] - Initiating VIRUS observation 6513:1 with exp time: 1.0s 2019-11-09T05:16:44.128 INFO [vlcal :expose : 225] - expose() command sent 2019-11-09T05:17:05.459 INFO [vlcal :expose : 236] - expose() command returned 2019-11-09T05:17:05.461 INFO [vlcal :expose : 237] - FCUExpose() command sent 2019-11-09T05:17:08.597 INFO [vlcal :expose : 251] - FCUExpose() command returned 2019-11-09T05:17:47.825 INFO [vlcal :expose : 257] - Completed 6513:1 2019-11-09T05:17:47.830 INFO [vlcal : : 765] - Calibration run complete Max flux from histogram [6513:1] ('next' to exit test mode, 'quit' to exit the script) : 22400 2019-11-09T05:19:07 exp time is 2.2 Hg exp time ('next' to exit test mode, 'quit' to exit the script): next Run exposure? [Y/N]:y 2019-11-09T05:19:17 Getting 5 Hg with 2.2 s 2019-11-09T05:19:19.926 INFO [vlcal : : 563] - Attaching to VIRUS 2019-11-09T05:19:20.450 INFO [vlcal : : 596] - Attaching to PFIP 2019-11-09T05:19:20.981 INFO [vlcal :setup_fcu_light_path: 157] - Retracting ACAM pickoff mirror 2019-11-09T05:19:21.246 INFO [vlcal :setup_fcu_light_path: 160] - Retracting CWFS/PV pickoff mirror 2019-11-09T05:19:21.250 INFO [vlcal :setup_fcu_light_path: 163] - Deploying the FCU Head 2019-11-09T05:19:21.253 INFO [vlcal : : 613] - Starting VIRUS calibration run 2019-11-09T05:19:21.255 INFO [vlcal : : 658] - Enabling controlling the pfip shutter from VIRUS 2019-11-09T05:19:21.258 INFO [vlcal :expose : 204] - Exposing Hg (Hg) lamp on slider a with blue light guide 2019-11-09T05:19:21.259 INFO [vlcal :expose : 210] - positioning slider A HW 2019-11-09T05:19:22.347 INFO [vlcal :expose : 224] - Initiating VIRUS observation 6112:1 with exp time: 2.2s 2019-11-09T05:19:22.348 INFO [vlcal :expose : 225] - expose() command sent 2019-11-09T05:19:42.779 INFO [vlcal :expose : 236] - expose() command returned 2019-11-09T05:19:42.781 INFO [vlcal :expose : 237] - FCUExpose() command sent 2019-11-09T05:19:43.400 INFO [vlcal :expose : 251] - FCUExpose() command returned 2019-11-09T05:20:25.031 INFO [vlcal :expose : 257] - Completed 6112:1 2019-11-09T05:20:25.035 INFO [vlcal :expose : 224] - Initiating VIRUS observation 6112:2 with exp time: 2.2s 2019-11-09T05:20:25.037 INFO [vlcal :expose : 225] - expose() command sent 2019-11-09T05:21:01.330 INFO [vlcal :expose : 236] - expose() command returned 2019-11-09T05:21:01.331 INFO [vlcal :expose : 237] - FCUExpose() command sent 2019-11-09T05:21:02.195 INFO [vlcal :expose : 251] - FCUExpose() command returned 2019-11-09T05:21:43.841 INFO [vlcal :expose : 257] - Completed 6112:2 2019-11-09T05:21:43.844 INFO [vlcal : : 765] - Calibration run complete }}} == Scripted commands == Note about testing exposure times: * In testing that the brightest arc line is in the range 45-55K, just replace "-L 5" with "-L 1" in the script commands below so that you take a single image at a time. Note on naming scheme: * for binning 1x1 name will be "unbinned_" * for all other non standard binning scheme are : "_" Commands (it's recommended to run each command with "--dry-run" first for checking): First step is to determine appropriate exp time for Hg and Cd-A to get 45-55k in the peak line on the target IFUs. Do this using observation numbers 6XXX and start with exposure times about half of those given above in case you saturate. Try the following for faster work: Turn on the Cd-A and Hg lamps through the TCS gui {{{ ipvg off -V }}}[[BR]] {{{ countdowns 780 }}} Cd-A test exp {{{ vlcal -i virus --binning 1x1 -l cd-a -L 1 -bexp 55 -o 6101 -skip_warmup -B }}}[[BR]] Re-Turn on the Cd-A lamp and calculate the correct exposure time for the VIRUS unit of interest to get 50k peak.[[BR]] Hg {{{ vlcal -i virus --binning 1x1 -l hg -L 1 -bexp 7 -o 6102 -skip_warmup -B}}}[[BR]] Re-Turn on the Hg lamp and calculate the correct exposure time for the VIRUS unit of interest to get 50k peak.[[BR]] Now run the following but remembering to change the exposure times!!! - {{{ vlcal -i virus --binning 1x1 -b 5 -o 7100 -skip_warmup -B}}} - {{{ vlcal -i virus --binning 1x1 -l cd-a -L 5 -bexp 20 -o 7101 -skip_warmup -B }}} - {{{ vlcal -i virus --binning 1x1 -l hg -L 5 -bexp 9 -o 7102 -skip_warmup -B }}} - {{{ ipvg on -V }}} Two scenarios: (assuming these are done in the day time) - data taken with dark dome - {{{ ipvg off -V }}} - biases {{{ vlcal -i virus --binning 1x1 -b 5 -o 7100 }}} - Hg {{{ vlcal -i virus --binning 1x1 -l hg -L 5 -bexp 2.5 -o 7101 }}} - Cd-A {{{ vlcal -i virus --binning 1x1 -l cd-a -L 5 -bexp 20 -o 7102 }}} - {{{ ipvg on -V }}} - data taken with dome lights on - {{{ ipvg off -V }}} - biases {{{ vlcal -i virus --binning 1x1 -b 5 -o 7100 }}} - Hg {{{ vlcal -i virus --binning 1x1 -l hg -L 1 -bexp 2.5 -o 7101 }}} - Cd-A {{{ vlcal -i virus --binning 1x1 -l cd-a -L 5 -bexp 30 -o 7102 }}} - darks {{{ vlcal -i virus --binning 1x1 -d 5 -de 20 -o 7103 }}} - darks {{{ vlcal -i virus --binning 1x1 -d 5 -de 45 -o 7104 }}} - {{{ ipvg on -V }}} == To judge the image flux levels == Use the virusview command to view the images from all 4 amps of a given S###. Measure the peak flux in each amp using the ds9 Scale histogram (Scale Parameters). Use the most sensitive amp to judge the max peak level. Use this level to estimate the exposure time needed to achieve a peak of 50K or so. == Low level commands == To take the bias frames one could do the following: {{{ syscmd -V 'expose(seconds=0, x_binning=1, y_binning=1, type="zro", object="unbinned_bias", observation=7100, exposure=1 )' syscmd -V 'wait_for_write(observation=7100,exposure=1)' syscmd -V 'expose(seconds=0, x_binning=1, y_binning=1, type="zro", object="unbinned_bias", observation=7100, exposure=2 )' syscmd -V 'wait_for_write(observation=7100,exposure=2)' syscmd -V 'expose(seconds=0, x_binning=1, y_binning=1, type="zro", object="unbinned_bias", observation=7100, exposure=3 )' syscmd -V 'wait_for_write(observation=7100,exposure=3)' syscmd -V 'expose(seconds=0, x_binning=1, y_binning=1, type="zro", object="unbinned_bias", observation=7100, exposure=4 )' syscmd -V 'wait_for_write(observation=7100,exposure=4)' syscmd -V 'expose(seconds=0, x_binning=1, y_binning=1, type="zro", object="unbinned_bias", observation=7100, exposure=5 )' syscmd -V 'wait_for_write(observation=7100,exposure=5)' }}} Now take the lamp exposures ('''Note that the exposure time of 8.8 seconds has previously worked well for the brightest emission line for the S105 unit but might not be good for future units''' Try taking a test exposure with **observation=6xxx.** **Also note that the flux level of the Hg lamp does not fully stabilize until 13 minutes after it has been turned on.** {{{ ipvg off -V syscmd -P 'FCUDeployHead()' syscmd -P 'FCUEnableLamps(lamps="Hg",slider="a",state="on")' sleep 180 syscmd -P 'FCUExposeSliderA(time=0.1,lamp_name="Hg",headpos="overide",light_guide="blue",shutter="virus")' syscmd -V 'expose(seconds=20, x_binning=1, y_binning=1, type="cmp", object="unbinned_Hg", observation=7101, exposure=1 )' syscmd -P 'FCUExposeSliderA(time=8.0,lamp_name="Hg",headpos="overide",light_guide="blue",shutter="virus")' syscmd -V 'wait_for_write(observation=7101,exposure=1)' syscmd -V 'expose(seconds=20, x_binning=1, y_binning=1, type="cmp", object="unbinned_Hg", observation=7101, exposure=2 )' syscmd -P 'FCUExposeSliderA(time=8.0,lamp_name="Hg",headpos="overide",light_guide="blue",shutter="virus")' syscmd -V 'wait_for_write(observation=7101,exposure=2)' syscmd -V 'expose(seconds=20, x_binning=1, y_binning=1, type="cmp", object="unbinned_Hg", observation=7101, exposure=3 )' syscmd -P 'FCUExposeSliderA(time=8.0,lamp_name="Hg",headpos="overide",light_guide="blue",shutter="virus")' syscmd -V 'wait_for_write(observation=7101,exposure=3)' syscmd -V 'expose(seconds=20, x_binning=1, y_binning=1, type="cmp", object="unbinned_Hg", observation=7101, exposure=4 )' syscmd -P 'FCUExposeSliderA(time=8.0,lamp_name="Hg",headpos="overide",light_guide="blue",shutter="virus")' syscmd -V 'wait_for_write(observation=7101,exposure=4)' syscmd -V 'expose(seconds=20, x_binning=1, y_binning=1, type="cmp", object="unbinned_Hg", observation=7101, exposure=5 )' syscmd -P 'FCUExposeSliderA(time=8.0,lamp_name="Hg",headpos="overide",light_guide="blue",shutter="virus")' syscmd -V 'wait_for_write(observation=7101,exposure=5)' syscmd -P 'FCUEnableLamps(lamps="Hg",slider="a",state="off")' syscmd -P 'FCURetractHead()' }}} To take the dark frames: (at the PFIP exposure time) {{{ syscmd -V 'expose(seconds=20, x_binning=1, y_binning=1, type="drk", object="unbinned_dark", observation=7102, exposure=1, dark="true" )' syscmd -V 'wait_for_write(observation=7102,exposure=1)' syscmd -V 'expose(seconds=20, x_binning=1, y_binning=1, type="drk", object="unbinned_dark", observation=7102, exposure=2, dark="true" )' syscmd -V 'wait_for_write(observation=7102,exposure=2)' syscmd -V 'expose(seconds=20, x_binning=1, y_binning=1, type="drk", object="unbinned_dark", observation=7102, exposure=3, dark="true" )' syscmd -V 'wait_for_write(observation=7102,exposure=3)' syscmd -V 'expose(seconds=20, x_binning=1, y_binning=1, type="drk", object="unbinned_dark", observation=7102, exposure=4, dark="true" )' syscmd -V 'wait_for_write(observation=7102,exposure=4)' syscmd -V 'expose(seconds=20, x_binning=1, y_binning=1, type="drk", object="unbinned_dark", observation=7102, exposure=5, dark="true" )' syscmd -V 'wait_for_write(observation=7102,exposure=5)' }}} Then do the same for the Cd-A lamps