|
Steve's Notes
Installing and Running VP1 (Release 14.5.1)
|
Athena |
VP1 |
DQ2 |
Wire Sag |
UM Cluster
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@cernNOSPAMPLEASE.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:
- 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).
- 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
StevenGoldfarbAthena, based on the
WorkBook. I assume here that the user has followed the steps:
- Set Up the CMT Environment
- Set Up the Athena Environment
- Check Out the UserAnalysis Package
- Test the UserAnalysis Package
Install the latest version of VP1
This is the safest method, as it builds the packages locally. There are also pre-installed patches (instructions at
VP1 Installation.
- Set up Athena environment: (once per login)
cd ~/TestArea/14.5.1
source cmthome/setup.sh
- Download the vp1patch_2009-01-30_checkoutandbuildall.x script to the work area and make it executable:
wget http://cern.ch/atlas-vp1/vp1patches/vp1patch_2009-01-30/vp1patch_2009-01-30_checkoutandbuildall.x
chmod +x vp1patch_2009-01-30_checkoutandbuildall.x
- On UMT3, get kerberos permission (using CERN afs password):
UMT3> /usr/kerberos/bin/kinit myusername@CERN.CH
- Run the installation script: (get a coffee)
./vp1patch_2009-01-30_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.
- 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
- Download the installation script:
cd ~/TestArea/p14.5.0.1
wget http://cern.ch/atlas-vp1/vp1patches/vp1-install-patch
chmod +x vp1-install-patch
- 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
- Run vp1 to see if all installed correctly
vp1
- Get some help on the command line options
vp1 -h
- Try running on the AOD file already created in UserAnalysis
cd ~/TestArea/14.5.1/PhysicsAnalysis/AnalysisCommon/UserAnalysis/run
vp1 AOD.pool.root
- The VP1 browser will appear after the first event is initialized. Try the following:
- When the vp1 browser appears, click on "All studies".
- Add the "Tracks" and "Hits" menus by checking the boxes in the "General" menu.
- Go to the "Tracks" menu and pick your favorite algorithm under "Detailed Tracks" (forget about Track Particles for now).
- Add Segments, as you like.
- Go to the "Hits" meny and pick your favorite hits (MDT_DriftCircles, for example).
- Have fun.
- Click on the blue "right arrow" in the lower left, under the menus, to advance to the next event.
- Find more complete instructions on the VP1 3D Viewer Pages.
Run VP1 on Local 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
StevenGoldfarbAthena to create them yourself.
- Set up Athena environment: (once per login)
cd ~/TestArea/14.5.1
source cmthome/setup.sh
- We will do this from the UserAnalysis area:
cd ~/TestArea/14.5.1/PhysicsAnalysis/AnalysisCommon/UserAnalysis/run
- Download the ESD's:
- View the ESD file produced w/alignment corrections:
vp1 mdaq.ATLAS.0091060.physics.CosmicMuons.ESD.align.pool.root
- View the ESD file produced w/o alignment corrections:
vp1 mdaq.ATLAS.0091060.physics.CosmicMuons.ESD.noalign.pool.root
Use DQ2 to find some ESD files from a run and then Run VP1 on them
This example retrieves some data from run 91060 and then runs on it
- Set up Athena environment: (once per login)
cd ~/TestArea/14.5.1
source cmthome/setup.sh
- We will do this from the UserAnalysis area:
cd ~/TestArea/14.5.1/PhysicsAnalysis/AnalysisCommon/UserAnalysis/run
- Set up DQ2 and get proxy:
source /afs/cern.ch/atlas/offline/external/GRID/ddm/DQ2Clients/setup.sh
voms-proxy-init -voms atlas
- Look for all the ESD data sets with TGC trigger:
dq2-ls \*91060\*TGC\*ESD\*
- Pick a data set and check if it has files available:
dq2-ls -f data08_cos.00091060.physics_TGCwBeam.recon.ESD.o4_r663_tid065979
- Download to the
tmp
directory:
cd /tmp/goldfarb
dq2-get data08_cos.00091060.physics_TGCwBeam.recon.ESD.o4_r663_tid065979
- Run vp1 on one of the files:
cd ~/TestArea/14.5.1/PhysicsAnalysis/AnalysisCommon/UserAnalysis/run
vp1 /tmp/goldfarb/data08_cos.00091060.physics_TGCwBeam.recon.ESD.o4_r663_tid065979/ESD.065979._00001.pool.root.2
- Keep the data file on castor for future use:
rfcp /tmp/goldfarb/data08_cos.00091060.physics_TGCwBeam.recon.ESD.o4_r663_tid065979/ESD.065979._00001.pool.root.2 /castor/cern.ch/user/g/goldfarb/Analysis/CosmicMuons/91060
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.
- Set up Athena environment: (once per login)
cd ~/TestArea/14.5.1
source cmthome/setup.sh
- Set up the UserAnalysis environment: (once per login)
cd ~/TestArea/14.5.0.6/PhysicsAnalysis/AnalysisCommon/UserAnalysis/run
source ../cmt/setup.sh
- Add the following lines at the bottom of you favorite top level jobOptions file:
from VP1Algs.VP1AlgsConf import VP1Alg
topSequence += VP1Alg()
- Examples: Download Stripped Cosmic Bytestream file and jobOptions that include VP1:
- Run vp1 on the data file, applying alignment corrections:
athena -s vp1_align.py | tee vp1_align.log
- Run vp1 on the data file, w/o applying alignment corrections:
athena -s vp1_noalign.py | tee vp1_noalign.log
Viewing MDT Data (A Few Examples)
More information:
- VP1 3D Viewer Pages: [ html ]
- Group Meeting Presentation (15 Sep 2009): [ pdf ] [ ppt ]
- Once vp1 is up, you will get a Welcome to Virtual Point 1 window.
- Click on All Studies
- A General tab is selected and the General menu is showing in the left window. Check the boxes Tracks and Hits
- Now a Tracks tab and a Hits tab will appear in that window.
- Click on the Tracks tab to get that menu.
- Check the boxes for the Tracks or Segments you want to see (e.g. MooreTracks)
- You can keep default settings or play with Colors, Projections, etc.
- Click on the Hits tab to get that menu.
- Check the boxes for the Hits you want to see (e.g. MDT_DriftCircles)
Navigating (A Few Examples)
More information:
- VP1 3D Viewer Pages: [ html ]
- Group Meeting Presentation (15 Sep 2009): [ pdf ] [ ppt ]
- There are four icons to the right of the viewing window. Hovering over the icons tells what they do.
- Select the *arrow for picking objects to get information
- Select the *hand for moving and zooming and other navigation
- Select the *eye to zoom back until everything is visible
- Select the flashlight to choose rotation origin
- Select the bottom trapezoidal thing to select perspective or orthographic mode
- You can use your mouse to navigate
- Left mouse button rotates the detector and data
- Middle mouse button displaces the detector and data
- Right mouse button gives some options for viewing (anti aliasing gives nice pictures)
- Scroll wheel zooms or unzooms
- There are four icons in the upper left under Controls: 3DCocktail. Hovering gives info.
- Far left is full screen mode (This broke my session!)
- Info Symbol gives contact information
- Camera takes a snapshot and saves a .png file
- Printer lets you print to a printer or a file
Getting Muon Spectrometer Detector ID Information
- Click on the Geo tab in the left-hand menu
- Select the Interactions tab in the sub-menu
- Check Muon chamber info
- Select the arrow icon on the right-hand side (right of the image)
- Click on the detector element for which you want to see info
- The information will be printed in the bottom info window and to standard output.
- Example:
[3DCocktail/Geo] ===> Selected Node: MultiLayerFoam
[3DCocktail/Geo] ===> Muon station <===
[3DCocktail/Geo] Name: EML
[3DCocktail/Geo] (Eta,Phi) index: (2, 3)
References
Major updates:
StevenGoldfarb - 13 Jan 2009 (creation)
--
StevenGoldfarb - 02 Feb 2009 (update for demo)
--
StevenGoldfarb - 04 Feb 2009 (update to 14.5.1)
--
StevenGoldfarb - 29 Jul 2009 (update to use version-specific installation)
--
StevenGoldfarb - 2009-09-14 (MDT usage directions)
--
StevenGoldfarb - 2009-09-15 (attached presentation)
--
StevenGoldfarb - 2009-09-24 (added detector info section)