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

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

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>