Demo 1 for DIAL
David Adams
June 19, 2003

Updated June 30, 2003
Now works at both BNL-ATLAS and CERN.

   Scheduler: ChildScheduler runs the job as a single process on
              the current node
 Application: dial_cbnt is a DIAL wrapper around PAW
        Task: PAW macro in evid.f fills histograms defined in evid.hbk.
     Dataset: A single combined ntuple file from DC1.
      Result: HbookResult holds a logical file with filled histograms.

This can only be run on the acas machines at BNL. It is intended for
use with DIAL 0.3.

------------------------------------------------------------------------

Here are instructions for running the demo:

1. Define the location where you want DIAL to write its tasks and jobs:
   > DIAL_PRIVATE_DIR=$HOME/dial
   > export DIAL_PRIVATE_DIR
   for sh-type shell (bash, ksh, ...) or
   > setenv DIAL_PRIVATE_DIR $HOME/dial
   for csh-type (csh, tcsh, ...) shell.
   The default is $HOME/dial if you do not define this variable.

2. Set up the DIAL environment with
   > . /afs/usatlas.bnl.gov/users/dladams/dial/setup_dial.sh
   for sh-type shell or
   > source /afs/usatlas.bnl.gov/users/dladams/dial/setup_dial.csh
   for csh-type shell.
   This will create the DIAL private directory $DIAL_PRIVATE_DIR.

3. Create an empty working directory and cd there.

4. Run $DIAL_ROOT_DIR/demos/demo1/setup to install the files for
   this demo.

5. Start root (should be version 3.05.04) and issue the commands
   root> .x test.C
   to submit a job to the scheduler

6. Examine results with the following:
   --Job status:
     root> cout << sch.job(jid) << endl;
   --Result:
     root> cout << sch.job(jid).result() << endl;
   The result will include a filled HBOOK logical file most likely
   in a LocalFileCatalog or AfsFileCatalog. The ID of that logical
   file gives the location of the output HBOOK file.

7. The macro open_hbook may be used to extract the filled HBOOK file
   from the result, convert if to ROOT format and open the ROOT file:
   root> open_hbook(sch.job(jid).result());
   A listing of histograms will appear.

8. The histograms may be manipulated in the usual manner, e.g.
   root> h2.Draw();
   to draw a histogram of event ID's

------------------------------------------------------------------------

Reconfiguring
-------------

1. The task may be modified by editing evid.f and changing the (empty)
   histograms defined in evid.hbk. Delete task.xml and use the new
   definitions to build and write out a new task. The latter are done
   automatically by test.C if task.xml is not present.

2. The input dataset may be changed by using the
   command make_cbnt_dataset and then renaming the output to
   testcbnt.xml or modifying the name in test.C.