Running Analyses

The RunEventAnalysis.exe executable runs the default modules when invoked with a Recon filename and an -o outputfile.root option. RunEventAnalysis.exe –help gives the following help options:

usage: RunEventAnalysis.exe [options] [input-file] ...
Options:
    -o <file>         Set the name of an output file.
    -a                Read all events [Default]
    -c <file>         Set the logging config file name.
    -d                Increase the debug level.
    -g                Force the geometry to be saved.
    -n <cnt>          Only read <cnt> events
    -s <cnt>          Skip <cnt> events
    -v                Increase the verbosity.
    -O <opt>[=<val>]  Set an option for the user code
    -O disable=<moduleclass> Disable a particular module
    -O moduleclass=<option> Configure module
    (for example. -O TTruthTrajectoriesModule=saveall)
          Available module class names are:
            TBasicHeaderModule
            TTruthVerticesModule
            TTruthTrajectoriesModule
            TP0DReconModule
            TTrackerECALReconModule
            TTrackerReconModule
    -O save             Save the original full event in analysis file

Documentation for the individual modules is available: ND::TBasicHeaderModule, ND::TTruthVerticesModule, ND::TTruthTrajectoriesModule, ND::TP0DReconModule, ND::TTrackerECALReconModule, ND::TTrackerReconModule

Output

Each module will create a separate tree, in directories representing the type of information they contain. The above example would create a file with trees as follows:

Directory               Tree 
//HeaderDir             Header 
//TruthDir              Vertices
//TruthDir              Trajectories
//ReconDir              P0D
//ReconDir              Tracker
//ReconDir              TrackerECAL

The tree names come from the Name of the module (as in TNamed::fName).

The modules themselves are also saved, in the directory //TruthDir/Modules and so on.

Adding Modules

Writing modules is a rather specialised topic, for experts of the information being distilled, so please feel free to talk to me Yoshi.nosp@m..Uch.nosp@m.ida@i.nosp@m.mper.nosp@m.ial.a.nosp@m.c.uk, and I can help you get started.

If working on your own, it is best to start by copying the files TTruthVerticesModule.cxx, TTruthVerticesModule.hxx and TTruthVerticesModule_LinkDef.h, renaming them, and changing all occurrences of the class name.