Difference between revisions of "Replay hints for BigBite"

Revision as of 22:05, 31 March 2008

Last update: Mar 28, 2007 TODO: Keep it updated

README for E04007 ONLINE REPLAY

1. Quick Start for Shift Workers

Replay procedures are:

logon to adaq@adaql<3-?>, call command "goonlana", then "analyzer".

After analyzer is loaded successfully, one can call

replay_det()

for detector replay or

replay_phys()

for physics replay.

It's also possible to specify the run# and event number in parameters. For ex.

replay_det(1568,1000)

will replay first 1k events of run#1568.

2. File Locations

The databases directory are:

bbsoftw@adaqlx:~/DB

which is also soft linked to

adaq@adaql3:$DB_DIR

Source of replay scripts used in adaq@adaqlx are located in:

bbsoftw@adaqlx:~/<experiment ID>/onlana

one can get to it by calling goreplay or goonlana macro as bbsoftw. Key files in above directory are soft linked to

adaq@adaqlx:~/e04007/onlana

where goonlana is pointed to.

Replay directory contains following files:

replay.C:

• the replay script. It contains 3 functions:

       void replay_phys(Int_t runnumber=0,Int_t all=0) 
   //physics reply 
       void replay_det(Int_t runnumber=0,Int_t all=0) 
   //detector reply 
       void replay(Int_t runnumber=0,Int_t all=0, 
           Int_t ReplayMode=kReplayBigBiteTp, 
           Int_t DefReplayNum=-1, 
           char* OutFileFormat=OUT_FILE_FORMAT 
           ) 
   //general replay script 
       See http://www.jlab.org/~jinhuang/BigBiteDoc/replay.C.html
   There are also more replay script to replay Left or right HRS only:
        replay_det_R (<run#>,<Event #>)
        replay_phys_R(<run#>,<Event #>)
        replay_det_L (<run#>,<Event #>)
        replay_phys_L(<run#>,<Event #>)

def.h:

• a collection of parameters for replay.C.
• See http://www.jlab.org/~jinhuang/BigBiteDoc/def.h.html

• .cdef
• Cut define

• .odef
• Out Define

rootlogon.C

• logon script, load include path, scripts, etc.
• See http://www.jlab.org/~jinhuang/BigBiteDoc/rootlogon.C.html

HallA_style.cxx:

• style sheet

AnaShowRun.C:

• boudle deal of replay() and online()

online_C.so->./onlineGUI_v1.2

• complied onlineGUI.
• See http://www.jlab.org/~moffit/onlineGUI/

libBigBite.so

• link to compiled bigbite detector package
• See http://www.jlab.org/~jinhuang/BigBiteDoc/

ReBuildShareObjects

• Script to rebuild replay_C.so and online_C.so

3. Maintenance Guideline

The idea is bbsoftw@adaqlx maintains the replay files, while adaq@adaqlx can only use them.

Only compiled version of replay.C is auto loaded into analyzer. So, after replay.C is modified, CALL ./ReBuildShareObjects to rebuild share objects.

Do not remove files, backup older files before working on it. A good place is

bbsoftw@adaqlx:~/software/onlana/_SaveOlderFileHer
bbsoftw@adaqlx:~/<experiment ID>/ 

holds any file specialized for one experiment. All experiment share other file in

bbsoftw@adaqlx:~/

goonlana and goreplay macro in bbsoftw point to current experiment replay directory. "Current experiment" is defined in

bbsoftw@adaqlx:~/.bashrc

....

4. Big Bite Library

There are two version of Big Bite Library for choice.

Production Version

• is located in

bbsoftw@adaqlx:~/software/bigbitelib

• it's aimed to run at full speed, although less debug information is output.
• it's default version linked to bbsoftw@adaqlx:~/software/onlana/libBigBite.so

Error Tracing Version

• is located in

bbsoftw@adaqlx:~/software_dev/bigbitelib

• if Production Version fails, switch to this version. And one can change

one of the modules to be verbose to trace source of an abnormal. For example, change

#define DEBUG_LEVEL   2

in THaScintPlane.h to higher level (3~5) will outputs more message produced in analysis of Bigbite Trigger Plane data.

Notice: a "make" and modifying soft link

bbsoftw@adaqlx:~/software/onlana/libBigBite.so 

are necessary for taking effect.

For more info, please visit http://www.jlab.org/~jinhuang/BigBiteDoc/