TODAC - User's Guide - Optics
Command Line Interface
todac optics <path> <start_run> [<end_run>] [-type <type>] [-h]
Argument |
Required |
Default value |
Description |
<path> |
Yes |
|
Path to an CSV file in a proper format (see below for allowed formats of optics CSVs) |
<start_run> |
Yes |
|
Beginning TOTEM Run number |
<end_run> |
No |
<start_run> |
Ending TOTEM Run number |
-type <type> |
Yes |
all (see details in examples below) |
Type of optics stored in files specified in <path> <type> must be one of the following: betastar, strength, currents, all
|
-h |
No |
|
Prints help |
Additional information
There is a small issue about timestamps when populating database with optics data.
When you insert currents or magnet strength data you have to specify
start_run
and
end_run
to fetch their timestamps from database and then to use them.
However, behaviour is different when dealing with beta star data. Beta star files already provide information about timestamp, so there is no need to use
start_run
or
end_run
parameters. So despite you have to specify
start_run
argument, it will not be used when dealing with beta star measurements.
Examples
Show help:
todac optics -h
Inserting by type
Insert different types of optics data for specified run span:
todac optics -type strength optics/8333_8341/magnet_strength.csv 8333 8341
todac optics -type currents 8367_8372/currents.csv 8367 8372
Insert data for a single run:
todac optics -type currents optics/fill_2814/currents2814.csv 8318
Inserting all types at once
It's possible to insert all types of optics data at once. To do so, you needn't to specify
-type
option - it is set to
all
by default.
What is the most important,
<path>
is expected then to be a path to the directory containing 3 files which names are exactly
beta.csv,
currents.csv,
strength.csv.
todac optics optics/8333_8341/ 8333 8341
where:
|-- optics/8333_8341
|-- beta.csv
|-- currents.csv
|-- strength.csv
|...
Note: It is advised
not to use
-type=all
option if not necessary.
Web Interface
Browse
Argument |
Required |
Default value |
Description |
Optics type |
Yes |
Beta star |
Type of optics |
Run number |
Yes |
|
TOTEM Run number |
Version |
No |
Latest |
Data version |
Populate
Argument |
Required |
Default value |
Description |
Optics type |
Yes |
Beta star |
Type of optics |
Start run |
Depends on optics type |
|
Beginning TOTEM Run number |
End run |
No |
Start run |
Ending TOTEM Run number |
File |
Yes |
|
File to upload |
Supported file formats
Beta Star
CSV's line format:
start_timestamp,end_timestamp,value
Column name |
Value type |
Example value |
start_timestamp |
Timestamp (long value) |
1341650556 |
end_timestamp |
Timestamp (long value) |
1341655484 |
value |
Double |
90.0 |
Example
1341650556,1341655484,90
Currents
CSV's line format:
name,value
Column name |
Value type |
Example value |
name |
String |
RPMBB.UJ56.RCBXV3.R5 |
value |
Double |
1469.31 |
Example
RPHFC.UJ56.RQX.R5,3276.25
RPHGB.RR57.RQ5.R5B2,2118.02
RPHGC.UJ56.RTQX2.R5,1769.43
RPHH.RR57.RQ4.R5B1,185.78
RPLB.USC55.RCTX3.L5,0.0
RPMBB.UJ56.RCBXH1.R5,50.16
RPTG.SR5.RD1.LR5,383.11
Magnet Strength
CSV's line format:
name,value
Column name |
Value type |
Example value |
name |
String |
MCBCH.5R5.B1 |
value |
Double |
-6.250770266257874E-4 |
Example
MQXA.1R5,0.007536377492458749
MQML.5L5.B1,-0.005884765858632312
MQY.4L5.B1,6.069196107105189E-4
MCBXV.3L5,1.988573963891287E-5
MCSX.3L5,0.0
MCTX.3L5,0.0
MCBYV.B4L5.B2,-1.4462748286114029E-5
MQY.4L5.B2,-6.250955237545528E-4
MCBCH.5L5.B2,3.2830197120643636E-6
MQML.5L5.B2,0.005657426584305705
MQY.4R5.B2,5.654603902122594E-4