------------------------------------------------------
OFFLINE UTILITY MANUAL                  (ver -0.01)
------------------------------------------------------

                            Released: January 31, 1997    T.Ishida
 (you can find this manual in 
          pnahp::/home2/e362/offline/public/doc/manual.txt

<<GENERAL>>
     directory structure of /home2/e362/offline/public
      /bin/   utility. (linked to /home2/e362/bin)
             you find
             *fgsim   : detector simulation
            (*fgrdex  : test utility to read ZBS files)
             *fgflt_e : electron event filter
	     *fgscan  : event scanning routine
     /doc/   documents.
     /fgrd/  make library libfgrd (readout of FGD)
     /flt/   source files and makefile of fgrdex, fgflt_e.
	     see the following programs if you want to do
	     MC analysis.
             *main_fgrd_example.f : example of fgread usage.
             *fgflt_e.f : electron event filter
                   *ufgtrack.f : fill track information to a common
                   *utrckpid.f : particle ID of each track
                   *ureduc_e.f : e selection / BG reduction
     /inc/   include files. gcxxxx are GEANT commons, while
             fgxxxx are for FGD offline analysis. 
     /lib/   libraries for FGD analysis. 
            (Now only one library exists: libfgrd.a (FGREAD)).
     /macro/ xx.kumac for FGSCAN. (linked to /home2/e362/macro)
     /scan/  make utility FGSCAN, event scanning routine.
     /sim/   make utility FGSIM, do Monte Carlo and fill results to ZBS.
     

<< HOW TO USE OFFLINE UTILITY >>
----------------------------------------------------------------------------------
0) add a path "/home2/e362/bin" to your login shell.
   you can recognize the path by enter command 
       >> source ~/.login

----------------------------------------------------------------------------------
1) FGSIM, event simulation. 
   You can find complete manual (by Chikamatsu) in
             /home2/e362/offline/public/doc/fgsim.txt)

copy '/home2/e362/card/input.card' to your directory, and edit it. 
in most of cases, you only need to change 'INPT'. 
    ( INPT =  3  Kamioka neutrino MC (muon) )
    (         4  Kamioka neutrino MC (electron) )

>> fgsim
  ******************************************************
  *                                                    *
  *            W E L C O M E    to   P A W             *
  *                                                    *
  *       Version 2.06/20       3 March 1995           *
  *                                                    *
  ******************************************************
  Workstation type (?=HELP) <CR>=1 :     <-----HIT RETURN HERE 
                                           then you get HIGZ window.

  0*****  Correction Cradle Version   .0400
   *****  Library compiled on 950322 at 1740 *****

 read 4     <-----TYPE "read 4", to read input card. 

 GEANT > trig 1     <-----Generate one event.  
                          trig (NUMBER) generate  (NUMBER) events
                          ex. trig 100 

     1    3    1   NCel
  ------------------------------------
  Enu =   1.08
     4  -.21  -.20   .05
    14  -.18   .21   .69      .74
     1   .35  -.01   .23
     1   .04   .00   .11
  =====================================

To see events on HIGZ display;

 GEANT > macro/default '/home2/e362/macro' 'a' 
                             <-----declare path for kumac files

 GEANT > macro/list          <-----output list of macros

-rw-r--r--   1 e362     kam_icrr       30 Jan 31 11:04 /home2/e362/macro/3d.kumac
-rw-r--r--   1 e362     kam_icrr      225 Jan 31 11:35 /home2/e362/macro/3d_cre.kumac
-rw-r--r--   1 e362     kam_icrr      407 Jan 31 11:38 /home2/e362/macro/lg.kumac
-rw-r--r--   1 e362     kam_icrr       58 Jan 29 19:10 /home2/e362/macro/pr.kumac
-rw-r--r--   1 e362     kam_icrr      341 Jan 31 11:32 /home2/e362/macro/s.kumac
-rw-r--r--   1 e362     kam_icrr      486 Jan 31 11:32 /home2/e362/macro/st.kumac
-rw-r--r--   1 e362     kam_icrr      355 Jan 31 11:31 /home2/e362/macro/t.kumac
    
