TODAC - User's Guide - Alignment

Command Line Interface

todac alignment <path> <start_run> [<end_run>] [-h] [-R] [-filelist] [-label <label>]

Argument Required Default value Description
<path> Yes   Path to an XML file in a proper format (see below for allowed formats of alignment XMLs)
<start_run> Yes   Beginning TOTEM Run number
<end_run> No <start_run> Ending TOTEM Run number
-h No   Prints help
-R No  

Allows to recursively traverse directory specified in <path> in order to find XML files and process them

Note: this option may not be used with -label or -filelist option

-filelist No  

Allows to specify multiple files for processing. Filepaths will be read from text file specified in <path>

Note: this option may not be used with -label or -R option

-label <label> No A label based on <path>

Allows to specify database label explicitly

Note: <label> must not contain white spaces

Note: <label> length must not exceed 50 characters

Note: this option may not be used with -filelist or -R option

Note: Default value is <path> filename and up to 2 parent directories

-filelist option

When specifying -filelist argument, file specified as <path> is treated as a source for filepaths that will be processed. Format of this file is really simple: one filepath per line. Empty lines will be ignored. Sample file content:
/afs/cern.ch/user/x/xyz/alignments/2012_07_07_2/el/corrections.xml
/afs/cern.ch/user/x/xyz/alignments/2012_07_07_2/s/45_220.xml
/afs/cern.ch/user/x/xyz/alignments/2012_07_07_2/s/56_220.xml

Filepaths may also be relative to the location where you run TODAC - for example if you run TODAC in /afs/cern.ch/user/x/xyz/alignments/2012_07_07_2/, you may specify relative filepaths:
el/corrections.xml
s/45_220.xml
s/56_220.xml

Examples

Show help:

todac alignment -h

Insert data for specified run span:

todac alignment alignments/corrections.xml 8367 8372

Insert data for a single run:

todac alignment alignments/45_220.xml 8164

Specify custom label:

todac alignment alignments/45_220.xml 8264 8265 -label my_own_label

Insert all data from a directory:

todac alignment alignments/2012-08-07/ 8123 8129 -R

Insert all data from files listed in list.txt file:

todac alignment list.txt 8321 8324 -filelist

Web Interface

Browse

db.png
Argument Required Default value Description
Start run Yes   Beginning TOTEM Run number
End run No Start run Ending TOTEM Run number
Label Yes  

Note: <label> must not contain white spaces

Note: <label> length must not exceed 50 characters

Version No Latest Data version

Populate

db.png
Argument Required Default value Description
Start run Yes   Beginning TOTEM Run number
End run No Start run Ending TOTEM Run number
Label Yes  

Note: <label> must not contain white spaces

Note: <label> length must not exceed 50 characters

File Yes   File to upload

Supported file formats

AlignmentSequenceDescription

AlignmentSequenceDescription data is stored in XML files.

All data should be contained within a root element:

<xml DocumentType="AlignmentSequenceDescription">
If DocumentType attribute differs, file will not be processed. Whitespaces in this attribute will not be ignored.

Root element content may contain multiple TimeInterval elements which may contain multiple det elements.


TimeInterval elements need to have two attributes - first and last - both of them containing timestamp (Long integer value):

<TimeInterval first="1341651500" last="1341652099">
(...)
</TimeInterval>
Whitespaces in attribute values will be ignored.


det elements need to have id attribute specified (Integer value). All other attributes will be treated as measurements (Double values):

<det id="250" sh_x="+68.39" sh_y="-63.56" rot_z="-1.642"/>
Whitespaces in attribute values will be ignored.


Example file
<xml DocumentType="AlignmentSequenceDescription">
   <TimeInterval first="1341651500" last="1341652099">
      <det id=" 200" sh_x="  +68.39" sh_y="  -63.56" rot_z="  -1.642"/>
      <det id=" 201" sh_x="  +68.50" sh_y="  -65.58" rot_z="  -1.642"/>
      <det id=" 202" sh_x="  +68.50" sh_y="  -63.67" rot_z="  -1.642"/>
      <det id=" 203" sh_x="  +68.59" sh_y="  -65.49" rot_z="  -1.642"/>
      <det id=" 204" sh_x="  +68.59" sh_y="  -63.76" rot_z="  -1.642"/>
   </TimeInterval>
   <!-- some xml comment -->
   <TimeInterval first="1341652100" last="1341652699">
      <!-- RP  20 -->
      <det id=" 200" sh_x="  +65.81" sh_y="  -59.94" rot_z="  -1.642"/>
      <det id=" 201" sh_x="  +65.92" sh_y="  -61.95" rot_z="  -1.642"/>
      <det id=" 202" sh_x="  +65.92" sh_y="  -60.05" rot_z="  -1.642"/>
      <det id=" 203" sh_x="  +66.00" sh_y="  -61.87" rot_z="  -1.642"/>
      <det id=" 204" sh_x="  +66.01" sh_y="  -60.14" rot_z="  -1.642"/>
   </TimeInterval>
