You are here: Foswiki>AGLT2 Web>SoftwareTutorials>MuonVP1 (06 Feb 2009, SteveGoldfarb)Edit Attach
usatlaslogo

ATLAS Software

Installing and Running VP1 (Release 14.5.1)


Author: Steven Goldfarb | Steve's Notes: Athena | VP1 | DQ2

Introduction

This is a simple tutorial for installing and running VP1 for the visualisation of the ATLAS Geometry and Event Data. It works for CERN (lxplus) and UMT3 (University of Michigan Tier 3 Cluster). It is complementary to the existing documentation found on the VP1 Home Page. Please send comments and corrections to Steven.Goldfarb@cern.ch.

VP1 Use Cases

VP1 runs as an Athena Algorithm and one can install the latest version of VP1 on top of any version of Athena. See the instructions at VP1 Installation for recipes. There are essentially two modes of usage:

  1. Install VP1 and run it on an existing data file (with or without running reconstruction). The format can be Bytestream, RDO, ESD, and AOD (anything with data in StoreGate).
  2. Run VP1, as part of your existing Athena job, by turning on the appropriate jobOption flags. VP1 needs to be the last top algorithm. The only disadvantage to this is if the job normally takes a long time, due to data or database access or simply processing.

Athena Environment

To set up Athena, see the instructions at Main.StevenGoldfarbAthena, based on the ATLAS Computing Work Book. I assume here that the user has followed the steps:
  1. Set Up the CMT Environment
  2. Set Up the Athena Environment
  3. Check Out the UserAnalysis Package
  4. Test the UserAnalysis Package

Install the latest version of VP1 (building from scratch)

This is the safest method, as it builds the packages locally. There are also pre-installed patches (instructions below).

  1. Set up Athena environment: (once per login)
    cd ~/TestArea/14.5.1
    source cmthome/setup.sh
       
  2. Download the vp1patch_cvshead_checkoutandbuildall.x script to the work area and make it executable:
    wget http://cern.ch/atlas-vp1/vp1patches/vp1patch_cvshead_checkoutandbuildall.x
    chmod +x vp1patch_cvshead_checkoutandbuildall.x
       
  3. On UMT3, get kerberos permission (using CERN afs password):
    UMT3> /usr/kerberos/bin/kinit myusername@CERN.CH
       
  4. Run the installation script: (get a coffee)
    ./vp1patch_cvshead_checkoutandbuildall.x
       

Install VP1 from pre-built patch

Here is a list of pre-built patches already installed at UMT3 (thanks to Bob Ball). For CERN, instructions can be found at VP1 Installation.

  1. List available patches:
    UMT3> ls /afs/atlas.umich.edu/Visualize/VP1
    /afs/atlas.umich.edu/Visualize/VP1/vp1patch_2008-10-30-LastBackwardsCompat_14.2.22_i686-slc4-gcc34-opt.tar.bz2
    /afs/atlas.umich.edu/Visualize/VP1/vp1patch_2008-10-30-LastBackwardsCompat_14.2.23_i686-slc4-gcc34-opt.tar.bz2
    /afs/atlas.umich.edu/Visualize/VP1/vp1patch_2009-01-30_14.2.24_i686-slc4-gcc34-opt.tar.bz2
    /afs/atlas.umich.edu/Visualize/VP1/vp1patch_2009-01-30_14.2.25_i686-slc4-gcc34-opt.tar.bz2
    /afs/atlas.umich.edu/Visualize/VP1/vp1patch_2009-01-30_14.4.0_i686-slc4-gcc34-opt.tar.bz2
    /afs/atlas.umich.edu/Visualize/VP1/vp1patch_2009-01-30_14.5.0_i686-slc4-gcc34-opt.tar.bz2
    /afs/atlas.umich.edu/Visualize/VP1/vp1patch_2009-01-30_14.5.1_i686-slc4-gcc34-opt.tar.bz2
    /afs/atlas.umich.edu/Visualize/VP1/vp1patch_2009-01-30_checkoutandbuildall.x
       
  2. Download the installation script:
    cd ~/TestArea/14.5.1
    wget http://cern.ch/atlas-vp1/vp1patches/vp1-install-patch
    chmod +x vp1-install-patch
       
  3. Run the script on the desired patch:
    ./vp1-install-patch /afs/atlas.umich.edu/Visualize/VP1/vp1patch_2009-01-30_14.5.0_i686-slc4-gcc34-opt.tar.bz2
       

