Pulse Shape Display Tool in Atlantis

Some updates on Atlantis were made to help with analyzing the cosmic data and some early ATLAS data, eg, distinguish signal/noise. These updates include:

• PMT quality information of Tile cells -- when clicking a tile cell in Atlantis, it gives the Chi2, gain, energy and time information for that cell.
• Plotting the pulse shape for interesting cells in both Tile and LAr.

To use this new feature, you will need to check out 3 athena packages locally and obtain a new version of Atlantis. (AtlantisJava -09-06-28) This page is about how to obtain and use these new tools.

Producing XML files with LAr+Tile digits and Tile PMT information

Setting up athena 12.0.3

The new packages works with athena version 12.0.3, with group area set properly. At cern lxplus cluster, you can set that up in the following way:

>cd ~; mkdir 12.0.3; cd 12.0.3
>mkdir cmthome; cd cmthome
>source /afs/cern.ch/sw/contrib/CMT/v1r18p20060606/mgr/setup.sh  [or .csh]

create a requirements file in the cmthome directory, a basic requirements file wold be:

set CMTSITE CERN
set SITEROOT /afs/cern.ch
apply_tag noTest
macro ATLAS_GROUP_AREA "/afs/cern.ch/atlas/maxidisk/d37/LArCalorimeter/soft_dev"
macro ATLAS_DIST_AREA ${SITEROOT}/atlas/software/dist
macro ATLAS_TEST_AREA   ""                                                                
use AtlasLogin AtlasLogin-* $(ATLAS_DIST_AREA)

Now do:

>cmt config
>source setup.sh -tag=12.0.3,groupArea
>cd ..
>setenv CMTPATH ${PWD}:${CMTPATH}
>source /afs/cern.ch/atlas/software/builds/AtlasOffline/12.0.3/AtlasOfflineRunTime/cmt/setup.sh

or create a shell script yourself.

For more detailed information about setting up athena environment, see setting up your account.

Compiling required packages

The packages CaloJiveXML and JiveXML were modified to contain the additional information, you need to check out and compile them locally:

>cd ~/12.0.3
>cmt co -r JiveXML-00-06-07 /graphics/JiveXML
>cd graphics/JiveXML/cmt
>source setup.sh
>make

and

>cmt co -r CaloJiveXML-00-00-05 /Calorimeter/CaloCnv/CaloJiveXML
>cd ~/12.0.3/Calorimeter/CaloCnv/CaloJiveXML/cmt
>source setup.sh
>make

The change of codes only appears in these two packages, but to avoid errors like

theApp.Dlls   += [ "GeometryJiveXML"]
File "/afs/cern.ch/atlas/offline/external/Gaudi/0.16.1.12/GaudiPython/v8r0p2/python/gaudimodule.py", line 105, in __setattr__prop.setValue(v)
RuntimeError: (file "", line 0) Failed to load DLLs. (C++ exception)

before running the jobOption, you also need to check out and compile the package GeometryJiveXML:

>cmt co /graphics/GeometryJiveXML
>cd ~/12.0.3/graphics/GeometryJiveXML/cmt
>source setup.sh
>make

Running the jobOption file

After compiling all these three packages successfully, you can run the athena jobOptions to reconstruct events and create XML files. A jobOption file to to that is attached on the bottom of this page. You can just create a run directory andput the attached file into it. Now you need to get two other .py files which are inculded by the jobOption file:

get_files CaloReco_Cosmics_CBNT_jobOptions.py
get_files CaloReco_Cosmics_jobOptions.py

and run the job as:

athena CaloCosmics_Comm_CaloMon_topOptions.py

the xml files and ntuples will be created at /tmp/CaloReco-runNumber/, where runNumber is just the run number you selected. An sample XML file is also attached at the bottom of this page, compare with the normal XML file, it has more tags like "adcCounts", "pmt1Chi2", etc, containing the additional information.

There are several remarks about the jobOption file:

(1) You can decide whether to include the LAr and Tile digit information by the lines

ToolSvc.CaloRetriever.DoLArDigit = False
ToolSvc.CaloRetriever.DoTileDigit = False

in the jobOption file.

(2) You can also to switch on/off the online display mode

ToolSvc.EventData2XML.OnlineMode = True

(3) Better to set the energy threshold for the cells higher by using

ToolSvc.CaloRetriever.CellThreshold = 50

The default value of threshold is only 0.01 MeV. If use the default value, the XML files will be very large (300KB).

Display pulse shape with Atlantis

Atlantis is a Java-based application for visualizing ATLAS events. It takes as input the XML files, which are produced by the Athena package JiveXML. The newest version of Atlantis is AtlantisJava -09-06-28, it can be also checked out from the CVS. See Atlantis web and Atlantis wiki for more information about how to install and run Atlantis.

When a XML file you just produced is loaded with Atlantis, you need to hold the 'p' key modifier while picking a cell of your interest (see Help -> Key modifiers help). A window of pulse shape plots should pop up. You can also select a cell of your interest to display the pmtEnergy, pmtTime, pmtChi2 and pmtGain information.

-- BinGuo - 13 Nov 2006

• Screenshot.png: