Merge pull request #89 from lsst-ts/tickets/SITCOM-1297

Tickets/sitcom 1297
lsst-ts · Apr 24, 2024 · 10291b4 · 10291b4
2 parents 223cf01 + 1030832
commit 10291b4
Show file tree

Hide file tree

Showing 249 changed files with 1,844 additions and 1,039 deletions.
diff --git a/AuxTel/AuxTel-Components/ATCS-Component.rst b/AuxTel/AuxTel-Components/ATCS-Component.rst
@@ -0,0 +1,17 @@
+.. _AuxTel-Components-ATCS:
+
+####
+ATCS
+####
+
+ATDome
+======
+
+`Interfacing with the Auxiliary Telescope dome hardware`_ for a thorough description of the ATDome hardware and how
+to interact with it. 
+
+.. _Interfacing with the Auxiliary Telescope dome hardware: https://sitcomtn-094.lsst.io/
+
+
+
+
diff --git a/AuxTel/AuxTel-Components/ATCalSys-Component.rst b/AuxTel/AuxTel-Components/ATCalSys-Component.rst
@@ -0,0 +1,11 @@
+.. _AuxTel-Components-ATCalSys:
+
+######################
+AT Calibrations System
+######################
+
+`AuxTel Illumination System Handbook`_
+contains a detailed system description, basic operations, maintenance and troubleshooting procedures.     
+
+
+.. _AuxTel Illumination System Handbook: https://tstn-032.lsst.io/ 
diff --git a/AuxTel/AuxTel-Components/LATISS-Component.rst b/AuxTel/AuxTel-Components/LATISS-Component.rst
@@ -0,0 +1,11 @@
+.. _AuxTel-Components-LATISS:
+
+##########################
+LATISS
+##########################
+
+`LSST Atmospheric Transmission and Slitless Spectrograph (LATISS) Instrument Handbook`_
+is a high-level user manual and description of the LATISS Instrument. 
+
+
+.. _LSST Atmospheric Transmission and Slitless Spectrograph (LATISS) Instrument Handbook: https://tstn-006.lsst.io/ 
diff --git a/...-Operations/ATCS-Non-standard-Procedures/ATCS-Non-standard-Procedures-index.rst b/...-Operations/ATCS-Non-standard-Procedures/ATCS-Non-standard-Procedures-index.rst
@@ -0,0 +1,12 @@
+.. _AuxTel-Non-standard-Operations-ATCS-Non-Standard-Procedures:
+
+############################
+ATCS Non-standard procedures
+############################
+
+.. toctree::
+    :maxdepth: 2
+    :titlesonly:
+    :glob:
+
+    *
diff --git a/...liary-Telescope/AuxTel-LOTO-procedure.rst → ...dard-Procedures/AuxTel-LOTO-procedure.rst b/...liary-Telescope/AuxTel-LOTO-procedure.rst → ...dard-Procedures/AuxTel-LOTO-procedure.rst
@@ -33,7 +33,7 @@ Overview
 
 AuxTel must be under LOTO (lock-out tag-out) any time physical work is undertaken on the mount or the dome. 
 When working with environmental sensors, on the truss, mirrors, or anywhere in the dome where unexpected movement could cause a safety hazard, the telescope must be locked out. 
-Trained summit support staff may use this procedure if they meet all of the preconiditon requirements. 
+Trained summit support staff may use this procedure if they meet all of the precondition requirements. 
 
 .. _AuxTel-LOTO-procedure-Precondition:
 
@@ -44,8 +44,10 @@ Precondition
 .. It is preferred to include them as a bulleted or enumerated list.
 .. If there is a different procedure that is critical before execution, carefully consider if it should be linked within this section or as part of the Procedure section below (or both).
 
-Before putting the AuxTel under LOTO, you must have completed the :ref:`LOTO safety training <Daytime-Operations-Safety-Control-Safety-Systems-LOTO>` and familiarized yourself with the Control Safety Systems document on that same page. 
-You should have your own unique lock and key with your information identified, and this work must be coordinated with the day crew. 
+Before putting the AuxTel under LOTO, you must have completed the :ref:`LOTO safety training <Daytime-Operations-Safety-Control-Safety-Systems-LOTO>` 
+and familiarized yourself with the Control Safety Systems document on that same page. 
+You should have your own unique lock and key with your information identified, and this work must be 
+coordinated with the day crew. 
 
 - The telescope must be parked in a safe position, and all CSCs in STANDBY. 
 
@@ -94,15 +96,15 @@ To put the AuxTel under LOTO, follow these steps:
 
     AT Control cabinet, inside, and EATON brakers.
 
