ESS CS-Studio OPIs
This folder contains the validated and approved CS-Studio OPI files to be used at ESS to control the facility.
Structure
Here the structure of this folder:
ess-opis/
├── -common-
│ ├── devices
│ └── utilities
├── control-room
│ ├── -common-
│ ├── accelerator
│ ├── central-services
│ ├── machine-protection-system
│ ├── neutron-instruments
│ ├── personnel-safety-systems
│ └── target-station
└── engineering
├── -common-
├── accelerator
├── central-services
├── machine-protection-system
├── neutron-instruments
├── personnel-safety-systems
└── target-station
Each -common- folder should be used to contain OPIs common to that level. The folder has the following structure:
-common-/
├── devices
│ ├── beam-magnets-and-deflector
│ ├── control-system
│ ├── conventional-power
│ ├── cryogenics
│ ├── electromagnetic-resonator
│ ├── general-mechanics
│ ├── heating-cooling-and-air-conditioning
│ ├── intercepting-devices
│ ├── ion-source-specialties
│ ├── machine-protection-systems
│ ├── motion-control
│ ├── network-equipment
│ ├── neutron-chopper
│ ├── odh-detection-systems
│ ├── personnel-safety-systems
│ ├── power-convertors
│ ├── proton-beam-instrumentation
│ ├── rf-systems
│ ├── sample-environment-equipment
│ ├── sample-environment-systems
│ ├── timing-system
│ ├── vacuum
│ └── water-cooling
└── utilities
Here the structure for the remaining folders in control-room and engineering:
accelerator/
├── accelerator-to-target
├── drift-tube-linac
├── dumpline
├── front-end-building
├── high-beta-linac
├── high-energy-beam-transport
├── ion-source
├── low-energy-beam-transport
├── medium-beta-linac
├── medium-energy-beam-transport
├── radio-frequency-quadrupole
├── spoke-linac
├── stubs
├── test-stand-2
└── test-stand-3
central-services/
├── argon-gas-system
├── conventional-ventilation-system
├── conventional-waste-water-system
├── cooling-water-high-system
├── cooling-water-low-system
├── cooling-water-medium-system
├── cooling-water-system
├── cryo-systems
├── di-ionised-water-system
├── district-heating-low-system
├── electrical-power-system
├── heating-water-system
├── instrument-air-system
├── lab-gases-system
├── network-system
├── nitrogen-gas-system
├── non-potable-water-system
├── potable-water-system
├── process-ventilation-system
├── radiological-ventilation-system
├── radiological-waste-water-system
├── risk-waste-water-system
├── site-infrastructure
├── sprinkler-system
├── standpipe-system
├── storm-water-system
├── timing-system
└── vacuum-system
machine-protection-system/
├── common-machine-protection-functions
├── fast-beam-interlock-systems
└── local-protection-system
neutron-instruments/
├── instrument-1
└── nmx
personnel-safety-systems/
├── coldbox-building
├── ctl-gallery
├── helium-compressor-building
├── klystron-gallery
└── pss-accelerator
target-station/
├── active-cells
├── active-fluids
├── active-handling
├── active-workshops
├── handling-mock-up
├── intermediate-cooling-systems
├── mobile-active-vacuum
├── moderator-reflector
├── monolith
├── proton-beam-window
├── radioactive-gaseous-effluent-confinement
├── shielding
├── target-safety-system
├── target-systems
├── ts-storage
└── tune-up-dump
File and Folder Names
- File and folder names should be in accordance with the naming conventions as much as possible.
- Folder names must be all lowercase.
- No white spaces are allowed in file/folder names: use '-' instead.
Contributing the Repository
The repository can be cloned by everyone interested in. Changes can be performed only through Pull Requests.
Currently only Claudio Rosati (claudio.rosati@esss.se) and Bejamin Bertrand (for safety, as Infrastructure Group member, benjamin.bertrand@esss.se) are allowed to approve the pull requests, and merge them into the repository.
As soon as someone else will be appointed to be in charge of this repository, this readme file will be updated accordingly.
Deployment
The ess-opis repository is cloned and mounted in CS-Studio by the Ansible role
used to deploy CS-Studio.
Every time a push is done on the master branch, it triggers an Ansible job via
AWX API to update the git repository on the LCR workstations. Refer to the
.gitlab-ci.yml
file for the implementation.