Top Level Commands

These are the most important commands in HEP. They are always preferred to similar commands, because internally the KUIP command ROOT HEP is executed at startup time.

NAME [ what name driver unit ]

Sets the filenames and drivers for different files that are used by HEP. Without an argument shows all filenames.

NAME List all file names
NAME HBOO hmc.hbook define hbook file as "hmc.hbook"
The filenames are internally stored in the table hepName, so

NAME

table/print all hepName

The function of the different files is:

EVEN : GAF containing Monte Carlo Events (dataflow: mcEvents)
RECO : GAF containint reconstructed events (dataflow: rcEvents)
GENE : arbitrary GAF (dataflow name is taken from the file)
GEOM : GAF containig the geometry
HBOO : histogram file, the histograms arw written to that file
HBDF : GAF containing histogram definitions, can be undefined
RDEV : GAF where Monte Carlo events are written to (RECUCE ON)
RDRC : GAF where rconstructed events are written to
CMDS : dad server that sends online commands; if empty, no connection
MFOR : text file containing the COMIS subroutines

For the GAFs the driver may be omitted, it is then set according the conventions ( RZ for *.rz, FZ,FILFOR=EXCH for *.fz and *.events, IE for all others). For connections to DAD the drivers INET, UNIX, RPIP, RFIL are allowed. The identifier of the dad connection will (after opening) be stored in the UNIT column of the hepName table.

For INET connections give the port number together with the host in the NAME argument (quote!):

    NAME CMDS 'localhost 10555' INET

You don't have to give the UNIT parameter, this number is set and used internally.

INIT [ option ]

Possible OPTION values are:

Initialises HEP, which means, load the geometry file and the histograms definitions file. The filenames of these are defined by the NAME command. When MYHEP is set on, myinit is called. If option NEW is given, remove old initialization. Initialize again.

OPEN [ option dflname ]

Possible OPTION values are:

Opens the input files(s). You may read a file that contains the mcEvents dataflow (option M), the rcEvents dataflow (option R) or an arbitrary GAF file (option G). In case of option G, you must give the dataflow name as third parameter.

If you give both the M and R option then the input from both files is synchronised. Normally there are less rcEvents than mcEvents.

LOOP [ ievents ifirst ]

Loop over the events and increment the defined histograms. When MYHEP is set on, myskip and after that myevent is called.

REDUCE [ option ]

Possible OPTION values are:

Enable/disable the writing of the processed events to another file. Every event that is not rejected will be written to file. Rejection of events is done by the COMIS routine myskip.

LOG [ option ]

Possible OPTION values are:

Enable/disable printing of event numbers during the looping.

SLAVEMODE

Switch to salvemode. This is only possible if before the INIT command a NAME CMDS was set and a connection to a online server was established successfully. HEP then waits for commands from the online server unit it receives the command BREAK. After the it returns to the KUIP prompt.

WEIGHT [ option ]

Possible OPTION values are:

switch weights on/off

If WEIGHT is set ON, all the histograms are incremented by the Monte Carlo weight from the mcEvent table instead of by 1.

OUT

Write histograms and n-Tuples to a file.

CLOSE [ option ]

Possible OPTION values are:

close input files

STATUS

Display status of HEP.

e. g.:

    INIT :      done
    OPEN :  not done
    BOOK :  not done
  REDUCE :       off
     LOG :        on
 WEIGHTS :       off
   MYHEP :       off

SCRATCH

close all files, delete all external tables

MYHEP [ option ]

Possible OPTION values are:

Enable/disable the calling of the user-defined subroutines.

MYCALL [ name ]

Call a specific user function. This command is more of less obsolete, since the PAW command FORTRAN/CALL can call any subroutine. You can use that CALL command also to call TAP-routines.