-#. Inside the AT Control cabinet, identify the three (3) EATON brakers also shown in the figure, tagged from left to right. 
+#. Inside the AT Control cabinet, identify the three (3) EATON breakers also shown in the figure, tagged from left to right. 
 
    a. DRV #1 AZ AZ - The two drives for Azimuth motion.
 
    b. DRV #2 EL M3 - The drives for elevation and tertiary mirror motion.
 
-   c. DRV #3 NR1 NR2 - Motors for the nasmyth rotators 1 and 2. 
+   c. DRV #3 NR1 NR2 - Motors for the Nasmyth rotators 1 and 2. 
 
-#. Switch off all three brakers by flipping the switch down. 
+#. Switch off all three breakers by flipping the switch down. 
 
 #. Close the cabinet, and secure your lock and tag in the loop underneath the cabinet door handle. 
 
@@ -128,13 +130,11 @@ Troubleshooting
 .. If there is no content for this section, remove the indentation on the following line instead of deleting this sub-section.
 
 No troubleshooting information is applicable to this procedure.
-In the IMPOSSIBLE event that the telescope moves after turning off all three breakers, stop work immediately and notifty the day crew, including Jacques Sebag, Mario Rivera, and the electronics team. 
+In the IMPOSSIBLE event that the telescope moves after turning off all three breakers, stop work immediately and notify the day crew, including Jacques Sebag, Mario Rivera, and the electronics team. 
 
 .. _AuxTel-LOTO-procedure-Contact-Personnel:
 
 Contact Personnel
 ^^^^^^^^^^^^^^^^^
 
 This procedure was last modified |today|.
-
-This procedure was written by |author|. The following are contributors: |contributors|.
diff --git a/...Tel-E-Stop-Procedure/E-Stop-Procecure.rst → ...-standard-Procedures/E-Stop-Procedure.rst b/...Tel-E-Stop-Procedure/E-Stop-Procecure.rst → ...-standard-Procedures/E-Stop-Procedure.rst
@@ -41,7 +41,7 @@ One is located in the main ``AT Control Cabinet`` on the first floor just in fro
 A second one is located in the ``Dome Control Box`` between vent gates #3 and #4, also in the first floor. 
 Both systems can be used to either engage and/or disengage the emergency stop.
 
-.. figure:: ./_static/e-stop-switches-location.jpeg
+.. figure:: ./_static/e-stop-switches-location.png
     :name: e-stop-switches-location
 
     The E-stop systems located in the first floor.
@@ -51,7 +51,7 @@ as illustrated in the accompanying figure.
 It is worth noting, however, that this control box can only be used to initiate the emergency stop and cannot be used to release it, 
 as it does not have a ``Start`` button on it.
 
-.. figure:: ./_static/e-stop-up-stairs.jpeg
+.. figure:: ./_static/e-stop-up-stairs.png
     :name: e-stop-up-stairs
 
     E-stop switches located upstairs.
@@ -77,7 +77,7 @@ To trigger it, simply **push the big red button**.
 This will be enough to stop halt the telescope and avoid it from accidental/unexpected movements.
 To **release it**, simply **turn** the big red E-stop button **clockwise** a quarter or so and then **push the blue Start** button.
 
-.. figure:: ./_static/e-stop-buttons.jpeg
+.. figure:: ./_static/e-stop-buttons.png
     :name: e-stop-buttons
 
     ``Emergency Stop`` and ``Start`` buttons.
@@ -92,13 +92,13 @@ If the emergency stop was correctly triggered, you will see under the Mount stat
 Conversely, when the emergency stop is released, the red light will be turned off, indicating that the system has been successfully restarted.
 From that point onwards, the telescope will be released to move, either local or remotely, meaning it is ready for normal operation.
 
-.. figure:: ./_static/e-stop-indicator-red.jpeg
+.. figure:: ./_static/e-stop-indicator-red.png
     :name: e-stop-indicator-red
 
     E-stop status indicator. If a red light is turned on in the ``Emergency Stop`` indicator,
     the E-stop has been activated correctly.
 
-.. figure:: ./_static/e-stop-eletronics.jpeg
+.. figure:: ./_static/e-stop-eletronics.png
     :name: e-stop-electronics
 
     The Pilz controller inside the ``AT Control Cabinet`` located in the first floor. 
@@ -115,6 +115,4 @@ The three LEDs brightly illuminated are indicating that the E-stop system is rel
 Contact Personnel
 =================
 
