Hlt Trigger Selection Naming Convention

The following naming convention applies to strings used to identify Trigger Selections which may get saved in HltSummary.

Since in Hlt1 all algorithms inheriting from HltAlgorithm class are automatically saveable in HltSummary under the name of the instance of the algorithm, this convention does apply to the names of these algorithms.

In Hlt2 the names under which the selection outputs are saved in HltSummary are not automatically tied to the names of the algorithms. Thus, we do not impose any restrictions on algorithm names in Hlt2. However, it is strongly recommended that the name of the instance of the Hlt2 algorithm appears in the middle of the identification string used in the HltSummary.

Prefix identifying trigger level

All trigger selection names must start with either "L0", "Hl1", "Hlt2" or "Hlt". Only the first letter should be capitalized in the prefix. The first letter following the prefix should be capital and should not be a number.

The "L0" prefix is reserved for selections containing respresentations of L0 objects in Hlt-selection format.

The "Hlt1" prefix identifies all selections which can be created only in Hlt1 step, except for representations of L0 objects (see above).

The "Hlt2" prefix identifies all selections which can be created only in Hlt2 step.

Selections of algorithms which can be executed either in Hlt1 or Hlt2 steps should start with "Hlt".

Postfix identifying final selections at given trigger level

To identify trigger selections which are responsible for final decision to keep event after given trigger level from intermediate ones, every final selection name should end with "Decision". The "Decision" string should not appear anywhere within names of intermediate selections.

If you use HltSelectionFilter which takes an OR between a subset of final selections, you should not be ending a name of such selection with "Decision", since the decision to keep event has been already make. Call it something else and put "SF" in the name (see below).

Thus the triggers (i.e. final trigger selection names) will be:

• "L0xxxDecision" where "xxx" is the name of L0 trigger channel ("Muon", "DiMuon", "MuonNoGlob", "Hadron", "Electron", "Photon", "LocalPi0", "GlobalPi0").

• "Hlt1xxxDecision" where "xxx" is the name of an alley (see below for recommended structure)

• "Hlt2xxxDecision" where "xxx" is the name of Hlt2 algorithm which produced final selection.

Recommendations for naming Hlt1 selections

Each part of the name must start with capital letter and is allowed to contain other capitalized letters in the middle (to make it more readable).

The first part of the name following the "Hlt1" prefix should identify family (i.e. "alley") of triggers e.g. "Hadron", "Muon", "MuTrack" etc. The subsequent parts should indetify sub-families ("sub-alleys") if any.

Once the individual Hlt1 trigger line is identified, you should identify algorithm corresponding to the generic Hlt algorithm you use:

• HltTrackFilter -> "TF"
• HltVertexFilter -> "VF"
• HltSelectionFilter -> "SF"
• HltTrackUpgrade -> "TU"
• HltVertexUpgrade -> "VU"
• HltVertexMaker -> "VM"
• HltL0Filter -> "L0"

The filter algorithm will usually be followed by the name of track/vertex it operated on e.g. ""RZVelo", "Velo", "Forward", "L0MuonDecision" etc. For example "Hlt1HadronSingleTFRZVelo".

The upgrade algorithm will usually be followed by the name of reconstruction step: "Velo", "Forward" etc. For example "Hlt1HadronSingleTUVelo".

The selections making final decisions are exempt from identifying algorithm/object type they use to make the decision. For example "Hlt1HadronSingleDecision" is a HltTrackFilter.

Entry selections, usually based on L0 trigger criteria (HltL0Filter), can be shared among alleys, thus are just named: "Hl1L0XXX" where XXX is L0 trigger name for single condition (e.g. "Hlt1L0Muon"). For more complex entry points use descriptive name (e.g. "Hlt1L0MuonORMuonNoGlob").

-- TomaszSkwarnicki (with input from Jose) - 20 Jun 2008, 01 Jul 2008