Add MainTel and Observatory Control System. Restructure

lsst-ts · Apr 16, 2024 · 7016aa2 · 7016aa2
1 parent 92e7192
commit 7016aa2
Show file tree

Hide file tree

Showing 178 changed files with 1,320 additions and 960 deletions.
diff --git a/AuxTel/AuxTel-Components/ATCS-Component.rst b/AuxTel/AuxTel-Components/ATCS-Component.rst
@@ -0,0 +1,6 @@
+.. _AuxTel-Components-ATCS:
+
+####
+ATCS
+####
+
diff --git a/AuxTel/AuxTel-Components/ATCalSys-Component.rst b/AuxTel/AuxTel-Components/ATCalSys-Component.rst
@@ -0,0 +1,6 @@
+.. _AuxTel-Components-ATCalSys:
+
+######################
+AT Calibrations System
+######################
+
diff --git a/AuxTel/AuxTel-Components/LATISS-Component.rst b/AuxTel/AuxTel-Components/LATISS-Component.rst
@@ -0,0 +1,6 @@
+.. _AuxTel-Components-LATISS:
+
+##########################
+LATISS
+##########################
+
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/...dard-Operations/AuxTel-LOTO-procedure.rst → ...dard-Procedures/AuxTel-LOTO-procedure.rst b/...dard-Operations/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/AuxTel/_static/AT-control-cabinet.png → ...Procedures/_static/AT-control-cabinet.png b/AuxTel/_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/AuxTel/_static/eui-estop-display.png → ...-Procedures/_static/eui-estop-display.png b/AuxTel/_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,34 @@
+.. _AuxTel-AuxTel-Non-standard-Operations:
+
+##############################
+AuxTel Non-standard Operations
+##############################
+
+
+.. toctree::
+    :maxdepth: 3
+    :titlesonly:
+    :glob:
+
+    ATCS-Non-standard-Procedures/ATCS-Non-standard-Procedures-index.rst
+
+and then LATISS
+
+.. toctree::
+    :maxdepth: 3
+    :titlesonly:
+    :glob:
+
+    LATISS-Non-standard-Procedures/LATISS-Non-standard-Procedures-index.rst
+
+
+and the AT Calibration System
+
+.. 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,12 @@
+.. _AuxTel-Non-standard-Operations-LATISS-Non-Standard-Procedures:
+
+##############################
+LATISS Non-standard procedures
+##############################
+
+.. toctree::
+    :maxdepth: 3
+    :titlesonly:
+    :glob:
+
+    *
diff --git a/AuxTel/AuxTel-Standard-Operations/AT-Calibrations/enable-latiss-procedure.rst b/AuxTel/AuxTel-Standard-Operations/AT-Calibrations/enable-latiss-procedure.rst
diff --git a/AuxTel/AuxTel-Standard-Operations/AT-Calibrations/index.rst b/AuxTel/AuxTel-Standard-Operations/AT-Calibrations/index.rst
diff --git a/AuxTel/AuxTel-Standard-Operations/AT-On-Sky/index.rst b/AuxTel/AuxTel-Standard-Operations/AT-On-Sky/index.rst
diff --git a/AuxTel/AuxTel-Standard-Operations/AT-Pre/index.rst b/AuxTel/AuxTel-Standard-Operations/AT-Pre/index.rst
diff --git a/AuxTel/AuxTel-Standard-Operations/AT-Shutdown/index.rst b/AuxTel/AuxTel-Standard-Operations/AT-Shutdown/index.rst
diff --git a/AuxTel/AuxTel-Standard-Operations/AT-Venting/index.rst b/AuxTel/AuxTel-Standard-Operations/AT-Venting/index.rst
diff --git a/...rations/AuxTel-E-Stop-Procedure/index.rst → ...tions/AuxTel-Daytime-Operations-index.rst b/...rations/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/...erations/Daytime-Checkout-SAL-Scripts.rst → ...l-Daytime-Operations/Daytime-Checkout.rst b/...erations/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/...perations/AT-Venting/Prepare-for-Vent.rst → ...l-Daytime-Operations/Prepare-for-Vent.rst b/...perations/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,9 +137,4 @@ Procedure Steps
      LOVE displaying AuxTel telescope and dome venting. 
 
 
-.. _Prepare-for-vent-Contact-Personnel:
-
-Contact Personnel
-^^^^^^^^^^^^^^^^^
-
 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/AuxTel/_static/love-available-scripts.png → ...ations/_static/love-available-scripts.png b/AuxTel/_static/love-available-scripts.png → ...ations/_static/love-available-scripts.png
diff --git a/AuxTel/_static/love-dome-mount.png → ...me-Operations/_static/love-dome-mount.png b/AuxTel/_static/love-dome-mount.png → ...me-Operations/_static/love-dome-mount.png
diff --git a/...el/_static/love-mtqueue-atqueue-panel.png → ...ns/_static/love-mtqueue-atqueue-panel.png b/...el/_static/love-mtqueue-atqueue-panel.png → ...ns/_static/love-mtqueue-atqueue-panel.png
diff --git a/AuxTel/_static/love_prepare_for_flat.png → ...rations/_static/love_prepare_for_flat.png b/AuxTel/_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:
@@ -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|.