wiki:HetProcedures/VAC

Version 95 (modified by sir, 4 years ago) (diff)

--

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)

Run ~sir/dev/astro/operations/virus_tests.sh <vac|dsf> [-skipip]

"skipip" only if you do not need that script deal with IP and VG.
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               :<module>            : 563] - Attaching to VIRUS
2019-11-09T04:59:10.773 INFO  [vlcal               :<module>            : 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               :<module>            : 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               :<module>            : 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               :<module>            : 563] - Attaching to VIRUS
2019-11-09T05:04:23.055 INFO  [vlcal               :<module>            : 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               :<module>            : 613] - Starting VIRUS calibration run
2019-11-09T05:04:23.848 INFO  [vlcal               :<module>            : 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               :<module>            : 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               :<module>            : 563] - Attaching to VIRUS
2019-11-09T05:06:47.074 INFO  [vlcal               :<module>            : 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               :<module>            : 613] - Starting VIRUS calibration run
2019-11-09T05:06:47.870 INFO  [vlcal               :<module>            : 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               :<module>            : 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               :<module>            : 563] - Attaching to VIRUS
2019-11-09T05:16:39.712 INFO  [vlcal               :<module>            : 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               :<module>            : 613] - Starting VIRUS calibration run
2019-11-09T05:16:40.486 INFO  [vlcal               :<module>            : 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               :<module>            : 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               :<module>            : 563] - Attaching to VIRUS
2019-11-09T05:19:20.450 INFO  [vlcal               :<module>            : 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               :<module>            : 613] - Starting VIRUS calibration run
2019-11-09T05:19:21.255 INFO  [vlcal               :<module>            : 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               :<module>            : 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_<lamp name>"
  • for all other non standard binning scheme are : "<lamp name>_<binning>"

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
countdowns 780

Cd-A test exp vlcal -i virus --binning 1x1 -l cd-a -L 1 -bexp 55 -o 6101 -skip_warmup -B
Re-Turn on the Cd-A lamp and calculate the correct exposure time for the VIRUS unit of interest to get 50k peak.
Hg vlcal -i virus --binning 1x1 -l hg -L 1 -bexp 7 -o 6102 -skip_warmup -B
Re-Turn on the Hg lamp and calculate the correct exposure time for the VIRUS unit of interest to get 50k peak.
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

Attachments (1)

Download all attachments as: .zip