Update!

As of build versions t03.35.00 (and p16), an "alias" feature has been added to the toollist.txt file. Users can now type in a name for TrigAnalyze to use as a leaf prefix for a tool instance as a third word on each line of the toollist.txt file. For example, say you are interested in the tool instance called "ELE_LOOSE". The toollist.txt file would have a line which reads
    L3TEle ELE_LOOSE
If this was the first instance of the L3TEle tool in the toollist.txt file, the default leaf names associated with it would have the prefix "L3Ele_00". An example leaf name with this prefix is "L3Ele_00_off_eta". If you edit the toollist.txt file to look like this
    L3TEle ELE_LOOSE MyEle
then the associated leaf names would have the prefix "MyEle". An example leaf name with this alias prefix is "MyEle_off_eta".

End Update

New TrigSimAnalyze L3 naming convention

As of build versions t03.41.00 and p15.07.00, the name convention for L3 entries in the ROOT tuple has changed. Previously the branch names were the same as the tool names, and the leaf name also started with the tool name. This caused problems for HepTuple and ROOT itself because names were getting too long.

In the new naming convention, the branch names will always start with "L3", followed by a three letter system identifier, followed by "D" for debug or "PR" for physics result. The leaf names will start with a numbered, abbreviated version of the tool name, followed by "_on_" for online or "_off_" for offline, followed by the variable name.

Here is an example case. In the default toollist.txt file, there is a line which reads
    L3TEle ELE_LOOSE
Let's look just at offline debug information, and just at a variable called "nevt". In the old naming convention, this information would be in the branch "ELE_LOOSE" and in the leaf "ELE_LOOSEnevt_d_off". In the new naming convention, the branch name is "L3EleD", and the leaf name is "L3Ele_00_off_nevt". The number is automatically generated based on the order the tools occur in the toollist.txt. Since "ELE_LOOSE" is the first occurance of the tool "L3TEle" in the default toollist.txt file, it's information is named "L3Ele_00".

There is a way to over-ride this numbering behavior. In the trigsim_analyze package, find the RCP which corresponds to the tool to want to keep the name for. Edit the value for "prefix" so that it is an empty string. This will cause the tool name to be picked up as the prefix. So in the above example, the block name would remain the same, and the leaf name would become "ELE_LOOSE_off_nevt". BE AWARE! Using the tool names as prefixes will cause HepTuple to crash in some instances! A known trouble maker is "MUO_CENTRAL_MATCH".

Here is a partial list of tools and tool names, followed by their corresponding examiners, branch names, and prefixes:
Tool namesToolExaminerBranchPrefix
CalMEt_PvtxZ L3TCalMEt L3CalMEtDebugInfoExaminer
L3CalMEtPhysResultsExaminer
L3CalD
L3CalPR
L3CalMEt
ELE_LOOSE L3TEle L3EleDebugInfoExaminer
L3ElePhysResultsExaminer
L3EleD
L3ElePR
L3Ele
ELE_LOOSE_LOWET L3TEle L3EleDebugInfoExaminer
L3ElePhysResultsExaminer
L3EleD
L3ElePR
L3Ele
ELE_LOOSE_SH_T L3TEle L3EleDebugInfoExaminer
L3ElePhysResultsExaminer
L3EleD
L3ElePR
L3Ele
ELE_NOCUT L3TEle L3EleDebugInfoExaminer
L3ElePhysResultsExaminer
L3EleD
L3ElePR
L3Ele
ELE_VLOOSE L3TEle L3EleDebugInfoExaminer
L3ElePhysResultsExaminer
L3EleD
L3ElePR
L3Ele
GlobalTracker L3TGlobalTracker L3GlobalTrackerDebugInfoExaminer L3TrkD L3GlobTrk
MUO_LOCAL L3TMuoLocal L3MuoLocalDebugInfoExaminer L3MuoD L3MuoLocal
Muon L3TMuon L3MuonPhysResultsInfoExaminer L3MuoPR L3Muon
MUOUNPACK_DEFAULT L3TMuoUnpack L3MuoUnpackDebugInfoExaminer L3MuoD L3MuoUnp
PhysGlobalTracker L3TPhysTracker L3TrackPhysResultsExaminer L3TrkPR L3Trk
PrVTX_Z_TRK L3TCFTVertex L3CFTVertexDebugInfoExaminer L3CftD L3CFTVtx
SCJET_9 L3TJet L3JetsDebugInfoExaminer
L3JetsPhysResultsExaminer
L3JetD
L3JetPR
L3Jets
SCJET_15 L3TJet L3JetsDebugInfoExaminer
L3JetsPhysResultsExaminer
L3JetD
L3JetPR
L3Jets
VTXNULL L3TNullVertex L3TNullVertexDebugInfoExaminer L3VtxD L3NullVtx

Links to tables for auto-generated tool lists in:


Angela Bellavance
Dugan O'Neil
Last modified: Tues Feb 25 2004