| 10 | | * The TO is generally responsible for the Guiders, Wavefront Sensors, |
| 11 | | * OTT and the TO setup scripts will control the GC/ACQ filters, WFS/GC/ACQ/HPFACQ exposure times, analysis regions, fiducials, |
| 12 | | * When TO clicks "setup complete", the telescope should be fully ready for the science observation to begin. |
| | 10 | * The TO is generally responsible for the Guiders, Wavefront Sensors, !Tip/Tilt Camera, ACQ camera, HPF ACQ camera, focus, etc. |
| | 11 | * OTT and the TO setup scripts will control the GC/ACQ filters, WFS/GC/ACQ/HPFACQ exposure times, analysis regions, fiducials, always storing images, etc |
| | 12 | * When TO clicks "setup complete", the telescope should be fully ready for the science observation to begin. This means the ACQ mirror should be retracted, pipeline stopped, and everything ready for the science exposure to start. The wavefront sensor may be activated shortly afterward to provide fine focus corrections, but the telescope should already be in rough focus (<0.1mm). |
| 17 | | === LRS2 (DirectACAM or ACAMblind) |
| 18 | | * OTT deploys ACQ camera mirror (if not already deployed) |
| 19 | | * OTT sets guider/ACQ filters to g` for LRS2-B and r` for LRS2-R |
| 20 | | * OTT sets analysis region and fiducial on ACQ camera based on best marker position for B or R |
| 21 | | * OTT starts ACQ camera pipeline and metrology loop (be sure images are saving) |
| 22 | | Once the trajectory has started and the "correct for structure" has completed: |
| 23 | | * TO offsets target to IFU position (directACAM) or offsets nearby star to position from finder chart (ACAM blind) |
| 24 | | * TO activates metrology loop (guiding) on the ACQ camera |
| 25 | | * TO offsets both of the guide probes to center the guide star in the field; focuses within 0.05mm of best focus |
| 26 | | * if the star on the ACAM is positioned and steady at the correct pixel coordinates then make and set a guide box on the guide probe and hit start loop. After the image refreshes you will see a red cross mark on the guide cam, that is your new fiducial. At this point you can deactivate loop and stop loop on the ACAM and start loop and activate loop on the guide probe. |
| 27 | | * TO retracts ACQ mirror and stops ACQ pipeline (making sure at least 1 ACQ image is stored while guiding on the guider - TBD: identify/flag the "setup" image) |
| 28 | | * TO clicks "Setup Complete" and tell the RA that the telescope is ready |
| 29 | | * RA starts science exposures and monitors data quality |
| 30 | | * TO centers and activate a wave-front sensor (this can be started earlier in the process as well) |
| 31 | | * TO monitors metrology from guiders and wavefront sensors and tip-tilt camera during science observation |
| 32 | | * At end of science exposure, RA knows when it is time to cancel trajectory and setup, and send the next target |
| | 18 | [[br]] |
| | 19 | |
| | 20 | [[br]] |
| | 21 | |
| | 22 | What follows are ideas of how these /should/ work, not necessarily how they *do* work. This is a work in progress. -- March 2021, SJ |
| | 23 | |
| | 24 | === Commands from RA side to set up on target: === |
| | 25 | |
| | 26 | * Copy fake-ACAM image to nossy/noss/htopx2/acam.html, update setup method, etc |
| | 27 | * If on a trajectory, cancel_trajectory() |
| | 28 | * Load_trajectory() for this target |
| | 29 | * Set all probe positions for "next" (can this be done while trajectory is being canceled?) |
| | 30 | * tcs.Guider1_set_position() |
| | 31 | * tcs.Guider2_set_position() |
| | 32 | * tcs.WFS1_set_position() |
| | 33 | * tcs.WFS2_set_position() |
| | 34 | * tcs.go_next() |
| | 35 | * waits for that to return before continuing... |
| | 36 | * set magnitudes/IDs for probe stars: |
| | 37 | * pas.Guider1_SetObjectAndMagnitudes() |
| | 38 | * pas.Guider2_SetObjectAndMagnitudes() |
| | 39 | * pas.WFS1_SetObjectAndMagnitudes() |
| | 40 | * pas.WFS2_SetObjectAndMagnitudes() |
| | 41 | * if directACAM setup, send target magnitude to PAS for ACQ |
| | 42 | * tcs.set_metadata() for the target using queue data/etc |
| | 43 | * play "ready for setup" sound |
| | 44 | * tcs.wait_for_setup() |
| | 45 | |
| | 46 | * somewhere in here, probably before the go_next() command, the RA scripts need to: |
| | 47 | * start extra pre-calibrations if requested (e.g., LFC) |
| | 48 | * set UTDATE of observation |
| | 49 | * attach to one/both instruments (if parallel) |
| | 50 | * get observation number from DB |
| | 51 | |
| | 52 | === Commands from RA side after setup_complete: === |
| | 53 | * **VIRUS and LRS2**: |
| | 54 | * virus.enable_shutter() or lrs2.enable_shutter() |
| | 55 | * tcs_proxy.pfip.!AdjustDither(pos=1) |
| | 56 | * For every exposure |
| | 57 | * Signal message start to message board |
| | 58 | * pfip.!AdjustDither() |
| | 59 | * if parallel, start appropriate exposure |
| | 60 | * virus.expose() or lrs2.expose() |
| | 61 | * virus.wait_for_shutter_close() |
| | 62 | * If dithering: |
| | 63 | * tcs.Guider1_offset_fiducial() |
| | 64 | * tcs.Guider2_offset_fiducial() |
| | 65 | * virus.wait_for_readout() (except not on last exposure) |
| | 66 | * check for user abort request |
| | 67 | * tcs.update_setup(state=false) |
| | 68 | * "exposure finished" sound |
| | 69 | * can cancel trajectory and go to next target |
| | 70 | * may need to start post-exposure calibration (e.g., LFC) |
| | 71 | * clear metadata |
| | 72 | |
| | 73 | * **HPF**: |
| | 74 | * PFIP shutter is already open for HPFACAM setups, so go straight to: |
| | 75 | * ssh command to start exposure on hpf system |
| | 76 | * start parallel VIRUS exposure |
| | 77 | * PFIP shutter is closed(?) for DirectACAM setups, so: |
| | 78 | * open PFIP shutter? |
| | 79 | * ssh command to start exposure on hpf system |
| | 80 | * start parallel VIRUS exposure |
| | 81 | * after HPF exposure finishes: |
| | 82 | * If HPFACAM setup: deploy ACQ camera mirror, set short exposure time, take 1 image, indicate OBJECT keyword or something to tell what it is |
| | 83 | * **should this be done by TO script?** |
| | 84 | * close PFIP shutter |
| | 85 | * "exposure finished" sound |
| | 86 | * can now cancel trajectory and go on to next target |
| | 87 | * may need to start post-exposure calibration (e.g., LFC) |
| | 88 | * clear metadata |
| 35 | | === VIRUS DirectGuider or ACAMblind |
| 36 | | * OTT deploys ACQ camera mirror (if not already deployed) |
| 37 | | * OTT sets guider/ACQ filters to g` |
| 38 | | * OTT starts ACQ camera pipeline and metrology loop (be sure images are saving) |
| 39 | | Once the trajectory has started and the "correct for structure" has completed: |
| 40 | | * TO offsets nearby star on ACQ camera to position from finder chart (ACAMblind) or centers star on guider (DirectGuider) |
| 41 | | * If ACAMblind: TO activates metrology loop (guiding) on the ACQ camera |
| 42 | | * If ACAMblind: TO offsets both of the guide probes to center the guide star in the field; focuses within 0.05mm of best focus |
| 43 | | * If ACAMblind: if the star on the ACAM is positioned and steady at the correct pixel coordinates then make and set a guide box on the guide probe and hit start loop. After the image refreshes you will see a red cross mark on the guide cam, that is your new fiducial. At this point you can deactivate loop and stop loop on the ACAM and start loop and activate loop on the guide probe. |
| 44 | | * TO retracts ACQ mirror and stops ACQ pipeline (making sure at least 1 ACQ image is stored while guiding on the guider, if ACAMblind - TBD: identify/flag the "setup" image) |
| 45 | | * TO clicks "Setup Complete" and tell the RA that the telescope is ready |
| 46 | | * RA starts science exposures and monitors data quality |
| 47 | | * TO centers and activate a wave-front sensor (this can be started earlier in the process as well) |
| 48 | | * TO monitors metrology from guiders and wavefront sensors and tip-tilt camera during science observation |
| 49 | | * At end of science exposure, RA knows when it is time to cancel trajectory and setup, and send the next target |
| | 91 | [[br]] |
| | 92 | |
| | 93 | [[br]] |
| | 94 | |
| | 95 | [[br]] |
| 52 | | === HPF DirectACAM ("HPF direct") |
| 53 | | * OTT deploys ACQ camera mirror (if not already deployed) |
| 54 | | * OTT sets guider/ACQ filters to i` |
| 55 | | * OTT sets analysis region and fiducial on ACQ camera |
| 56 | | * OTT sets analysis region and fiducial on both guiders |
| 57 | | * OTT starts ACQ camera pipeline and metrology loop (be sure images are saving) |
| 58 | | Once the trajectory has started and the "correct for structure" has completed: |
| 59 | | * TO is prompted to center the star on HPF Direct fiducial on ACQ camera |
| 60 | | * TO activates metrology loop (guiding) on the ACQ camera |
| 61 | | * TO offsets both of the guide probes to center the guide star in the field; focuses within 0.05mm of best focus |
| 62 | | * if the star on the ACAM is positioned and steady at the correct pixel coordinates then make and set a guide box on the guide probe and hit start loop. After the image refreshes you will see a red cross mark on the guide cam, that is your new fiducial. At this point you can deactivate loop and stop loop on the ACAM and start loop and activate loop on the guide probe. |
| 63 | | * TO presses "Enter" in OTT terminal after handshake |
| 64 | | * TO clicks "setup_complete" and tells the RA that the telescope is ready |
| 65 | | * OTT retracts ACQ mirror and stops ACQ pipeline (making sure at least 1 ACQ image is stored while guiding on the guider - TBD: identify/flag the "setup" image) |
| 66 | | * RA starts science exposures and monitors data quality |
| 67 | | * TO centers and activate a wave-front sensor (this can be started earlier in the process as well) |
| 68 | | * TO monitors metrology from guiders and wavefront sensors and tip-tilt camera during science observation |
| 69 | | * At end of science exposure, *SOMEONE* inserts ACQ camera mirror and takes 1 image (by cycling the pipeline) before canceling the trajectory and setup. |
| | 98 | === Setup procedures on the TO side (mostly via OTT and setup scripts) === |
| | 99 | * TO uses OTT to click setup/instrument of choice (or maybe this is automated?) |
| | 100 | * OTT deploys ACQ camera mirror |
| | 101 | * OTT sets guider/ACQ filters to: |
| | 102 | * g` for LRS2-B and VIRUS |
| | 103 | * r` for LRS2-R |
| | 104 | * i` for HPF |
| | 105 | * OTT sets guider exposure times to 6s (or not?) |
| | 106 | * OTT sets WFS exposure times to 5s |
| | 107 | * OTT sets analysis region and fiducial on ACQ camera based on best marker position, using IFU in setup? |
| | 108 | * 000 --> IHMP position |
| | 109 | * 056 --> LRS2-B position |
| | 110 | * 066 --> LRS2-R position |
| | 111 | * 600 --> HPFACAM position ("regular") |
| | 112 | * 603 --> HPF science fiber position ("direct") |
| | 113 | * 555 --> BIB position |
| | 114 | * OTT starts ACQ camera pipeline and metrology loop (saving images) |
| | 115 | * OTT starts Guider/WFS camera pipelines and metrology loops (saving images) |
| | 116 | * OTT sets analysis regions and fiducials on Guiders based on best marker positions |
| | 117 | * OTT tunes PID loops on guiders/ACAM/HPFACAM |
| | 120 | Once the trajectory has started and the "correct for structure" has completed: |
| | 121 | * TO offsets target to desired position (directACAM), or offsets nearby star to position from finder chart (ACAMblind), or centers a guide star and activates it (directGuider), or offsets target to HPFACAM position (HPFACAM) ---- all of these are done as a "pointing correction" so we know the offset. |
| | 122 | * If directACAM or ACAMblind: |
| | 123 | * TO activates metrology loop (guiding) on the ACQ camera |
| | 124 | * TO offsets both of the guide probes to center the guide star in the field; focuses within 0.1mm of best focus |
| | 125 | * if the star on the ACQ camera is positioned and steady at the correct pixel coordinates then make and set a guide box on the guide probe and hit start loop. After the image refreshes you will see a red cross mark on the guide cam, that is your new fiducial. At this point you can deactivate loop and stop loop on the ACQ and start loop and activate loop on the guide probe. |
| | 126 | * TO retracts ACQ mirror and stops ACQ pipeline (making sure at least 1 ACQ image is stored while guiding on the guider - **TBD: identify/flag the final "setup" image - maybe header keywords or metadata with PROGID and QIDX?**) |
| | 127 | * If HPFACAM: |
| | 128 | * These will have happened earlier: |
| | 129 | * OTT opens PFIP shutter |
| | 130 | * OTT sets exposure time on HPFACQ camera to 9s |
| | 131 | * OTT sets analysis region and fiducial on HPF ACQ camera |
| | 132 | * OTT starts HPF ACQ camera pipeline and metrology loop (saving images) |
| | 133 | * After TO coarsely centers the star on HPF Regular fiducial on ACQ camera, OTT retracts ACQ camera mirror, stops ACQ camera pipeline, activates metrology loop on HPF ACQ camera |
| | 134 | * OTT prompts TO for guider number to set up on |
| | 135 | * OTT sets analysis region and fiducial on selected guider |
| | 136 | * OTT prompts TO to center star in guider, then press "enter" |
| | 137 | * OTT offsets by dx,dy=+5,+4 arcsec (or whatever current values are in use) |
| | 138 | * OTT prompts TO to handshake from HPF ACQ camera to selected guider then press "enter" |
| | 139 | * OTT offsets guider by final dx,dy values |
| | 140 | * OTT stops HPF ACQ camera pipeline |
| | 141 | * TO clicks "Setup Complete" and tell the RA that the telescope is ready |
| | 142 | * RA script starts science exposures; RA monitors sky quality and science data quality |
| | 143 | * TO centers and activate a wave-front sensor (this can be started earlier in the process as well) |
| | 144 | * TO monitors metrology from guiders, wavefront sensors, and tip-tilt camera during science observation |
| | 145 | * At the end of the HPFACAM setup, **SOMEONE** inserts ACQ camera mirror and takes 1 image (by cycling the pipeline) before canceling the trajectory and setup (TBD: identify/flag the post-observing image - maybe set header keyword?) |
| | 146 | * After that, RA script knows when it is time to flag setup as false, cancel the trajectory, and send the next target |
| 73 | | === HPF HPFACAM ("HPF regular") |
| 74 | | * OTT deploys ACQ camera mirror (if not already deployed) |
| 75 | | * OTT opens PFIP shutter (if not already open) |
| 76 | | * OTT tunes PID loops on guiders/ACAM/HPFACAM |
| 77 | | * OTT sets guider/ACQ filters to i` |
| 78 | | * OTT sets analysis region and fiducial on ACQ camera |
| 79 | | * OTT sets exposure time on HPFACQ camera to 9s |
| 80 | | * OTT sets analysis region and fiducial on HPF ACQ camera |
| 81 | | * OTT sets analysis region and fiducial on both guiders |
| 82 | | * OTT starts ACQ camera pipeline and metrology loop (be sure images are saving) |
| 83 | | * OTT starts HPF ACQ camera pipeline and metrology loop (not saving images) |
| 84 | | Once the trajectory has started and the "correct for structure" has completed: |
| 85 | | * TO is prompted to center the star on HPF Regular fiducial on ACQ camera, then press "enter" |
| 86 | | * OTT retracts ACQ camera mirror, stops ACQ camera pipeline, activates metrology loop on HPF ACQ camera |
| 87 | | * OTT prompts TO for guider number to set up on |
| 88 | | * OTT sets analysis region and fiducial on selected guider |
| 89 | | * OTT prompts TO to center star in guider, then press "enter" |
| 90 | | * OTT offsets by dx,dy=+5,+4 arcsec |
| 91 | | * OTT prompts TO to handshake from HPF ACQ camera to selected guider then press "enter" |
| 92 | | * OTT offsets guider by final dx,dy values |
| 93 | | * OTT stops HPF ACQ camera pipeline |
| 94 | | * OTT prompts to to click "Setup Complete" and tell the RA the telescope is ready. |
| 95 | | * RA starts science exposures and monitors data quality |
| 96 | | * TO centers and activate a wave-front sensor (this can be started earlier in the process as well) |
| 97 | | * TO monitors metrology from guiders and wavefront sensors and tip-tilt camera during science observation |
| 98 | | * At end of science exposure, *SOMEONE* inserts ACQ camera mirror and takes 1 image (by cycling the pipeline) before canceling the trajectory and setup (TBD: identify/flag the post-observing image). |
| | 148 | |
| | 149 | [[br]] |
| | 150 | |
| | 151 | [[br]] |
| | 152 | |
| | 153 | [[br]] |
| | 154 | |
| | 155 | [[br]] |
| | 156 | |
| | 157 | [[br]] |
| | 158 | |
| | 159 | [[br]] |
| | 160 | |
| | 161 | [[br]] |
| | 162 | |
