Alignment DB Monitoring Tools


The package Alignment/AlignmentDBVisualisationTool provides the scripts plotAlignDiff, plotAlignTrends, and plotAlignHeat for plotting alignment constants from the CondDB as well as directly from SQLite files.

The usage of the tools can be found in their help dialogues by doing, eg,

SetupProject Alignment
plotAlignDiff -h

plotAlignDiff

This tool plots alignment constants for any sequence of successively entered alignments.

Usage: plotAlignDiff [options] elements dofs alignment1 ...
Options:
 -h, --help      show this help message and exit
 -c COORDS, --coordinateFrame=COORDS
             Make plots using local or global coordinates [default:
             global]
 -r REFERENCE, --reference=REFERENCE
             SQLite file (without IOVs) containing a reference
             alignment, e.g. survey
 -o OUTDIR, --outdir=OUTDIR
             Output directory [default: AlignmentsCompared]
 --binLabelsRegex=BINLABELSREGEX
             Regular expression for connection strings. The pattern
             "label" is used as bin label [default:
             .+/Alignment_(?P<label>[0-9a-zA-Z]+)\.db/LHCBCOND$]
 -v, --verbose   Turn on verbose messages
 -i, --info      Turn on info messages

Enter each alignment as either an sqlite file or a date range for retrieving IOVs from the CondDB.
Format date ranges as since,until[,CondDBtag] with CondDBtag optional.
All IOVs in the date range will be plotted.

Valid detector elements are
Velo.[Halves, Modules, Sensors]
 TT.[Layers, Modules, Sensors]
 IT.[Boxes, Layers, Ladders, Sensors]
 OT.[CFrameLayers, CFrames, Modules]

For example, entering

plotAlignDiff TT.Layers Tz 2012-04-01,2012-06-01,cond-20121208 Alignment_2698.db

with Alignment_2698.db in the current working directory produces the following plot:

plotAlignDiff_exaple_TT__Tz.jpg

plotAlignTrends

This tool plots time trends of alignment constants in an IOV range.

Usage: plotAlignTrends [options] elements dofs [dbfile]
Options:
 -h, --help      show this help message and exit
 -c COORDS, --coordinateFrame=COORDS
             Make plots using local or global coordinates [default:
             global]
 -r REFERENCE, --reference=REFERENCE
             SQLite file (without IOVs) containing a reference
             alignment, e.g. survey
 -o OUTDIR, --outdir=OUTDIR
             Output directory [default: AlignmentsCompared]
 --since=SINCE Starting point of time trend [default: 2012-01-01].
             Format: "YYYY-MM-DD[_HH:MM[:SS.SSS]][UTC]" (if UTC is
             absent, timezone is used)
 --until=UNTIL Endpoint of time trend [default: 2013-01-01]. Format:
             "YYYY-MM-DD[_HH:MM[:SS.SSS]][UTC]" (if UTC is absent,
             timezone is used)
 --dbTag=DBTAG Tag used to connect to the CondDB [default:
             cond-20130114]
 --timezone=TIMEZONE Timezone used to parse since and until, and for the x
             axis [default: CET]
 -v, --verbose   Turn on verbose messages
 -i, --info      Turn on info messages
Enter a dbfile to plot the trends of the contained alignments, or enter a date range to
plot the trends of the alignments in the CondDB using the --since and --until options.
Specify a particular CondDB tag using the --dbTag option.
Valid detector elements are
Velo.[Halves, Modules, Sensors]
 TT.[Layers, Modules, Sensors]
 IT.[Boxes, Layers, Ladders, Sensors]
 OT.[CFrameLayers, CFrames, Modules]

For example, entering

plotAlignTrends --since 2012-04-01 --until 2012-06-01 --dbTag cond-20121208 TT.Layers Tz

produces the following plot:

plotAlignTrends_example_TT__Tz.jpg

plotAlignHeat

This tool plots the change of alignment constants between any two alignments. It produces a 2D "heat-map" over diagrams of detector layers.

Usage: plotAlignHeat [options] detector dof1,dof2,... alignment1 alignment2
Options:
 -h, --help       show this help message and exit
 -a ALARMLIST, --alarms=ALARMLIST
             Set alarm thresholds for the requested dofs. Plots
             will be produced only for layers which have an
             alignment difference that exceeds its threshold. Enter
             thresholds as positive values separated by commas
             without spaces, with the order mathcing the order in
             which the dofs are entered. A threshold value of -1
             corresponds to alarm-mode=off for that dof. [default:
             -1 for all dofs]
 -c COORDS, --coordinateFrame=COORDS
             Make plots using local or global coordinates [default:
             global]
 -l LAYERNAME, --layer=LAYERNAME
             Only make plots for the given layer [default: make
             plots for all layers]
 -n, --names     Draw element names [default: False]
 -o OUTDIR, --outdir=OUTDIR
              Output directory [default: AlignmentsCompared]
 -v, --verbose   Turn on verbose messages [default: False]
Valid degrees-of-freedom (dofs): Tx,Ty,Tz,Rx,Ry,Rz
Values plotted are alignment1 relative to alignment2 (alignment1 - alignment2).
Enter each alignment as either an sqlite file or a date range for retrieving IOVs from the CondDB.
Format date ranges as since,until[,CondDBtag] with CondDBtag optional.
If more than one IOV is contained in the date range, the latest IOV will be used.
Layer name conventions:
 TT: TT(a,b)/TT(a(X,U), b(X,V))Layer, eg 'TTb/TTbXLayer' etc.
 IT: Station(1-3)/Layer(X1,U,V,X2), eg 'Station2/LayerX1' etc.
 OT: T(1-3)/(X1,U,V,X2), eg 'T1/V' etc.
Usage examples:
 plotAlignHeat TT Tx,Tz 2012-12-04,2012-12-07 ~/public/alignment/Alignment_survey.db
 plotAlignHeat -l T2/X2 -a 0.1,-1 OT Tx,Rz 2012-12-04,2012-12-07 2012-11-08,2012-12-03

For example, entering

plotAlignHeat -l TTa/TTaULayer TT Tz 2012-05-08,2012-05-09,cond-20121208 2012-05-22,2012-05-23,cond-20121208

productes the following plot:

plotAlignHeat_example_TT_TTa_TTaULayer_Tz.jpg

Topic attachments
I Attachment History Action Size Date Who Comment
JPEGjpg plotAlignDiff_exaple_TT__Tz.jpg r1 manage 149.3 K 2015-05-11 - 22:58 JasonAndrews  
JPEGjpg plotAlignHeat_example_TT_TTa_TTaULayer_Tz.jpg r1 manage 264.7 K 2015-05-11 - 23:21 JasonAndrews  
JPEGjpg plotAlignTrends_example_TT__Tz.jpg r1 manage 160.9 K 2015-05-11 - 23:20 JasonAndrews  
Edit | Attach | Watch | Print version | History: r4 < r3 < r2 < r1 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r4 - 2015-05-12 - JasonAndrews
 
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    LHCb All webs login

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