This tech note describes the implementation of the various Look-Up Tables (LUTs) for the Rubin Observatory Active Optics System (AOS). The subsystems involved are the M1M3, M2, the M2 hexapod, and the camera hexapod. This note is meant to be a guide for the subsystem software developers, and for the scientists who are updating the LUTs, both during commissioning and operations.
Links:
- Publication URL: https://sitcomtn-004.lsst.io
- Alternative editions: https://sitcomtn-004.lsst.io/v
- GitHub repository: https://github.com/lsst-sitcom/sitcomtn-004
- Build system: https://github.com/lsst-sitcom/sitcomtn-004/actions/
You can clone this repository and build the technote locally with Sphinx:
git clone https://github.com/lsst-sitcom/sitcomtn-004
cd sitcomtn-004
pip install -r requirements.txt
make htmlNote
In a Conda environment, pip install -r requirements.txt doesn't work as expected.
Instead, pip install the packages listed in requirements.txt individually.
The built technote is located at _build/html/index.html.
You can edit the index.rst file, which is a reStructuredText document.
The DM reStructuredText Style Guide is a good resource for how we write reStructuredText.
Remember that images and other types of assets should be stored in the _static/ directory of this repository.
See _static/README.rst for more information.
The published technote at https://sitcomtn-004.lsst.io will be automatically rebuilt whenever you push your changes to the master branch on GitHub.
This technote's metadata is maintained in metadata.yaml.
In this metadata you can edit the technote's title, authors, publication date, etc..
metadata.yaml is self-documenting with inline comments.
The bibliography files in lsstbib/ are copies from lsst-texmf.
You can update them to the current lsst-texmf versions with:
make refresh-bib
Add new bibliography items to the local.bib file in the root directory (and later add them to lsst-texmf).