In FGSIM, following macros are available. (Others are for FGSCAN)
 GEANT > s                              <-----execute s.kumac SIDE VIEW 
 GEANT > t                              <-----execute t.kumac TOP VIEW
 GEANT > st                             <-----execute t.kumac SIDE&TOP VIEW 
 GEANT > pr t ev1                       <-----top view is saved as PS file
                                              ev1.ps

 GEANT > exit
Output ZBS file 'zbs.out' is written in your directory.

Offline group is ging to make 100k numu and 10k nue data at /home2/zbsdata/;
         /home2/zbsdata/mc_mu.dat
         /home2/zbsdata/mc_e.dat

----------------------------------------------------------------------------------
2) FGFLT_E, electron event selection. 
>> fgflt_e
 c--------------------------------------------
 c  =====Input File=====
 c  iflag  : 1  - set open input filename by hand
 c         : 10 - Muon MC
 c               /home2/zbsdata/mc_mu.dat
 c         : 20 - electron MC
 c               /home2/zbsdata/mc_e.dat
 c--------------------------------------------
 Flag > 1  
 ZBS File name to be opened ? > zbs.out


 c--------------------------------------------
 c  =====Output File====
 c--------------------------------------------
 ZBS File name to be opened ? > e.out  <----- output ZBS filename 
                                              specification

 c--------------------------------------------
 Output hbook file > e.hbook  <----- output HBOOK file specification

 REACTION TYPE? (no select=0) <----- please specify REACTION TYPE.
	       (   1  : NCqe    2 : NC1pi   3 : NCmpi    )
	       (   11 : muCCqe  12: muCC1pi 13: muCCmpi  )
	       (   21 : e CCqe  22: e CC1pi 23: e CCmpi  )
	       (   0  : all  )
 21

 alived rate: 0 / 0
 CUT# 0 : 100    <------ Cutting criteria. Please see ureduc_e.f in /flt/ 
 CUT# 1 : 40     
 CUT# 2 : 39
 CUT# 3 : 20
 CUT# 4 : 10
 CUT# 5 : 5
 CUT# 6 : 4
 CUT# 7 : 3
 CUT# 8 : 1
 
You get selected event file "e.out" in your directory.

----------------------------------------------------------------------------------
3) FGSCAN, event diaplay / scanning. 
>> FGSCAN

 Workstation type (?=HELP) <CR>=1 : <--- HIT RETURN

 ZBS File name to be opened ? > e.out <--- enter file name you want to scan
 
 read 4    <--- read input card
  
 trig 1    <--- process one event
 
 event#: 1 int# 1
  ------------------------------------
     4:(   .00   .00  1.08)
    14:(   .00   .00   .00)
     4:(  -.21  -.20   .05)
    14:(  -.18   .21   .69)
     1:(   .35  -.01   .23)
     1:(   .04   .00   .11)
  ------------------------------------
 ==Hits in SCIFI 16
 0 0 0 0 0 0 0 0 0 0
 1 1 1 1 1 1 1 4 3 2
 ==Hits in MUC 0
 x: 0 0 0 0 0 0 0 0 0 0 0 0 0
  : 0 0 0 0 0 0 0 0 0 0 0 0 0
 y: 0 0 0 0 0 0 0 0 0 0 0 0 0
  : 0 0 0 0 0 0 0 0 0 0 0 0 0
 ==LG( 18 21) .2129784
 ==LG( 18 22) .1215765

Set path of macro files
 GEANT > mac/def '/home2/e362/macro' 'a'
 GEANT > mac/lis

 GEANT > s
 GEANT > t
 GEANT > st
 GEANT > lg     <----LG response
 GEANT > 3d_cre <----3d view creation. wait for a while till view bank
                     creation complete.
 GEANT > 3d     <----after 3d_cre, you can see 3d-view.
 GEANT > pr 3d e3d  <----- 3d view is saved as e3d.ps in your directory.


 GEANT > exit      <----exit from GEANT
 
 
                                                                fin.