Merge pull request #141 from lsst-ts/tickets/SITCOM-1639

Tickets/sitcom 1639

Author: isotuela

AuxTel/Components/ATCS.rst

@@ -15,3 +15,4 @@ to interact with it.
 
 
 
+

AuxTel/Components/ATCalSys.rst

@@ -1,7 +1,7 @@
 .. _AuxTel-Components-ATCalSys:
 
 ######################
-AT Calibrations System
+AT Calibration System 
 ######################
 
 `AuxTel Illumination System Handbook`_

AuxTel/Components/EUI-Access/index.rst

@@ -0,0 +1,98 @@
+.. This is a template for an informative/general use document. 
+
+.. Review the README in this document's directory on instructions to contribute.
+.. Static objects, such as figures, should be stored in the _static directory. Review the _static/README in this procedure's directory on instructions to contribute.
+.. Do not remove the comments that describe each section. They are included to provide guidance to contributors.
+.. Do not remove other content provided in the templates, such as a section. Instead, comment out the content and include comments to explain the situation. For example:
+	- If a section within the template is not needed, comment out the section title and label reference. Include a comment explaining why this is not required.
+    - If a file cannot include a title (surrounded by ampersands (#)), comment out the title from the template and include a comment explaining why this is implemented (in addition to applying the ``title`` directive).
+
+.. Include one Primary Author and list of Contributors (comma separated) between the asterisks (*):
+.. |author| replace:: *Kshitija Kelkar*
+.. If there are no contributors, write "none" between the asterisks. Do not remove the substitution.
+.. |contributors| replace:: *OS Team*
+
+.. This is the label that can be used as for cross referencing this procedure.
+.. Recommended format is "Directory Name"-"Title Name"  -- Spaces should be replaced by hyphens.
+.. _AuxTel-Components-AuxTel-EUI-Access:
+.. Each section should includes a label for cross referencing to a given area.
+.. Recommended format for all labels is "Title Name"-"Section Name" -- Spaces should be replaced by hyphens.
+.. To reference a label that isn't associated with an reST object such as a title or figure, you must include the link an explicit title using the syntax :ref:`link text <label-name>`.
+.. An error will alert you of identical labels during the build process.
+
+.. role::  raw-html(raw)
+    :format: html
+
+####################
+AuxTel EUI Access
+####################
+
+.. _AuxTel-EUI-Access-Overview:
+
+Overview
+========
+
+.. This section should provide a brief, top-level description of the document's purpose and utilization. 
+
+This document explains how to access all the components of *AuxTel EUI*-- for ATMCS, ATSPectrograph and ATDome-- through a remote desktop.
+
+AuxTel EUI Access
+========================
+ 
+.. _Auxtel-EUI-Access-Setup:
+
+Setup to access the AuxTel EUI remote desktop 
+---------------------------------------------
+
+#. Install and open **Microsoft Remote Desktop**.
+
+#. Click :guilabel:`+` button on the top menu.
+
+#. Select "Gateway" from drop-down menu.
+
+#. Click the drop-down menu "Gateway" :raw-html:`&rarr;` "No gateway"
+
+.. figure:: /AuxTel/Components/_static/AddAGateway.png
+  :name: "Add a Gateway" pop-up window.
+  :width: 500
+
+  "Add a Gateway" pop-up window.
+
+#. Put *aux-brick01.cp.lsst.org* on the "PC name" :raw-html:`&rarr;` "Save"
+
+.. figure:: /AuxTel/Components/_static/Adding_AuxTel_EUI.png
+  :name: "PC name" field.
+  :width: 500
+
+  "PC name" field.
+
+.. note::
+    You need to configure this setup only once. 
+
+.. _Auxtel-EUI-Access-Connection:
+
+Connecting to the EUI Remote desktop
+------------------------------------
+
+#. Login with Username/PW of **ATMCS/ATSpectrograph/ATDome EUI access** on 1Password **AuxTel** Vault.
+
+
+#. The following tabs can now be accessible from the web-browser:
+
+    * *Main Box Dome Control: http://139.229.170.45:8000/MainBoxControl.html*   
+
+    .. figure:: /AuxTel/Components/_static/EUI-ATDome.png    
+    
+    * *ACE Spectrograph: http://139.229.170.44:8000/Spectrograph.html*  
+
+    .. figure:: /AuxTel/Components/_static/EUI-ATSpec.png  
+    
+    * *LSST Auxiliary Telescope MCS & Pneumatics: http://139.229.170.47:8000/atmcs.html*
+    
+    .. figure:: /AuxTel/Components/_static/EUI-ATMCS.png  
+    
+    * *Top Box Control: http://139.229.170.46:8000/TopBoxControl.html*
+    
+    .. figure:: /AuxTel/Components/_static/EUI-Top-Control-Box.png
+
+This procedure was last modified on |today|.

AuxTel/Components/_static/AddAGateway.png

@@ -2,22 +2,22 @@
 .. If there are no contributors, write "none" between the asterisks. Do not remove the substitution.
 .. |contributors| replace:: *none*
 
-.. _AuxTel-Nighttime-Operations-WEP:
+.. _AuxTel-Non-Standard-Operations-Center-Focus:
 
 ####################################################################################
-Beginning of the night: Center, absorb pointing offsets, mirror alignment and focus
+Center, absorb pointing offsets, mirror alignment and focus
 ####################################################################################
 
-.. _Beginning_of_the_night-the-Telescope-Overview:
+.. _Center-Focus-Overview:
 
 Overview
 ========
 
-This procedure must be followed by the observers before the beginning of dark time, prior to starting science or engineering activities.
+This procedure must be followed if the pointing or focus is lost for whatever reason. 
 
 It will center a target, absorb the zero-point pointing offsets, align mirrors and focus the telescope. 
 
-.. _Beginning_of_the_night-Precondition:
+.. _Center-Focus-Precondition:
 
 Precondition
 =============
@@ -27,23 +27,25 @@ Precondition
 - The sky brightness is low enough that the WEP (wavefront estimate pipeline) can converge successfully. 
   This condition is normally achieved around 10-15 minutes before the end of nautical twilight or dark time. 
 
-.. _Beginning_of_the_night-Post-Conditions:
+.. _Center-Focus-Post-Conditions:
 
 Post-Condition
 ===============
 
 - Telescope is aligned, focused and pointing offsets have been absorbed. 
 
-  The system is ready to start :ref:`scheduler-driven observations <Scheduler-Scheduler-Operational-Procedures>` or engineering tasks. 
+  The system is ready to continue :ref:`scheduler-driven observations <Scheduler-Scheduler-Operational-Procedures>` or engineering tasks. 
 
-.. _Beginning_of_the_night-Procedure-Steps:
+.. _Center-Focus-Procedure-Steps:
 
 Procedure Steps
 ===============
 
 #. Confirm sky background is dark enough. 
 
-   As a general rule, a good time to start executing the following SAL scripts is 10-15 minutes before the end of nautical twilight. 
+   Generally, the sky becomes dark enough for Wavefront-Estimation Error script (WEP) to converge approximately 10 minutes before the end of nautical twilight.
+
+#. Pause the ATQueue and place at the top of the queue the scripts detailed in steps 3. and 4.  
 
 #. Command the telescope to measure and correct for any nightly pointing zero-point offsets using the SAL script ``auxtel/correct_pointing.py``.
 
@@ -56,36 +58,36 @@ Procedure Steps
 
    Nominally, the pointing offsets and mirror alignment are performed towards the east, ``az`` 90 deg, and at mid-elevations, ``el`` 60 deg. 
 
-   From the LOVE ``ATQueue`` panel, under ``AVAILABLE SCRIPTS``, add the external script ``auxtel/correct_pointing.py``, by clicking on the blue icon. 
+   From the LOVE ``ATQueue`` panel, under AVAILABLE SCRIPTS, add the external script :file:`auxtel/correct_pointing.py`, by clicking on the blue icon. 
 
-   Under ``CONFIG`` in the ``configuring Script:correct_pointing.py`` window, leave the window empty so the default configuration is loaded and click on ``Add``:
+   Under ``CONFIG`` in the ``configuring Script:correct_pointing.py`` window, leave the window empty so the default configuration is loaded and click on :guilabel:`Add`:
 
    .. figure:: ./_static/CorrectPointing_AuxTel.png
      :name: correctPointing
 
-     LOVE launching the ``correct_pointing`` script with the defaults, to find a target around ``az`` 90 deg and ``el`` 60 deg, 
+     LOVE launching the :file:`auxtel/correct_pointing.py` script with the defaults, to find a target around ``az`` 90 deg and ``el`` 60 deg, 
      magnitude limit ``mag_limit`` 6.0, magnitude range ``mag_range`` 4.0 and a search radius ``radius`` of 5 deg.  
 
    Visually inspect the recent images in RubinTV to confirm that the right target has been centered. 
    If it did, move to the next step. 
-   If it didn't, repeat step #2. 
+   If it didn't, repeat step #3. 
 
 #. Launch a WEP sequence on the same target to use the wavefront estimation pipeline to measure wavefront error and perform mirror alignment and focus. 
 
-   Load the script ``auxtel/latiss_wep_align.py``, available under ``External scripts`` in the ``ATQueue``. 
+   Load the script :file:`auxtel/latiss_wep_align.py`, available under ``External scripts`` in the ``ATQueue``. 
 
    In the ``Configuring Script: latiss_wep_align`` window, leave the ``CONFIG`` cell empty to perform the WEP over the same target the centering step was done and 
    which the telescope is still tracking.
 
-   Click on ``Add`` and the script will be added to the end of the script queue.
+   Click on :guilabel:`Add` and the script will be added to the end of the script queue.
 
    .. figure:: ./_static/WEP_AuxTel.png
        :name: latiss-wep
 
        Screenshot of LOVE launching the WEP. 
 
 
-If these three steps were successful, the telescope is now centered, aligned and focus. 
+If these steps were successful, the telescope is now centered, aligned and focus. 
 
 
 This procedure was last modified on |today|.

AuxTel/Components/_static/Adding_AuxTel_EUI.png

@@ -10,16 +10,22 @@ LATISS
     :glob:
 
     *
-    
-`LATISS Filter Change Procedure`_
- when adding/replacing a filter or disperser to LATISS. 
 
-To power up or power down the LATISS CCD follow `LATISS CCD Power up/down`_
 
+LATISS Warm-up and Cool-Down procedures
+=======================================
 `LATISS Warm-up and Cool-down Procedure`_ to pump and cool down LATISS from ambient pressure 
 to its operational temperatures. 
 It also outlines how to perform a controlled warm-up in the case of servicing or programmed power cuts.
 
+LATISS CCD Power up/down
+========================
+To power up or power down the LATISS CCD follow `LATISS CCD Power up/down`_
+
+LATISS Filter Change Procedure
+==============================
+Follow `LATISS Filter Change Procedure`_ when adding/replacing a filter or disperser to LATISS. 
+
 .. _LATISS Filter Change Procedure: https://sitcomtn-029.lsst.io/
 .. _LATISS CCD Power up/down: https://sitcomtn-026.lsst.io/
 .. _LATISS Warm-up and Cool-down Procedure: https://sitcomtn-074.lsst.io/ 

AuxTel/Components/_static/EUI-ATDome.png

@@ -4,14 +4,6 @@
 AuxTel Non-standard Operations
 ##############################
 
-.. toctree::
-    :maxdepth: 3
-    :titlesonly:
-    :glob:
-
-    EUI-Access/EUI-Access.rst
-
-
 .. toctree::
     :maxdepth: 3
     :titlesonly:
@@ -21,7 +13,6 @@ AuxTel Non-standard Operations
 
 .. toctree::
     :maxdepth: 3
-    :titlesonly:
     :glob:
 
     LATISS/index.rst