Skip to content

Commit

Permalink
some startup/shutdown and alignment updates
Browse files Browse the repository at this point in the history
  • Loading branch information
jaredmales committed Oct 17, 2024
1 parent 651ef9c commit 4af5289
Show file tree
Hide file tree
Showing 3 changed files with 107 additions and 57 deletions.
74 changes: 50 additions & 24 deletions operating/alignment.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ System Pupil Alignment
Tweeter Pupil Alignment (F-Test)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To align the pupil on the tweeter, we perform the F-Test.
To align the pupil on the tweeter, we perform the F-Test (which is actually an R).

Prepare the system:

Expand All @@ -19,23 +19,49 @@ Prepare the system:

* **fwscind.filterName** in **pupil**

* **fwsci1.filterName** in **z** (or whichever filter works the best for conditions)
* **fwsci1.filterName** in **z** (in almost all cases you should align in `z` for repeatability)

* configure **camsci1** so that you can see the pupil without saturating.

* as needed, move **stagesci1** to focus the pupil image. You want to be somewhat out of focus to see the test pattern well. The preset **fpm** works well.
* Move **stagesci1** to preset **fpm**.

Now put the test pattern on the tweeter with **Pupil Alignment GUI** for dmtweeter. Press the **set test** under **tweeter**
Now put the test pattern on the tweeter with **Pupil Alignment GUI** for dmtweeter. Press the **set test** under **Tweeter**

Next, use the "Pupil Steering" section to align the pupil on the tweeter using the arrow keypad . The following figure demonstrates what a good alignment looks like.
Next, use the "TTM Pupil" section to align the pupil on the tweeter using the arrow keypad.
The following figure demonstrates what a good alignment looks like.

.. image:: f-test-good.png
:width: 500
:align: center

Note that you may need to change the focus by moving **stagelowfs**.

When done, press the **zero test** button on dmCtrl GUI for dmtweeter.

When done, press the **zero test** button on dmCtrl GUI uner **Tweeter**.

NCPC Pupil Alignment (J-Test)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To align the pupil on the NCPC DM, we perform the J-Test.

Prepare the system:

* **fwpupil.filterName** in **open**

* **fwfpm.filterName** in **open**

* **fwlyot.filterName** in **open**

* **fwscind.filterName** in **pupil**

* **fwsci1.filterName** in **z** (in almost all cases you should align in `z` for repeatability)

* configure **camsci1** so that you can see the pupil without saturating.

* Move **stagesci1** to preset **jtest**.

Now put the test pattern on the NCPC with **Pupil Alignment GUI** for dmncpc. Press the **set test** under **NCPC**

Next, use the "TTM Peri" section to align the pupil on the tweeter using the arrow keypad.
The following figure demonstrates what a good alignment looks like.

Pyramid Alignment
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand All @@ -62,14 +88,14 @@ Find and mark the pupil position on **camlowfs**:

* **stagelosel.presetName** in **pupil**

* **fwlowfs.filterName** in **z**
* **fwlowfs.filterName** in **z**

* **camlowfs** settings can be adjusted. Typical settings are

- **exptime** = **0.05**

- **readout_speed** = **emccd_17MHz**

- **vshift_speed** = **3_3us**

* **camlowfs.shutter** to **open**
Expand All @@ -81,7 +107,7 @@ Find and mark the pupil position on **camlowfs**:
.. image:: camlowfs_tgt.png
:width: 500
:align: center

Now align the desired pupil mask. First select the presets for the mask:

* **fwpupil.filterName** in desired position (e.g. **bump-mask**)
Expand All @@ -93,28 +119,28 @@ Now open coronaAlignGUI and use the "Pupil Plane" buttons to move the mask. The
.. image:: bump-mask_aligned.png
:width: 500
:align: center

Do not move fwpupil anymore.

Lyot Stop Alignment
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* Set **fwfpm.filterName**:
* Set **fwfpm.filterName**:

- if you are using the Lyot FPM, or any other transmissive FP optic:

+ select the desired mask

+ **stagelosel.presetName** = fpm

+ using the coronaAlignGUI "Lyot Plane" left-right buttons, move the spot so it is not obstructing the beam. You will see two approx equal images (one is a ghost).
+ adjust **dmncp** focus using such that the spots are roughly in focus.

+ adjust **dmncp** focus using such that the spots are roughly in focus.

+ note that you may need to adjust **camlowfs** due to saturation

- otherwise, select **open**

* **fwscind.filterName** = **pupil**

* **stagescibs** = **none** (any position will actually work)
Expand All @@ -138,7 +164,7 @@ and adjust Lyot Plane with coronaAlignGUI until aligned. See the below figure:
.. image:: fwlyot_lyotlg1_aligned.png
:width: 500
:align: center

Focal Plane Mask Alignment
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand All @@ -160,7 +186,7 @@ Now adjust Focal Plane with coronaAlignGUI until aligned. The post-coronagraph
:width: 500
:align: center

Now run eye-doctor to optimize the FPM alignment with the following command
Now run eye-doctor to optimize the FPM alignment with the following command

.. code::
Expand Down
59 changes: 38 additions & 21 deletions operating/daily_shutdown.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,27 @@
Daily Shutdown
===============

These procedures are used for shutting down MagAO-X at the end of a work day.
These procedures are used for shutting down MagAO-X at the end of a work period.

Rules to follow:
- do not power off a DM unless it has been released
- do not power off a temperature-controlled camera unless its temp is 20C or higher
- do not power off instcool!
- steps can be done in parrallel, so start warming up cameras, go on, then come back


Lunch Break
-------------
If you are just taking a break and plan to come back to keep working, you only need to
shut off `dmtweeter` and `dmncpc`:
- open the loop if closed (holoop for tweeter, loloop for ncpc)
- press "loop zero"
- zero flat
- zero all ch
- release
- power off



Minimal shutdown
----------------
Expand All @@ -19,29 +39,25 @@ The main goal here is to shutoff "the expensive stuff". Namely:
- camlowfs
- ttmmod
- ttmpupil
- ttmperi

Rules:
- do not power off a DM unless it has been released
- do not power off a camera unless its temp is 20C or higher
- do not power off instcool!
- steps can be done in parrallel, so start warming up cameras, go on, then come back

Cameras (each of camsci1 camsci2 camlowfs camwfs):

Cameras (each of camsci1 camsci2 camwfs, but not camflowfs and camllowfs):
- close the shutter
- warm up to 20C (use cameraGUI, change setpoint)
- wait for it to finish
- power off
- note: for camlowfs, power off under both pdu1 and usbdu0.

dmtweeter:
- open the loop
dmtweeter and dmncpc:
- open the loop if closed (holoop for tweeter, loloop for ncpc)
- press "loop zero"
- zero flat
- zero all ch
- release
- power off

dmwoofer and dmncpc
dmwoofer
- zero flat
- zero all ch
- release
Expand All @@ -56,6 +72,10 @@ ttmpupil
- press rest in Pupil Alignment GUI
- power off

ttmperi
- press rest in Pupil Alignment GUI
- power off

Additionally:
- power off camtip (its just a heater)
- power off source
Expand All @@ -66,27 +86,24 @@ Remaining devices such as focus stages and filter wheels can be left on, which w
Standard Daily Shutdown
-----------------------

If MagAO-X will be unused for a longer period of time (say a weekend), we typically shut down everything but computers, networking and cooling.
If MagAO-X will be unused for a longer period of time (say a weekend), we typically shut down everything but computers, networking and cooling.

At the end of this, the following things will still be on:

- pdu0.compicc
- pdu0.comprtc
- pdu0.dcpwr
- pdu0.swinst
- pdu3.blower
- pdu2.camflowfs
- pdu2.camllowfs
- pdu3.blower
- pdu3.fanaux
- pdu3.fanmain
- pdu3.instcool
- pdu3.instcool

**Note:** it is critical that you not shutdown instcool while compicc and/or comprtc are on!

Follow the steps in "Minimal Shutdown" above. Also do the following.

fwtelsim and fwscind:

- first power off on usbdu0
- then power off on dcdu1
Follow the steps in "Minimal Shutdown" above.

Everything else (except the items listed above) can be shutdown in any order. Occassional errors in the logs during shutdown may occur.
Everything else (except the items listed above) can be shutdown in any order. Occassional errors in the logs during shutdown may occur.

31 changes: 19 additions & 12 deletions operating/daily_startup.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,19 +10,23 @@ generally be the instrument state on a daily basis.
- pdu3.fanaux
- pdu3.fanmain
- pdu3.instcool
- usbdu0.rhtweeter
- usbdu1.rhncpc

If any of these are off, stop and investigate. These are safety issues and you should not go on.

3. On the `pwrGUI`, verify that the following items are on:
2. On the `pwrGUI`, verify that the following items are on:

- pdu0.compicc
- pdu0.comprtc
- pdu0.dcpwr
- pdu0.swinst

If any of these are off the instrument probably won't work.
- pdu2.camllowfs
- pdu2.camflowfs

1. Ensure MagAO-X processes are started on AOC, ICC and RTC. We do this by running `xctrl status` on each machine.
If any of these are off the instrument probably won't work.

3. Ensure MagAO-X processes are started on AOC, ICC and RTC. We do this by running `xctrl status` on each machine.


::
Expand All @@ -41,28 +45,31 @@ If any of these are off the instrument probably won't work.
# verify processes are all green/running
[[xsup@exao2 ~]$ exit

2. Power up the MagAO-X components:
4. On actual MagAO-X, you should have all of the needed GUIs open. On a remote machine, you will need
to setup GUIs to your liking.

5. Power up the MagAO-X components:

- dcdu0: all devices
- dcdu1: all devices
- pdu0: source, ttmperi (other devices are already one as above)
- pdu0: source, ttmperi (other devices are already on as above)
- pdu1: all devices [check humidity before dmncpc and dmtweeter]
- pdu2: all devices
- pdu3: flippers, tableair. camvisx and turbsim are maybe. (other devices are already on as above)
- pduhcat: if you are using GMT HCAT, all devices on. (only in lab)
- pduhcat: if you are using GMT HCAT, all devices on. (only in lab, won't show up at telescope)
- usbdu0: all devices
- usbdu1: camvisx is maybe. all other devices.

3. Set the flat on all three DMs.
6. Set the flat on the `woofer` and the `tweeter`.

4. For lab work, put `stagepickoff` in `lab`. At the telescope it must be in `tel` to see a star.
7. For lab work, put `stagepickoff` in `lab`. At the telescope it must be in `tel` to see a star.

5. Now ``set`` the pupil TTM and ``set`` the pyramid modulator TTM on the "Pupil Alignment GUI.
8. Now ``set`` the pupil TTM, ``set`` the pyramid modulator TTM, and ``set`` ttmPeri on the "Pupil Alignment GUI.

6. At this point you should see a PSF image on `camtip`. If you don't use the system block diagram to troubleshoot.
9. At this point you should see a PSF image on `camtip`. If you don't use the system block diagram to troubleshoot.
The most likely causes are that you forgot to power something on (the source?) or that `stagepickoff` is in the wrong position.

7. Now you can proceed to alignment
10. Now you can proceed to alignment



Expand Down

0 comments on commit 4af5289

Please sign in to comment.