1. Managing Parameters
Karin Rathsman

2. Parameter Management
Enforce groups as well as individuals to work towards the same solution
Provide tools to identify inconsistencies
Make it useful and easy to access

3. Table
Date
Status
Table owner
High Level Parameters
18-Apr-11
Active
CCB
Lattice and Accelerator Science
14-Nov-11
H. Danared
Ion Source
16-Dec-10
L. Celona
Low Energy Beam Transport
Radio Frequency Quadrupole
15-Dec-10
B. Pottin
Medium Energy Beam Transport
19-May-11
I. Bustinduy
Drift Tube Linac
A. Pisent
Spoke resonators
S. Bousson
Elliptical cavity linac, Low beta
G. Devanz
Elliptical cavity linac, High beta
High Energy Beam Transport
S. Pape-Møller
Target
22-Nov-10
S. Peggs
Infrastructure Services
J. Eguia
RF Systems
R. Ruber
LLRF
R. Zeng
RF Sources, High beta
Draft
D. McGinnis
Cryomodules, High beta
W. Hees
Cryomodules, Low beta
Cryomodules, Spoke
Cryomodules, Utility module
21-Oct-11
Beam instrumentation
29-Nov-11
A. Jansson

4. LATTICE & ACCELERATOR SCIENCE (H. Danared)
Parameter
Unit
Value
Status
Date
Validator
Comment
Ion source output energy
MeV
0.075
Active
23-Oct-10 TB
RFQ output energy 3
DTL output energy 50
Spoke resonator output energy
188
15-Jun-11
Tech Note ESS/AD/0015
Elliptical low beta output energy
606
Elliptical high beta output energy
2500
Proton kinetic energy on target
Ion source length m
2.5
15-Dec-10
LEBT length
1.6
RFQ length
4.0
MEBT length
DTL length
19.0
Spoke resonator section length
58.0
Elliptical low beta section length
108.0
Elliptical high beta section length
196.0
HEBT length, to first vertical bend
100.0
Length, source-to-first vertical bend
491.6
Depth of linac below ground level 10
Tech Note ESS/AD/0003
Number of accelerating gaps per spoke cavity
Double spoke resonator
Number of cells per low beta cavity 5
Number of cells per high beta cavity
Spoke resonator cavities per cryomodule 2
Low beta elliptical cavities per cryomodule 4
High beta elliptical cavities per cryomodule 8
Geometric beta, spoke resonators
0.57
Geometric beta, low beta elliptical cavities
0.70
Geometric beta, high beta elliptical cavities
0.90
Operational gradient, spoke resonators
MV/m

5. LATTICE & ACCELERATOR SCIENCE (H. Danared)
Parameter
Unit
Value
Status
Date
Validator
Comment
Number of cells per high beta cavity 5
Active
23-Oct-10 TB
Spoke resonator cavities per cryomodule 2
15-Jun-11
Tech Note ESS/AD/0015
Low beta elliptical cavities per cryomodule 4
High beta elliptical cavities per cryomodule 8
Geometric beta, spoke resonators
0.57
Geometric beta, low beta elliptical cavities
0.70
Geometric beta, high beta elliptical cavities
0.90
Operational gradient, spoke resonators
MV/m
Operational gradient, low beta elliptical cavities
15.44
Operational gradient, high beta elliptical cavities
18.17
Elliptical power coupler power, to beam MW
0.9
Number of modules in high beta section
Draft
Cavities per high beta cryomodule
Quadrupoles per high beta cryomodule
Number of modules in low beta section
Cavities per low beta cryomodule
Quadrupoles per low beta cryomodule
Number of modules in spoke section 15
M. Eshraqi
Cavities per spoke cryomodule 3
Quadrupoles per spoke cryomodule
1 / 0
1 if non segmented, 0 if segmented

6. Parameter Database and Web Interface Tools
Why not the present simple solution?
Easy for you but time consuming (and boring) for me as administrator.
Expect the number of parameter to increase.
Minimize sources of errors.

