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".
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 names | Tool | Examiner | Branch | Prefix |
|---|---|---|---|---|
| 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: