Updates to website based on users manual 2.0

docs/source/users-manual/about.md

@@ -0,0 +1,47 @@
+# About This Manual
+
+## Purpose
+
+This document is intended to serve the needs of all users of NGPS including astronomers and observatory support staff.
+
+## Scope
+
+This document contains practical information related to the operation, maintenance, and troubleshooting of NGPS.
+
+## Reference Documents
+
+1. [NGPS Technical Specifications](https://caltech.sharepoint.com/:w:/r/sites/coo/ngps/Shared%20Documents/NGPS%20-%20Systems%20Engineering%20%5BL2%5D/NGPS%20-%20User%27s%20Manual%20and%20Spec%20Sheet/NGPS%20Technical%20Specifications.docx?d=wf25246f6f4fe44ffb063d15639b0c222&csf=1&web=1&e=UcVdNO) (NGPS.SYS.TEC.005)
+2. [NGPS Spare Parts List.xlsx](https://caltech.sharepoint.com/sites/coo/ngps/Shared%20Documents/NGPS%20-%20Systems%20Engineering%20%5BL2%5D/NGPS%20Spare%20Parts%20List.xlsx?web=1) (NGPS.SYS.TEC.003)
+
+## Change Record
+
+| Revision | Date | Section | Modifications |
+| --- | --- | --- | --- |
+| Ver 01 | 5/7/2026 | All | NGPS Development Team, initial draft shared at Operations Handover Review |
+| Ver 02, SP Ver (300.0) | 7/31/2026 | All | Released in response to OHR reviewers report actions |
+
+## Abbreviations, Definitions and Nomenclature
+
+### Acronyms
+
+| Acronym | Meaning |
+| --- | --- |
+| AO | Adaptive Optics |
+| COO | Caltech Optical Observatories |
+| DRP | Data Reduction Pipeline |
+| ETC | Exposure Time Calculator |
+| FITS | Flexible Image Transport System |
+| FOV | Field of View |
+| GUI | Graphical User Interface |
+| ICS | Instrument Control Software |
+| NGPS | Next Generation Palomar Spectrograph |
+| OTM | Observation Timeline Modeler |
+| POMO | Palomar Observatory Mountain Operation |
+| RD | Reference Document of any kind, typically cited outside of requirements text |
+| SNR | Signal to Noise Ratio |
+| TCS | Telescope Control System |
+| TLE | Target List Editor |
+
+## NGPS Overview
+
+Next Generation Palomar Spectrograph (NGPS) is conceived to be a radically more efficient workhorse spectrograph, replacing the 1970s-era Double Spectrograph (DBSP). NGPS achieves these gains via 1) increased optical efficiency from superior design and grating components, 2) a novel focal plane slicer unit that captures most traditional slit losses, 3) increased operational efficiency due to broad spectral coverage with fixed grating format and a minimal set of user-selectable settings, and 4) improved scheduling and observing tools, and feedback.

docs/source/users-manual/acquisition-calibration-hardware.md

@@ -1,12 +1,12 @@
-# Acquisition, Calibration, and Slice Viewing Hardware
+# Acquisition and Calibration Hardware
 
 ## Acquisition and Guidance System
 
