TODAC - User's Guide - Optics

Command Line Interface

todac optics <path> <start_run> [<end_run>] [-type <type>] [-h]

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

Populate

Supported file formats

Beta Star

CSV's line format:

start_timestamp,end_timestamp,value

Example

1341650556,1341655484,90

Currents

CSV's line format:

name,value

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

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