7. The Database Structure
Manager Id
Name
Team Id
Parent_Id
Name
Manager_Id
Attribute Id
Name
Data
Team_ID
System_ID
Attribute_ID
Parameter_ID
Validator_ID
Value
Status
Date_modified
Comment
Unit Id
Name
System Id
Parent_id
Name
Validator Id
Name
Reference Id
Title
Author
Publication
URL
Parameter Id
Name
Unit_id
Definition
Date_modified
Reference_id

8. Team or role, or view, or category…
Natural to categorize parameters by teams, since the parameter list is a communication tool.
Replaces the current tables names.
Each team has a parameter manager (owner), with privileges to administrate parameters in the database.
One person can be manager over several teams.
Hierarchal structure

9. ID
Parameter Team
Parameter Manager
CCB (High Level Parameters) ? 1
Accelerator TB
1.1
Beam Physics (Lattice and Accelerator Science)
H. Danared
1.2
Front End
S. Gammino
1.2.1
Ion Source
L. Celona
1.2.2
Low Energy Beam Transport
1.2.3
Radio Frequency Quadrupole
B. Pottin
1.2.4
Medium Energy Beam Transport
I. Bustinduy
1.2.5
Drift Tube Linac
A. Pisent
1.3
Spoke resonators
S. Bousson
1.4
Elliptical cavity linac
G. Devanz
1.5
High Energy Beam Transport
S. Pape-Møller
1.5.1
Target window (Target)
S. Peggs
Infrastructure Services
P. Rådahl
1.6
RF Systems
D. McGinnis
1.6.2
LLRF
R. Zeng
1.7
Cryomodules
W. Hees
1.8
Beam instrumentation
A. Jansson

10. System LINAC TUNNEL TARGET INSTRUMENTS RF GALLERY CRYOPLANT Source RFQ
DTL
Spokes
HEBT
LEBT
MEBT
Low β
High β
Buncher
(LEBT)
Low power
352 MHz
Low power 704 MHz
Medium power 704 MHZ
High power 704 MHZ
Coldbox
Compressors …
He tanks
Transfer line
LINAC TUNNEL
INSTRUMENTS
High power

11. Example

12. Attribute
Default is nominal but can also be approximate, maximum, minimum, precision, accuracy...
Optional
Used for example by the planned Parameter Book. (application)

13. Example Parameter Value Unit Publisher Beam Current 50 mA General
Beam Current Precision 1 %
Ion Source
Beam Current Accuracy
Beam Current Ripple
Beam Current Pulse Length
2.86 mS
Beam Current Pulse Length Precision
ppm
Chopper
Beam Current Pulse length accuracy
Repetition Rate 14 Hz
Cavity Gradient Amplitude regulation
0.5
Beam Physics
Cavity Gradient Phase regulation
degrees
Allowed AC Grid Load Variation (Flicker)
Energy

14. Example Parameter Minimum Nominal Maximum Units RF Frequency 704.42
MHz
Peak Output Power
1.0
1.2
1.5 MW
RF Pulse length
3.3 ms
Pulse repetition rate 14 Hz
DC to RF efficiency 65 %
Perveance
0.55
μPerv
Beam Voltage
102
113 kV
Beam current 18 21 A
RF Power Gain 48 dB
Bandwidth (-1 dB) 4
Cathode lifetime
100000 h
VSWR Tolerance
1.2:1

15. Parameter
The Parameter table accounts for the definition of parameters and unit.
The level of unit control needs to be defined. To the lowest level it will be enforced that all parameters with identical name shall also have the same unit.

16. Data
The primary key of the Data table is a tuple of System, Attribute and Parameter.
Each record in the Data table will therefore be uniquely identified through this relation.
A parameter name can apply to several systems of the facility.

17. Validation As before in boards (CCB, Technical board)
Default validator is parent team
Can however be someone else, for example for “interfaces” (target window, power coupler, etc.) between different groups.

18. Web Interface Tools
Java based web interface tools. (Versatile, self-explanatory and efficient).
A certain amount of control needs to be established, for example, for units and user privileges.
This should be kept to a minimum.
Example: Editor, tools to keep track of dependencies, Queries, Parameter Book.