-The acquisition and guidance system is an imager (offset approximately 8’) from the spectrograph optical axis. It has its own enclosure with a dedicated hatch (currently broken). A fold mirror redirects the light horizontally through a field lens and, subsequently, a fixed focusing lens. In the backfocal space between the lens and camera is a filter wheel with 6 positions. These are populated with 50 mm diameter filters: (g’, r’, I, blocking, clear, and empty). The clear filter is an AR coated piece of glass that maintains the same focus as the color filters.
+The acquisition and guidance system is an imager (offset approximately 8') from the spectrograph optical axis. It has its own enclosure with a dedicated hatch (currently broken). A fold mirror redirects the light horizontally through a field lens and, subsequently, a fixed focusing lens. In the backfocal space between the lens and camera is a filter wheel with 6 positions. These are populated with 50 mm diameter filters: (g', r', I, blocking, clear, and empty). The clear filter is an AR coated piece of glass that maintains the same focus as the color filters.
 
 The camera was shimmed in lab to be confocal with the image slicer. There is no focus adjustment on this camera.
 
-Both the filter wheel and the hatch are custom mechanisms, but both are driven by PI C-663.12 controllers. The hatch has an ST2818M0704-G2 stepper motor and JK8002C hall effect limit switches. The filter wheel also uses an ST2818M0704-G2 stepper motor and a JK8002C hall effect home switch. The A&G electronics are further detailed in the Electronic control instructions for NGPS A&G system document.
+Both the filter wheel and the hatch are custom mechanisms, but both are driven by PI C-663.12 controllers. The hatch has an ST2818M0704-G2 stepper motor and JK8002C hall effect limit switches. The filter wheel also uses an ST2818M0704-G2 stepper motor and a JK8002C hall effect home switch. The A&G electronics are further detailed in the [Electronic control instructions for NGPS A&G system document](https://caltech.sharepoint.com/:w:/r/sites/coo/ngps/Shared%20Documents/NGPS%20-%20Subsystems%20%5BL3%5D/A%26G%20System%20%5BAGS%5D/A%26G%20System%20-%20TECs/Electronic%20control%20instructions%20for%20NGPS%20A%26G%20system.docx?d=we90f09516f6d4099871aebd1cc87ab70&csf=1&web=1&e=iP5UMi).
 
 There are two cover panels on top of the A&G system. One of the panels has the hatch attached to it and there are wires installed on the underside. While this panel can be unbolted and lifted, care needs to be exercised when doing so to avoid accidentally stretching the conductors. There is no internal disconnect to completely free this panel. The other panel, that immediately above the camera and filter wheel, can be easily removed.
 
@@ -18,105 +18,87 @@ The A&G system is served by the acam daemon and the ACAM GUI.
 
 The calibration unit provides the light sources and means to illuminate the NGPS slicer with light needed for spectral and flat-field calibration. The optics are designed to mimic the Hale Telescope f/16 focal ratio.
 
-```{figure} assets/page_052_image_01.png
-:alt: NGPS manual figure
-:width: 90%
-
-```
-
 The calibration system is composed of two sections.
 
-The first is a reimaging unit that is mounted on the NGPS slicer assembly. That contains an entrance aperture equipped with a light-blocking door, reimaging optics and diffuser. This section also includes the actuated instrument cover. The terms ‘door’ and ‘cover’ here are deliberate, and explicitly identify the actuator in the instrument control software. We recommend the instrument cover be closed whenever the instrument is not in use. Both axes are driven by PI L-220.50DG high-resolution linear actuators commanded by PI C-863.12 controllers.
-
-Figure 14: Alos Blort.
+The first is a reimaging unit that is mounted on the NGPS slicer assembly. That contains an entrance aperture equipped with a light-blocking **door**, reimaging optics and diffuser. This section also includes the actuated instrument **cover**. The terms "**door**" and "**cover**" here are deliberate, and explicitly identify the actuator in the instrument control software. We recommend the instrument cover be closed whenever the instrument is not in use. Both axes are driven by PI L-220.50DG high-resolution linear actuators commanded by PI C-863.12 controllers.
 
-The second is the calibration shelf in the electronics cabinet. This contains the light sources, their power supplies, and shutters.
-
-INCLUDE (ROUGHLY) LABELED PHOTO OF CALIBRATION UNIT SHELF Figure XX
-
-The two components are connected by an optical fiber harness (an octopus). Each lamp has a single multimode fiber attached to it. The continuum lamp paths then travel through adjustable fiber attenuators. The parallel paths then continue to a MIXING DEVICE, and terminate at the calibration box near the focal plane.
-
-INCLUDE DIAGRAM OF CAL LIGHT PATH Figure XX
-
-```{figure} assets/page_053_image_01.png
+```{figure} assets/acquisition-calibration-hardware-01.jpg
 :alt: NGPS manual figure
 :width: 90%
-
 ```
 
+The second is the calibration shelf in the electronics cabinet. This contains the light sources, their power supplies, and shutters.
+
+The two components are connected by an optical fiber harness (an octopus). Each lamp has a single multimode fiber attached to it. The continuum lamp paths then travel through adjustable fiber attenuators. The parallel paths then continue to a homogenizing rod and terminate at the calibration box near the focal plane.
+
 Note that the instrument hatch is actually part of the calibration enclosure and is controlled by the calibd software daemon.
 
-The calibration system is served by the calibd daemon
+The calibration system is served by the calibd daemon.
 
 ### Spectral Calibration Sources
 
-NGPS uses thorium argon (ThAr) and iron argon (FeAr) hollow cathode arc lamps. Each is in its own enclosure and is powered a dedicated Photron P209-USB power supply.
+NGPS uses thorium argon (ThAr) and iron argon (FeAr) hollow cathode arc lamps. Each is in its own enclosure and is powered by a dedicated Photron P209-USB power supply.
 
-The current (Apr 2026) ThAr lamp is a: Green Scientific G858A hollow cathode lamp The current (Apr 2026) FeAr lamp is a: Photron P826A hollow cathode lamp
+The current (Apr 2026) ThAr lamp is a Green Scientific G858A hollow cathode lamp. The current (Apr 2026) FeAr lamp is a Photron P826A hollow cathode lamp.
 
 Notes:
 
-It is enough to turn the power on to the two lamps for them to turn on. There are rocker switches on the photron supplies if power needs to be cut locally.
+It is enough to turn the power on to the two lamps for them to turn on. There are rocker switches on the Photron supplies if power needs to be cut locally.
 
-Lifetime of the lamps varies a bit and depends on the implementation, usage details, etc. We anticipate a lifetime of about 2 years. The lamp enclosures are designed to be serviceable with the removal of just one of the four electronics cabinet covers (cover X-X)
+Lifetime of the lamps varies a bit and depends on the implementation, usage details, etc. We anticipate a lifetime of about 2 years. The lamp enclosures are designed to be serviceable with the removal of just one of the four electronics cabinet covers.
 
 ThAr lamps (as of this writing, Apr 2026) are somewhat difficult to source.
 
-INCLUDE A ZOOM ON THE TWO LAMP BOXES INCLUDE PHOTO OF A BULB Figure XX
-
 ### Flatfield Calibration Sources
 
-NGPS has two continuum sources. A tungsten-halogen lamp (Red lamp) from Thorlabs (model #SLS301) and Enegetiq Laser Line Source (Blue lamp, model #EQ-99X LDLS). Each lamp has beam splitter optics at the front that separate the light path to a direct and sent part of the light through an etalon. The etalon produces a periodic spectrum, whereas the direct path is a clean continuum. The two paths each have an independent shutter.
+NGPS has two continuum sources. A tungsten-halogen lamp (Red lamp) from Thorlabs (model #SLS301) and Energetiq Laser Line Source (Blue lamp, model #EQ-99X LDLS). Each lamp has beam splitter optics at the front that separate the light path, sending part of the light directly and part through an etalon. The etalon produces a periodic spectrum, whereas the direct path is a clean continuum. The two paths each have an independent shutter.
 
-The lamps also have dDichroic beam splitters for their spectra to interleave.
+The lamps also have dichroic beam splitters for their spectra to interleave.
 
 We have also implemented, but do not currently use, optical paths for the continuum lamp light to pass through etalons generating periodic spectra. The intent was to use these spectra for concurrent calibration (light injected via optics-coupled fibers at the edges of the slit and slices). The functionality is available, and we may implement this in the future.
 
 Notes:
 
 The Red continuum lamp turns on when the appropriate outlet in the NPS is powered. There is a rocker switch on its enclosure to cut power locally.
 
-The blue continuum lamp needs an interlock to turn on. There is a control box with NGPS equipment in the instrument bay. We have implemented, but not yet deployed computer control of this lamp. More information can be found here.
+The blue continuum lamp needs an interlock to turn on. There is a control box with NGPS equipment in the instrument bay. We have implemented, but not yet deployed, computer control of this lamp. More information can be found [here](https://caltech.sharepoint.com/:w:/r/sites/coo/ngps/Shared%20Documents/NGPS%20-%20Subsystems%20%5BL3%5D/Electronics%20Rack%20%5BEL%5D/Electronics%20Rack%20-%20TECs/Calibration%20Lamps/Blue%20Continuum%20Remote%20Control.docx?d=w422074f72fd14c4a98ba98440f8a990f&csf=1&web=1&e=Nf5Odd).
 
-Unfortunately, the calibration system optical throughput is very low at wavelengths shorter than about 350 nm (due to mirror coatings and multiple reflections, most likely), so the utility of the Blue lamp is limited. As of Apr 2026, we have procured some bright UV LEDs and will attempt to construct a pseudo- continuum source to overcome the reduced throughput. This work is ongoing.
+Unfortunately, the calibration system optical throughput is very low at wavelengths shorter than about 350 nm (due to mirror coatings and multiple reflections, most likely), so the utility of the Blue lamp is limited. As of Apr 2026, we have procured some bright UV LEDs and will attempt to construct a pseudo-continuum source to overcome the reduced throughput. This work is ongoing.
 
 The short-pass filter installed in the Blue lamp has some leak that can be seen in the R and I channel data.
 
-Blue Lamp images To Be Added Figure XX
-
-Red Lamp images To Be Added Figure XX
-
-Blue Lamp leak images To Be Added Figure XX
-
 ### Calibration Shutters (AKA Modulators)
 
-There are 6 modulators installed in the calibration system, one per lamp. The assignment is shown in the table below. These can function as bona-fide shutters, or to limit the lamp duty cycle mechanically. These modulators are Takano BOS10-15 bi-stable rotary optical shutters and are controlled by an Arduino Teensy 4.1. The arduino embedded code (NGPS_Mods_V006_quiet.ino) can be found here (in SharePoint > NGPS - Subsystems [L3] > Electronics Rack [EL] > Electronics Rack -TECs > Calibration Lamps > Modulators ).
+There are 6 modulators installed in the calibration system, one per lamp. The assignment is shown in the table below. These can function as bona-fide shutters, or to limit the lamp duty cycle mechanically. These modulators are Takano BOS10-15 bi-stable rotary optical shutters and are controlled by an Arduino Teensy 4.1. The arduino embedded code (NGPS_Mods_V006_quiet.ino) can be found [here](https://caltech.sharepoint.com/:f:/r/sites/coo/ngps/Shared%20Documents/NGPS%20-%20Subsystems%20%5BL3%5D/Electronics%20Rack%20%5BEL%5D/Electronics%20Rack%20-%20TECs/Calibration%20Lamps/Modulators?csf=1&web=1&e=27YsZC) (in SharePoint > NGPS - Subsystems [L3] > Electronics Rack [EL] > Electronics Rack -TECs > Calibration Lamps > Modulators).
 
 Notes:
 
 The modulators are very sensitive to the mounting torque of the screws that hold them in place. Best to have these operating as you install, if possible.
 
-One of the modulators (#2, for blue continuum etalon). is sticky; it is rarely, if ever, used.
+One of the modulators (#2, for blue continuum etalon) is sticky; it is rarely, if ever, used.
 
-Modulator # Lamp
+| Modulator # | Lamp |
+|---|---|
+| 1 | FeAr |
+| 2 | Blue Continuum Etalon (flaky) |
+| 3 | Red Continuum Etalon |
+| 4 | Red Continuum Direct |
+| 5 | Blue Continuum |
+| 6 | ThAr |
 
-### Taking a calibration image
+### Taking a Calibration Image by Hand
 
 Users should not need to do this, but it is included here for engineering purposes:
 
-1) Ensure shutter is enabled in camerad and appropriate exposure time is set
-
-2) Close the instrument cover
-
-3) Open the calibration door
-
-4) Open the modulator for the appropriate lamp
-
-5) Turn on the appropriate lamp
+1. Ensure shutter is enabled in camerad and appropriate exposure time is set
+2. Close the instrument cover
+3. Open the calibration door
+4. Open the modulator for the appropriate lamp
+5. Turn on the appropriate lamp
 
 ## Slice Viewing System
 
-There are two Andor iXon Ultra 888 EMCCD cameras that pick off the telescope field. The cameras have FOVs of approximately 60” x 30” and plate scale of XX. The fields are adjacent to the outer two slices and, as such, shift as the slit width is adjusted.
+There are two Andor iXon Ultra 888 EMCCD cameras that pick off the telescope field. The cameras each have FOVs of approximately 21" x 50" and plate scale of 0.060"/pixel. The fields are adjacent to the outer two slices and, as such, shift as the slit width is adjusted.
 
 The cameras are controlled via the SLICEVIEW GUI. The GUI is intended primarily for field alignment and some field recognition.