1 The LSST Dome Seeing Monitor¶
The LSST Dome Seeing Monitor (DSM) is an instrument for measuring the seeing within an enclosed environment, such as a telescope dome.
2 Using the Monitor UI¶
The DSM laptop contains the software to run the monitoring user interface (UI). It is installed within a miniconda environment. To setup the environment for running the UI, perform the following from a terminal.
mc
conda activate dsm
The UI is configured via one of the files contained in the /dsm/dsm_ui_config directory. This directory is a clone of this GitHub repository and contains the standard configurations for the DSM. To run the default configuration of the UI, do the following from a terminal (after running the steps above.).
smm_ui -c /dsm/dsm_ui_config/default.yaml
2.1 Installing a New UI Version¶
Should it become necessary to install a new version of the UI, you must switch into the dsm service account by first doing the following.
sudo su -s /bin/bash dsm
Next, perform the steps to setup the environment and then run the following.
pip install -U spot_motion_monitor
If a new version is available, it will be installed.
3 Installing a Development Version¶
If it becomes necessary to install a development version of the UI, first create a directory called git in your home directory. Next, cd into that and execute the following.
git clone https://github.com/lsst-sitcom/spot_motion_monitor.git
If you intend to commit changes back to the repository and have the privileges to do so, clone the repository this way.
git clone git@github.com:lsst-sitcom/spot_motion_monitor.git
Next change into the directory of the clone and checkout the branch that you want to run. Example is shown below.
cd spot_motion_monitor
git checkout -t origin/tickets/SE-1302
Once on the correct branch, perform the following steps to run the UI.
mc
conda activate dsm_dev
python setup.py build_ui
rsmm python scripts/run.py
The rsmm wrapper sets up the environment to correctly execute the program. The CLI options from smm_ui are all available in this mode. The third step is only necessary when changing branches. The last step is necessary on subsequent executions of the UI.