-This procedure was last modified |today|.
-
-This procedure was written by |author|. The following are contributors: |contributors|.
+This procedure was last modified |today|.
diff --git a/...-Telescope/_static/AT-control-cabinet.png → ...Procedures/_static/AT-control-cabinet.png b/...-Telescope/_static/AT-control-cabinet.png → ...Procedures/_static/AT-control-cabinet.png
diff --git a/...top-Procedure/_static/e-stop-buttons.jpeg → ...ard-Procedures/_static/e-stop-buttons.png b/...top-Procedure/_static/e-stop-buttons.jpeg → ...ard-Procedures/_static/e-stop-buttons.png
diff --git a/...-Procedure/_static/e-stop-eletronics.jpeg → ...-Procedures/_static/e-stop-eletronics.png b/...-Procedure/_static/e-stop-eletronics.jpeg → ...-Procedures/_static/e-stop-eletronics.png
diff --git a/...ocedure/_static/e-stop-indicator-red.jpeg → ...ocedures/_static/e-stop-indicator-red.png b/...ocedure/_static/e-stop-indicator-red.jpeg → ...ocedures/_static/e-stop-indicator-red.png
diff --git a/...ure/_static/e-stop-switches-location.jpeg → ...ures/_static/e-stop-switches-location.png b/...ure/_static/e-stop-switches-location.jpeg → ...ures/_static/e-stop-switches-location.png
diff --git a/...p-Procedure/_static/e-stop-up-stairs.jpeg → ...d-Procedures/_static/e-stop-up-stairs.png b/...p-Procedure/_static/e-stop-up-stairs.jpeg → ...d-Procedures/_static/e-stop-up-stairs.png
diff --git a/...y-Telescope/_static/eui-estop-display.png → ...-Procedures/_static/eui-estop-display.png b/...y-Telescope/_static/eui-estop-display.png → ...-Procedures/_static/eui-estop-display.png
diff --git a/...ons/ATCalSys-Non-standard-Procedures/ATCalSys-Non-standard-Procedures-index.rst b/...ons/ATCalSys-Non-standard-Procedures/ATCalSys-Non-standard-Procedures-index.rst
@@ -0,0 +1,12 @@
+.. _AuxTel-Non-standard-Operations-ATCalSys-Non-Standard-Procedures:
+
+#############################################
+AT Calibration System Non-standard procedures
+#############################################
+
+.. toctree::
+    :maxdepth: 3
+    :titlesonly:
+    :glob:
+
+    *
diff --git a/AuxTel/AuxTel-Non-standard-Operations/AuxTel-Non-Standard-Operations-index.rst b/AuxTel/AuxTel-Non-standard-Operations/AuxTel-Non-Standard-Operations-index.rst
@@ -0,0 +1,29 @@
+.. _AuxTel-AuxTel-Non-standard-Operations:
+
+##############################
+AuxTel Non-standard Operations
+##############################
+
+
+.. toctree::
+    :maxdepth: 3
+    :titlesonly:
+    :glob:
+
+    ATCS-Non-standard-Procedures/ATCS-Non-standard-Procedures-index.rst
+
+.. toctree::
+    :maxdepth: 3
+    :titlesonly:
+    :glob:
+
+    LATISS-Non-standard-Procedures/LATISS-Non-standard-Procedures-index.rst
+
+
+.. toctree::
+    :maxdepth: 3
+    :titlesonly:
+    :glob:
+
+    ATCalSys-Non-standard-Procedures/ATCalSys-Non-standard-Procedures-index.rst
+
diff --git a/...rations/LATISS-Non-standard-Procedures/LATISS-Non-standard-Procedures-index.rst b/...rations/LATISS-Non-standard-Procedures/LATISS-Non-standard-Procedures-index.rst
@@ -0,0 +1,26 @@
+.. _AuxTel-Non-standard-Operations-LATISS-Non-Standard-Procedures:
+
+##############################
+LATISS Non-standard procedures
+##############################
+
+.. toctree::
+    :maxdepth: 3
+    :titlesonly:
+    :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 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 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/ 
+
diff --git a/...lescope/AuxTel-E-Stop-Procedure/index.rst → ...tions/AuxTel-Daytime-Operations-index.rst b/...lescope/AuxTel-E-Stop-Procedure/index.rst → ...tions/AuxTel-Daytime-Operations-index.rst
@@ -1,8 +1,10 @@
+.. _AuxTel-Daytime-Operations-index:
+
 #########################
-AuxTel E-Stop Procedure
+AuxTel Daytime Operations
 #########################
 