</xml>

AlignmentDescription

AlignmentDescription data is stored in XML files.

All data should be contained within a root element:

<xml DocumentType="AlignmentDescription">
If DocumentType attribute differs, file will not be processed. Whitespaces in this attribute will not be ignored.

Root tag content may contain multiple rp and det elements.


rp elements need to have id attribute specified (Integer value). All other attributes will be treated as measurements (Double values):

<rp id="20" sh_x="-388.72" sh_y="+171.78" sh_x_e="+4.5E-02" sh_y_e="+4.5E-02" rot_z="+0.000" rot_z_e="+3.2E-06" sh_z="+0.00" sh_z_e="+0.00"/>
Whitespaces in attribute values will be ignored.


det elements need to have id attribute specified (Integer value). All other attributes will be treated as measurements (Double values):

<det id="250" sh_r="-183.10" sh_r_e="+9.7E-02" sh_x="-129.47" sh_y="-129.47" sh_x_e="+6.8E-02" sh_y_e="+6.8E-02" rot_z=" +0.000" rot_z_e=" +0.000" sh_z=" +0.00" sh_z_e="+0.00"/>
Whitespaces in attribute values will be ignored.


Example file
<xml DocumentType="AlignmentDescription">
   <rp  id="  24"                                   sh_x="  -13.85" sh_y=" +235.15" sh_x_e="+5.4E-02" sh_y_e="+5.4E-02" rot_z="  +0.000" rot_z_e="+3.2E-06" sh_z="   +0.00" sh_z_e="   +0.00"/>
   <det id=" 240" sh_r=" -109.24" sh_r_e="   +0.12" sh_x="  -77.25" sh_y="  -77.25" sh_x_e="+8.6E-02" sh_y_e="+8.6E-02" rot_z="  +0.000" rot_z_e="  +0.000" sh_z="   +0.00" sh_z_e="   +0.00"/>
   <det id=" 241" sh_r=" -103.87" sh_r_e="   +0.12" sh_x="  +73.45" sh_y="  -73.45" sh_x_e="-8.3E-02" sh_y_e="+8.3E-02" rot_z="  +0.000" rot_z_e="  +0.000" sh_z="   +0.00" sh_z_e="   +0.00"/>
   <!-- some xml comment -->
   <rp  id="  25"                                   sh_x="  +13.85" sh_y=" -235.15" sh_x_e="+5.4E-02" sh_y_e="+5.4E-02" rot_z="  +0.000" rot_z_e="+3.2E-06" sh_z="   +0.00" sh_z_e="   +0.00"/>
   <det id=" 250" sh_r="  +54.39" sh_r_e="   +0.12" sh_x="  -38.46" sh_y="  -38.46" sh_x_e="-8.6E-02" sh_y_e="-8.6E-02" rot_z="  +0.000" rot_z_e="  +0.000" sh_z="   +0.00" sh_z_e="   +0.00"/>
   <det id=" 251" sh_r=" +179.77" sh_r_e="   +0.12" sh_x=" +127.11" sh_y=" -127.11" sh_x_e="+8.3E-02" sh_y_e="-8.3E-02" rot_z="  +0.000" rot_z_e="  +0.000" sh_z="   +0.00" sh_z_e="   +0.00"/>
</xml>
Topic attachments
I Attachment History Action Size Date Who Comment
PNGpng alignment-browse.png r3 r2 r1 manage 5.2 K 2014-01-14 - 23:00 KamilMielnik TODAC Web Application - Alignment browse form
PNGpng alignment-populate.png r3 r2 r1 manage 6.0 K 2014-01-14 - 23:00 KamilMielnik TODAC Web Application - Alignment populate form
Edit | Attach | Watch | Print version | History: r8 < r7 < r6 < r5 < r4 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r8 - 2014-01-21 - 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