SLS functional device naming convention
Syntax
-
[] indicates an optional field.
-
{} indicates a set of choices depending
on the system topology
-
Delimiter: The dash (-) (ASCII 45) was
chosen in order to avoid conflicts with software to be used for dealing
with name tables: Dot (.) and colon(:) would cause conflicts with EPICS,
slash(/) with MS-EXCEL, underscore (_) was found to be ugly, backslash
(\) inconvenient to type, others (,;^>=+) too unfamiliar.
-
No distinction between upper and lower
case characters is made.
-
The total maximum length of the Name
string is 23 characters incl. delimiters.
-
The prefix Building- is used for
PSI
Leitsystem
only. SLS EPICS control system device names are limited
to 18 characters and thus will use names without building prefix. Full
EPICS
channel name is name:property.characteristic
with a rigid limitation of 28 characters for name:property
Building (4 characters)
-
PSI Notation: SLS building will be WSLA.
Kingdom (1 character)
A |
Accelerators, Anlagen |
X |
Experiments |
I |
Infrastructure |
Note: Accelerators and experiments "speak" english
since they are operated by international staff, whereas the infrastructure
operated by local staff traditionally "speaks" german. (This document uses
italics for german words)
Domain (4 characters)
Domain is a functional region with slightly different structure
depending on the kingdom:
-
Accelerators are few and distributed. All systems {Linac, Ring, Booster,
etc.} share the same subsystems {magnets, vacuum, diagnostics etc.}. Thus
domain is a cell of a system matrix with the first pair of chars
identifying the accelerator {LI, RI, BO...} and the second
pair the technical subsystem {MA, VA, DI...}
-
Experiments are many, localized and largely independent from each other.
Thus domain is an identifier for the experiment. In case of SLS the experiment
identifier consists of two numbers for the sector, a character for the
source and another one to distinguish different experiments on the same
beamline, e.g. 04SA.
-
Infrastructure systems {Elektrizität, Kühlung, Wasser
(= electricity, cooling, water), etc.} are similar to accelerators since
they are distributed too, thus their domains follow the same scheme.
Domain identifiers are like in the accelerator kingdom with the first
pair of characters defining the system {EL, KU, WA...}
and the second pair defining the subsystem, e.g. for electricity (EL):
{ AG for allgemein (= general), TR
for Transformator (= transformer), NS for Niederspannung
(= low voltage) ...}.
However note that infrastructure domains do not have a matrix structure
like the accelerators but rather a tree structure: The systems do
not
share
same subsystems but define their own subsystems with the same subsystem
abbreviation having different meanings depending on the system, e.g. domain
BWTR
is Bewegung-Transport (= movements-transport),
ELTR
is
Elektrik-Transformator
(=electricity-transformer).
Device [- Component] (max.
12 characters including the dash), [ ] = optional
Since different systems have different topologies,
the 3rd and 4th field of the name string have different meanings as indicated
in the syntax definition above.
-
Tree topology: Device-component (Anlage-Aggregat)
Most infrastructure systems have tree topologies, so does the RF equipment.
Examples:
-
IKUPG-0100-M0012 resolves to: infrastructure, cooling,
primary circuit - unit 100 - motor 12
-
ARIRF-A3-FOC1 resolves to: accelerators, ring, RF - amplifier
3 - klystron focusing coil 1
-
Line topology: Group-number
Linear systems (linac, transferline) have elements of same type in
successive, numbered order. Example:
ALBMA-QB-2 resolves to: acc., linac to booster line,
magnets - quadrupole triplet B - No.2
-
Pool topology: Type-number
Pool topologies are formed by elements arranged in no particular order.
-
Circle topology: Family-member
In circle topologies (e.g. ring magnets or diagnostics) spatially distributed
groups of identical elements act coherently, and the member identifies
participating individuals. In case of a distributed family the member numbering
is conveniently used to indicate localization or neighborhood. Examples:
-
ARIMA-QLA-01: ring mangnets - first TBA quads family for
matching to long straight - sector 1
-
ABODI-BPM-1S: booster - BPMs - halfarc 1, cell S
-
Train topology: Container-device
Like a train these topologies (e.g. photon beamlines) consist of rather
different containers ("waggons"), richly filled with several devices. The
containers themselves are described by a system matrix like the accelerator
domains, with the first pair of characters identifying the container and
the second pair the technical subsystem. Example:
X04SA-OPMI-PM2TR3 resolves to: Experiment sector 4,
source in straight, line A - optics, mirrors - planar mirror 2, translation
motor 3
-
Solitaire topology: Device
In case of a single, well-known device the 4th optional field may be
omitted. Example:
ABOMA-YIN: The booster injection septum