-This page describes how engage/disengage the e-stop button for the Auxiliary Telescope
+Preparations for the observing night
 
 .. toctree::
     :maxdepth: 2

diff --git a/...Checkout/Daytime-Checkout-SAL-Scripts.rst → ...l-Daytime-Operations/Daytime-Checkout.rst b/...Checkout/Daytime-Checkout-SAL-Scripts.rst → ...l-Daytime-Operations/Daytime-Checkout.rst
@@ -2,11 +2,11 @@
 .. If there are no contributors, write "none" between the asterisks. Do not remove the substitution.
 .. |contributors| replace:: *none*
 
-.. _AT-Daytime-Checkout-Daytime-Checkout:
+.. _AuxTel-DayTime-Operations-Daytime-Checkout:
 
-############################
-Daytime Checkout SAL Scripts
-############################
+##################
+Daytime Checkout 
+##################
 
 To ensure the Auxiliary Telescope is fully operational and ready for nighttime use, 
 we have created a series of SAL Scripts that successively checkout each of the major components, 
@@ -102,10 +102,5 @@ Quick Troubleshooting
 
 Add some tips here on what to do if things don't work. 
 
-Contact Personnel
-=================
 
-This procedure was last modified on |today|.
-
-This procedure was written by |author|.
-The following are contributors: |contributors|.
+This procedure was last modified on |today|.
diff --git a/...Telescope/AT-Venting/Prepare-for-Vent.rst → ...l-Daytime-Operations/Prepare-for-Vent.rst b/...Telescope/AT-Venting/Prepare-for-Vent.rst → ...l-Daytime-Operations/Prepare-for-Vent.rst
@@ -12,7 +12,7 @@
 
 .. 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.
