Michael Ronan, LBNL (Berkeley)
June 7, 2001
LCD Track Analysis Examples
Here is an attempt to provide some instructions and examples
to get one started in analyzing tracks within the Linear Collider Detector
(LCD) analysis environment.
Getting Started
- Setting up JAS
-
check Java JDK version
-
java -version (or -fullversion)
-
check PATH - Make sure that you're getting the right
version of JAS
-
stage data
e.g. At SLAC, executing the loadLCDDAT script
stages in public LCD data.
-
jas & (or ./jas depending on PATH)
-
within JAS
-
Begin (or create) a "New Job"
-
Select "A local job for data analysis", then Next >>
-
Select the "LCD SIO file (*.sio)" Data Interface Module (DIM), then
Next >>
-
Select an individual data file, or
append multiple files together, then Finish.
-
Load an analysis or reconstruction program, e.g.
-
TrackAnalysis - A simple reconstructed track analysis (see
below)
-
TrackHitAnalysis - A simple analysis of hits on tracks (see below)
-
...
- Editing and compiling
-
within JAS
-
Open an existing Java file or create a new one.
-
Use the built-in language sensitive editor.
-
Compile and reload the class automatically.
-
in a UNIX or Linux environment
-
Edit in emacs or any other editor.
-
Set up Java CLASSPATH.
e.g. At SLAC, sourcing the setup script sets
JAVAVER
and CLASSPATH.
-
Compile with gmake and then reload into JAS.
-
on Windows
-
Edit as you like or work in a software development environment (SDE), such
as Visual J++.
-
Set up Java CLASSPATH.
-
Build within the environment or compile with javac and then reload
into JAS.
- Viewing Java histograms
-
within JAS
-
Use File/Open to open a Java histogram (*.javahist) file
-
Open the various Histogram folders
-
Double click on selected histogram
-
Use right mouse button to modify histogram display options.
Scanning Events
After downloading the Linear
Collider detector java classes (lcd.jar) and installing them into JAS,
it is quite straight forward to scan events.
- Using standard track reconstruction software
-
Begin a new data analysis job as described above.
-
Load in the standard reconstruction package
-
Load hep.lcd.recon.ztracking.TrackReconstruction
Note: For hep.lcd Version 1.4 and earlier, load hep.lcd.recon.tracking.TrackReco
-
Load in an Event Display as a JAS Plugin extension, using either
-
hep.lcd.plugin.LCDPlugin - Simple "home-built" event display
-
hep.lcd.wired.application.LCDWired - WIRED event display (below)
-
For the LCD Event Display
-
Use the pull-down menu to "Show Event Display"
-
then set any "Event Display Options"
-
Use the Job toolbar to set through events.
- To use the WIRED event display
-
Load in the WIRED plugin
extension
-
Obtain the appropriate JAR files
-
Load the hep.lcd.wired.application.LCDWired plugin into JAS.
-
Select the WIRED event display
-
Use the pull-down menu to select a "New View"
Note: 2 "Load Failure" error messages one for the Detector description
(eg. L2) and one for the event (e.g. Run 1 event 1) are non-fatal.
-
Use left and right mouse button controls to select different views.
Simple track analysis examples
These analysis examples access event summary quantities such as ReconstructedTracks.
- Analyzing reconstructed tracks:
-
TrackAnalysis (code)
- Turns on inline histograms within Tracking package.
- Running an analysis
-
Edit & compile the track analysis code (help)
-
Run the analysis (script)
-
Look at output logfile, view Java histograms (e.g. TrackAnalysis.javahist)
using JAS (help)
Detailed tracking examples
These analysis examples access methods in the core Tracking, Vertex hit
association, and Track fitting processors.
- Analyzing hits on tracks:
This URL is http://obsidian.lbl.gov/~ronan/docs/tracking/Examples.html