Using the Trigger Database GUI

Getting Started | Create Physics Table | L1/L2 Triggers | L3 Triggers | Viewing Trigger Info

Getting Started

Overview

The Trigger Table reflects the capabilities of the hardware, and the hardware imposes certain constraints on the numbers of triggers, the way they may be combined, etc. Click here to get a description of the Trigger Table Constraints. You must follow the rules of these constraints to get a table which will parse at Level 1 and 2.
To make any change to the CDF trigger configuration requires creating a new Physics Table. Physics tables are made of Datasets which are composed of Trigger Paths. A Trigger Path is a unique set of a L1 trigger, a L2 trigger and a L3 trigger. Each Trigger is constructed from one or more Specific Options. A Specific Option is simply a generic option (e.g. photon, track, electron) with values given for the associated Cuts and Parameters (e.g. Dirac_Tower _Et, Track_Pt).
The Trigger GUI has several starting points.

A Physics Table can be created out of existing Triggers, and the GUI will guide the user in organizing the triggers into Paths and Datasets.
Creating a new Trigger is done separately for L1/L2 and L3.
Trigger Info for a Physics table can simply be viewed.

Before making a new Physics Table try to understand your starting point. There are already many declared triggers, paths and datasets in the database that you simply can reuse. For example, if you want to create a new physics table with muon trigger and 2_jet, just create a new dataset from suitable paths, and put this dataset into your new physics table. There is no need to always start from declaring a trigger. When creating a new Physics Table or other database entry, one of the GUI options is "edit". In this case a new Physics Table will be created with the same name, but with a new version (tag) number. This is useful when only small changes are made to the Physics Table.

Running the GUI

To run the application on online (b0dapXX) linux box, do

setup TriggerDBGui test
triggerGui

After you finish these commands successfully, you will see the first GUI panel. When you first start working, you will be prompted for the database instance and your username and password. Login using your online account and password. To get privileges for inserting data into the DB, contact Kirsten Tollefson.

Creating a Physics Table

On the Starting Page: Click on the Create/Edit Physics Table Button

On the Physics Tables Page:

Select New to type in the name of a new physics table
Or Highlight a Physics table and select Edit.

On the Edit Physics Tables Page:

Type in the name of the new Physics Table
Highlight Datasets and Add them to the Physics table
Or create a new Dataset by selecting Edit or New. This will open the Datasets page.

Creating a new Dataset requires choosing a set of trigger paths. On the Dataset page one has the option of editing or making a new trigger path. This will open the trigger paths page from which one can select the corresponding L1, L2 and L3 trigger for that path.

Be sure to click Done to ensure that the data is entered in the database.

Creating a L1 or L2 Trigger

On the Starting Page: Click on the Create/Edit Trigger L1 Button

You will first need to specify the cuts and parameters for the Specific Options and then give the Specific Optioins used for a Trigger.
The example below is for a L1 trigger, but the panels are similar for creating the other trigger objects.

Select Level 1 Triggers

Here, in the upper part, you see the list of all the available Trigger Objects (level 1 triggers in our example). You can click on the object from the list and view it by pushing "VIEW" button. Or you can simply type in a new name in the blank area at the buttom of the form and push "PROCEED" to create a new object.

This panel appears when you push "VIEW" button on the list objects panel.

This form displays all the attributes of the chosen Trigger Object (in our exaple, it is level 1 trigger DIRAC_PHOTON_10/1000 v 1). In the upper part of the form there are descriptive attributes of the object such as the name and the version number etc.
In the lower part of the form there is a list of lower level object, from which this object is made of (in our example it is a list of level 1 specific options DIRAC_PHOTON_10 v 1 and PRESCALE_1,000 v 1)
To make a new object based on the chosen one push "EDIT" button and you will see the create object form.

This panel appears when you push "EDIT" button on the view object panel or when you push "PROCEED" button on the list objects panel

Similary to view object panel , this form displays all the attributes of the Trigger Object (in our exaple, it is level 1 trigger) that you chosen to create. In the upper part of the form there are descriptive attributes of the object such as the name and the version number etc. In the left lower part of the form there is a list of available lower level objects. In the right lower part of the form there is a list of lower level objects that you chosen. You can select it using "<" , ">" buttons. You can reset the form by pushing "RESET" button.

When you push "CREATE" button, new object will be inserted into the database.

Creating a L3 Trigger

To be described later.

Viewing Trigger Info

Using the GUI on a remote Linux box.

Note: These instructions are outdated.

Currently, the CDF Trigger Data Base GUI is available both from offline and online CVS repositories. The only limitation that is left is that you have to run it using Linux Red Hat 6.

To run the application on any (including offsite) other linux box, which has CDFSOFT2 installed, do

source ~cdfsoft/cdf2.cshrc
setup cdfsoft2 development
newrel -t development myTriggerDB
cd myTriggerDB
addpkgh -h TriggerDB/java
source setup.csh
source compile.csh

source setup.csh
startTriggerDBgui