KAGRA VIS Operations Manual - Guardian
Link to the aLigo Guardian Introduction:
Guardian System-Level Installation
/kagra/apps/guardian/bin has shell scripts guardctrl etc.
/kagra/apps/guardian/bin/guardian ends up running guardian in /kagra/apps/guardian/lib/python2.7/site-packages/guardian.
The main Python scripts for the VIS Guardians, including Type B, live in /opt/rtcds/userapps/release/vis/k1/guardian. TYPEB.py is the main file - VIS_BS.py, VIS_SR2.py, VIS_SR3.py and VIS_SRM.py are one-line programs which simply load it. (They could also point to test versions of TYPEB.py, e.g., TYPE_MB.py.)
TYPEB.py adds /opt/rtcds/userapps/release/vis/k1/scripts/ to the path, making available support packages including burt.py, vistools.py etc.
The Guardian makes use of various snapshot files in directories as follows. These are modified by commands in the Take/Restore Snapshot pop-up menu on the VIS_CUST_TYPEB_OVERVIEW.adl screen. The examples below are for BS, but apply equally to other Type B with obvious substitutions (BS->SR2/SR3/SRM and bs->sr2/sr3/srm). When a model is run, the system looks for safe.snap files in
/opt/rtcds/kamioka/k1/target/k1visbst/k1visbstepics/burt # for the top model
/opt/rtcds/kamioka/k1/target/k1visbsp/k1visbspepics/burt # for the payload model
These are symbolic links to the following files in the SVN-controlled userapps area:
/opt/rtcds/userapps/release/vis/k1/burtfiles/k1visbst_safe.snap # for the top model
/opt/rtcds/userapps/release/vis/k1/burtfiles/k1visbsp_safe.snap # for the payload model
The Take Payload Model Safe Snapshot and Take Top Model Safe Snapshot menu items create these snapshots using the request files automatically generated when the models are compiled:
/opt/rtcds/kamioka/k1/target/k1visbst/k1visbstepics/autoBurt.req # for the top model
/opt/rtcds/kamioka/k1/target/k1visbsp/k1visbspepics/autoBurt.req # for the payload model
The Restore Safe Snapshots menu item restores both of the above .snap files at once.
The system for making Guardian-related snaps is now divided into three sections, for IP, GAS and ALIGN/MISALIGN.
The IP setpoint is managed with the menu items Take IP Setpoints Snapshot and Restore IP Setpoints Snapshot, which use the files
/opt/rtcds/userapps/release/vis/k1/burtfiles/k1visbst_IP.req # note "t" for the top model
The GAS setpoints are managed with the menu items Take GAS Setpoints Snapshot and Restore GAS Setpoints Snapshot, which use the files
/opt/rtcds/userapps/release/vis/k1/burtfiles/k1visbst_GAS.req # note "t" for the top model
The ALIGN setpoints are managed with the menu items Take Align Setpoints Snapshot and Restore Align Setpoints Snapshot, which use the files
/opt/rtcds/userapps/release/vis/k1/burtfiles/k1visbsp_align.req # note "p" for the payload model
The MISALIGN setpoints are managed with the menu items Take Misalign Setpoints Snapshot and Restore Misalign Setpoints Snapshot, which use the files
/opt/rtcds/userapps/release/vis/k1/burtfiles/k1visbsp_align.req # note "p" for the payload model, and plain "align" - this is the same file as above.