-.. _AT-Pre-Prepare-for-vent:
+.. _AuxTel-Daytime-Operations-Prepare-for-vent:
 .. 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>`.
@@ -137,11 +137,4 @@ Procedure Steps
      LOVE displaying AuxTel telescope and dome venting. 
 
 
-.. _Prepare-for-vent-Contact-Personnel:
-
-Contact Personnel
-^^^^^^^^^^^^^^^^^
-
-This procedure was last modified |today|.
-
-This procedure was written by |author|. The following are contributors: |contributors|.
+This procedure was last modified |today|.
diff --git a/...Venting/_static/PrepareforVent_AuxTel.png → ...rations/_static/PrepareforVent_AuxTel.png b/...Venting/_static/PrepareforVent_AuxTel.png → ...rations/_static/PrepareforVent_AuxTel.png
diff --git a/...orVent_AuxTel_LOVEdisplayConfirmation.png → ...orVent_AuxTel_LOVEdisplayConfirmation.png b/...orVent_AuxTel_LOVEdisplayConfirmation.png → ...orVent_AuxTel_LOVEdisplayConfirmation.png
diff --git a/...PrepareforVent_AuxTel_VentGate3andFan.png → ...PrepareforVent_AuxTel_VentGate3andFan.png b/...PrepareforVent_AuxTel_VentGate3andFan.png → ...PrepareforVent_AuxTel_VentGate3andFan.png
diff --git a/..._static/PrepareforVent_AuxTel_running.png → ..._static/PrepareforVent_AuxTel_running.png b/..._static/PrepareforVent_AuxTel_running.png → ..._static/PrepareforVent_AuxTel_running.png
diff --git a/...re/_static/bias-cp-verify-latiss-fail.png → ...ns/_static/bias-cp-verify-latiss-fail.png b/...re/_static/bias-cp-verify-latiss-fail.png → ...ns/_static/bias-cp-verify-latiss-fail.png
diff --git a/...rocedure/_static/bias-cp-verify-table.png → ...erations/_static/bias-cp-verify-table.png b/...rocedure/_static/bias-cp-verify-table.png → ...erations/_static/bias-cp-verify-table.png
diff --git a/...re/_static/dark-cp-verify-latiss-fail.png → ...ns/_static/dark-cp-verify-latiss-fail.png b/...re/_static/dark-cp-verify-latiss-fail.png → ...ns/_static/dark-cp-verify-latiss-fail.png
diff --git a/...re/_static/flat-cp-verify-latiss-fail.png → ...ns/_static/flat-cp-verify-latiss-fail.png b/...re/_static/flat-cp-verify-latiss-fail.png → ...ns/_static/flat-cp-verify-latiss-fail.png
diff --git a/...escope/_static/love-available-scripts.png → ...ations/_static/love-available-scripts.png b/...escope/_static/love-available-scripts.png → ...ations/_static/love-available-scripts.png
diff --git a/...ary-Telescope/_static/love-dome-mount.png → ...me-Operations/_static/love-dome-mount.png b/...ary-Telescope/_static/love-dome-mount.png → ...me-Operations/_static/love-dome-mount.png
diff --git a/...pe/_static/love-mtqueue-atqueue-panel.png → ...ns/_static/love-mtqueue-atqueue-panel.png b/...pe/_static/love-mtqueue-atqueue-panel.png → ...ns/_static/love-mtqueue-atqueue-panel.png
diff --git a/...lescope/_static/love_prepare_for_flat.png → ...rations/_static/love_prepare_for_flat.png b/...lescope/_static/love_prepare_for_flat.png → ...rations/_static/love_prepare_for_flat.png
diff --git a/...atiss-combined-calibrations-procedure.rst → ...atiss-combined-calibrations-procedure.rst b/...atiss-combined-calibrations-procedure.rst → ...atiss-combined-calibrations-procedure.rst
@@ -2,10 +2,10 @@
 .. If there are no contributors, write "none" between the asterisks. Do not remove the substitution.
 .. |contributors| replace:: *none*
 
-.. _LATISS-Combined-Calibrations-Procedure-LATISS-Combined-Calibrations-Generation-Procedure:
+.. _AuxTel-Daytime-Operations-LATISS-Combined-Calibrations-Generation-Procedure:
 
 #################################################
-Latiss Combined Calibrations Generation Procedure
+LATISS Combined Calibrations Generation Procedure
 #################################################
 
 .. _Latiss-Combined-Calibrations-Procedure-Overview:
@@ -15,7 +15,7 @@ Overview
 
 This page assumes the reader is familiar with the content explained in the Daytime Calibrations section: 
 
-- :ref:`Introduction to the combined calibrations generation procedure <Introduction-Combined-Calibrations-Generation-Procedure>` 
+- :ref:`Introduction to the combined calibrations generation procedure <Introduction-Combined-Calibrations-Generation-index>` 
 
 .. _Latiss-Combined-Calibrations-Procedure-Post-Conditions:
 
@@ -558,12 +558,6 @@ After checking the configuration options and the ``LOVE`` error messages, the fi
 ``{jobId}`` is returned by the OCPS and can be retrieved from the ``LOVE`` output messages.
 
 
-.. _Latiss-Combined-Calibrations-Procedure-Conditions-Contact-Personnel:
 
-Contact Personnel
-=================
 
 This procedure was last modified on |today|.
-
-This procedure was written by |author|.
-The following are contributors: |contributors|.
diff --git a/...repare-atcs-for-flat-fields-procedure.rst → ...repare-atcs-for-flat-fields-procedure.rst b/...repare-atcs-for-flat-fields-procedure.rst → ...repare-atcs-for-flat-fields-procedure.rst
@@ -2,11 +2,11 @@
 .. If there are no contributors, write "none" between the asterisks. Do not remove the substitution.
 .. |contributors| replace:: *none*
 
-.. _AT-Calibrations-Prepare-ATCS-For-Flat-Fields-Procedure:
+.. _AuxTel-Daytime-Operations-Prepare-ATCS-For-Flat-Fields:
 
-######################################
-Prepare ATCS For Flat Fields Procedure
-######################################
+############################
+Prepare ATCS For Flat Fields
+############################
 
 Overview
 ========
@@ -23,23 +23,20 @@ Be sure you have run previously the following procedure in the :ref:`daytime che
 
 
 
-.. figure:: ../_static/love-mtqueue-atqueue-panel.png
+.. figure:: ./_static/love-mtqueue-atqueue-panel.png
      :name:  latiss-atqueue
 
      LOVE interface with the "ATQueue" panel.
 
 
 
-.. figure:: ../_static/love-available-scripts.png
+.. figure:: ./_static/love-available-scripts.png
      :name:  latiss-available-scripts-atqueue
 
      LOVE interface with the **AVAILABLE SCRIPTS** list.
 
 
 
-
-
-
 Post-Condition
 ==============
 Telescope is ready to :ref:`take calibrations <LATISS-Combined-Calibrations-Procedure-LATISS-Combined-Calibrations-Generation-Procedure>`.
@@ -87,10 +84,5 @@ Make sure M3 is pointing to LATISS on nasmyth 2, mirror cover are is opened and
      LOVE interface showing telescope and dome position for flats.
 
 
-Contact Personnel
-=================
-
-This procedure was last modified on |today|.
 
-This procedure was written by |author|.
-The following are contributors: |contributors|.
+This procedure was last modified on |today|.