Test the VP1 Installation

  1. Run vp1 to see if all installed correctly
    vp1
       
  2. Get some help on the command line options
    vp1 -h
       
  3. Try running on the AOD file already created in UserAnalysis
    cd ~/TestArea/14.5.1/PhysicsAnalysis/AnalysisCommon/UserAnalysis/run
    vp1 AOD.pool.root
       
  4. The VP1 browser will appear after the first event is initialized. Try the following:
    1. When the vp1 browser appears, click on "All studies".
    2. Add the "Tracks" and "Hits" menus by checking the boxes in the "General" menu.
    3. Go to the "Tracks" menu and pick your favorite algorithm under "Detailed Tracks" (forget about Track Particles for now).
    4. Add Segments, as you like.
    5. Go to the "Hits" meny and pick your favorite hits (MDT_DriftCircles, for example).
    6. Have fun.
    7. Click on the blue "right arrow" in the lower left, under the menus, to advance to the next event.
    8. Find more complete instructions on the VP1 3D Viewer Pages.

Run VP1 on Muon Cosmic ESD Files

This example uses ESD files created from a stripped Muon Cosmic Bytestream data file. You can download the pre-made files here or follow the instructions in the Athena Tutorial to create them yourself.

  1. Set up Athena environment: (once per login)
    cd ~/TestArea/14.5.1
    source cmthome/setup.sh
       
  2. We will do this from the UserAnalysis area:
    cd ~/TestArea/14.5.1/PhysicsAnalysis/AnalysisCommon/UserAnalysis/run
       
  3. Download the ESD's:
  4. View the ESD file produced w/alignment corrections:
    vp1 mdaq.ATLAS.0091060.physics.CosmicMuons.ESD.align.pool.root
       
  5. View the ESD file produced w/o alignment corrections:
    vp1 mdaq.ATLAS.0091060.physics.CosmicMuons.ESD.noalign.pool.root
       

Run VP1 from an Existing Athena Job (Run on Bytestream)

These instructions show how to integrate VP1 into an existing Athena job by adding the Algorithm. The VP1 Viewer will start up once the initialization of Athena is completed and it has stopped at the first event.

Note: Initialization takes a very long time on the UMT3 machines, as the conditional database is being accessed in BNL. Best to produce the ESD data sets (see above) in the background or overnight.

  1. Set up Athena environment: (once per login)
    cd ~/TestArea/14.5.1
    source cmthome/setup.sh
       
  2. Set up the UserAnalysis environment: (once per login)
    cd ~/TestArea/14.5.1/PhysicsAnalysis/AnalysisCommon/UserAnalysis/run
    source ../cmt/setup.sh
       
  3. Add the following lines at the bottom of you favorite top level jobOptions file:
    from VP1Algs.VP1AlgsConf import VP1Alg
    topSequence += VP1Alg()
       
  4. Examples: Download Stripped Cosmic Bytestream file and jobOptions that include VP1:
  5. Run vp1 on the data file, applying alignment corrections:
    athena -s vp1_align.py | tee vp1_align.log
       
  6. Run vp1 on the data file, w/o applying alignment corrections:
    athena -s vp1_noalign.py | tee vp1_noalign.log
       

References


Major updates:
SteveGoldfarb - 30 Jan 2009 (creation) -- SteveGoldfarb - 06 Feb 2009 (update to 14.5.1)
Topic attachments
I Attachment Action Size Date Who CommentSorted ascending
mdaq.ATLAS.0091060.physics.CosmicMuons.ESD.align.pool.rootroot mdaq.ATLAS.0091060.physics.CosmicMuons.ESD.align.pool.root manage 1 K 02 Feb 2009 - 16:45 UnknownUser ESD made from Cosmic Data File (w/alignment corrections)
mdaq.ATLAS.0091060.physics.CosmicMuons.ESD.noalign.pool.rootroot mdaq.ATLAS.0091060.physics.CosmicMuons.ESD.noalign.pool.root manage 380 K 02 Feb 2009 - 16:46 UnknownUser ESD made from Cosmic Data File (w/o alignment corrections)
requirementsEXT requirements manage 1 K 02 Feb 2009 - 16:47 UnknownUser Requirements file for 14.5.0.6
mdaq.ATLAS.0091060.physics.CosmicMuons.LB0001.SFO-1._0001.datadata mdaq.ATLAS.0091060.physics.CosmicMuons.LB0001.SFO-1._0001.data manage 707 K 02 Feb 2009 - 16:45 UnknownUser Stripped Cosmic Bytestream Data File (only Muon data)
makeESD_align.py.txttxt makeESD_align.py.txt manage 6 K 02 Feb 2009 - 16:48 UnknownUser top jobOption to create ESD from bytestream w/alignment corrections
makeESD_noalign.py.txttxt makeESD_noalign.py.txt manage 6 K 02 Feb 2009 - 16:49 UnknownUser top jobOption to create ESD from bytestream w/o alignment corrections
vp1_align.py.txttxt vp1_align.py.txt manage 6 K 02 Feb 2009 - 16:50 UnknownUser top jobOption to run VP1 on ESD file created w/alignment corrections
vp1_noalign.py.txttxt vp1_noalign.py.txt manage 6 K 02 Feb 2009 - 16:50 UnknownUser top jobOption to run VP1 on ESD file created w/o alignment corrections
Topic revision: r5 - 06 Feb 2009, SteveGoldfarb
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback