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

db.png
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

db.png
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
Topic attachments
I Attachment History Action Size Date Who Comment
PNGpng optics-browse.png r1 manage 5.1 K 2014-01-14 - 23:01 KamilMielnik TODAC Web Application - Optics browse form
PNGpng optics-populate.png r1 manage 7.9 K 2014-01-14 - 23:01 KamilMielnik TODAC Web Application - Optics populate form
Edit | Attach | Watch | Print version | History: r5 < r4 < r3 < r2 < r1 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r5 - 2014-01-14 - KamilMielnik
 
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    TOTEM All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2020 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback