V 2000.1.4

/*************************************************************************/
/********************** Sample F2000.1.4 data file ***********************/
/****************** http://www.ifh.de/~steffenp/f2000 ********************/
/*************************************************************************/


! The V line at top denotes that the file is F2000, version 1.4.
! Comments are allowed anywhere after the V tag.
  # Also a valid comment!
*So is this one... any non-alphanumeric starting the line designates a comment.
! However, inline comments (after valid data) should be a "!" only.

! Data lines can be continued by starting the continuation line with "&"
! (see example in History line section)

!!!! F2000 UNITS: Seconds or nsec ... GeV ... Degrees ... Meters !!!!


/*************************************************************************/
/*************************** History of the run **************************/
/*************************************************************************/

HI genevent (1.3.2.1) -atmospheric_neutrinos -N1000 ! History line: first program.
!          RAVEN 1.3.2.1 : jacobsen@alizarin generating 1000 Neutrinos....
!          (programs add their own comments)
HI clean (1.1) -r79 -r80 ! 2nd program in the history: Remove OMs 79 and 80
HI recoos (2.0.0)  -if -z a_upandel -X g=f -p f=1 -p n=500:4500 -p j=15 -p 
& a=100. -p m=2 -p s=0 -p t=1:1 -y N=49   ! Long line was split into several
& -y N=83 -y N=79 -y N=233 -y N=234 
  & -y N=259 -y R=1000.:5500. -y A=1 -y a=0.5:50. ! Indentation is ok
& -y b=135:2000.:1:290 -y I=80.:300.:1
! You get the idea--recoos was the last program to run.


/*************************************************************************/
/*************************** Trigger definitions  ************************/
/*************************************************************************/

! Define AMANDA-B triggers: programs define their own; each event is "tagged"
! if trigger is satisfied.
!
! Line now includes definition for additional parameters, and there is a
! TRIG_PAR (definition of trigger parameters) line for added flexibility.
          
TRIG_DEF amab4 trig-pulse-le trig-pulse-tot regi-flag

! trig-pulse-le: Trigger pulse arrival time, if available
! trig-pulse-tot: Trigger pulse time-over-threshold, if available
! regi-flag:      yes if event interrupt register bit indicated for this trig.

TRIG_PAR   amab4 type=majority window=2000 fold=8 ! Just describes the trig

TRIG_DEF filter-one ! vz > 0.1, mult > 20, zdiff > 0   Example updown filter.
! An example with no trigger parameters defined.


/*************************************************************************/
/************************* Status and MC definitions *********************/
/*************************************************************************/
! Similarly to triggers we can define status lines for experimental or
! data analysis status and MC lines for Monte Carlo associated information

!          +------------------------------------- Status tag
!          |        +---------+-----------+------ Status info
STAT_DEF hv_level channel requested_hv output_hv ! Channel HV status

STAT_PAR hv_level crate1=1440 crate2=1458 ! Additional info for HV status

! We use one possible status word: for the GPS clock
!       
!         +---------------------- status tag
!         |    +----------------- Device number from Mock decoder 
!         |    |     +----------- Status info from Mock decoder
STAT_DEF GPS device words

!         +-------------------------- MC tag
!         |        +----------------- MC information
MC_DEF corsica event_weight          ! Event dependent value 

MC_PAR corsica seed=12435454332      ! Fixed MC parameter

/*************************************************************************/
/************************* Fits made in the file *************************/
/*************************************************************************/
!          +------------------ Fit name
!          |       +-----+---- values in the FRESULT line
FIT_DEF time_chi2 chi2 loops
FIT_PAR time_chi2 fitter=recoos   ! Fixed fit properties

/*************************************************************************/
/*************************** User-defined fields  ************************/
/*************************************************************************/

! We have one user-defined field here:
!         +--------------------------- user line tag
!         |     +------+--------+----- fields of this line
USER_DEF laser series number deviation
! This can now be invoked by "US laser".
USER_PAR laser type=n2 

/*************************************************************************/
/************************ Calibration and geometry     *******************/
/*************************************************************************/

! ARRAY name       long. latt.  depth nstrings noms
ARRAY  amanda-b-10  0.0  -90.0  1700.   10     302

!  channel-id 
!   |  position on string 
!   |  |    string number
!   |  |    |        x     y    z    
!   |  |    |        |     |    |   up or down 
!   |  |    |        |     |    |   |      type (OM-housing-cable)
!   |  |    |        |     |    |   |       |              serial number
!   |  |    |        |     |    |   |       |              |         efficiency
!   |  |    |        |     |    |   |       |              |         | 
!   |  |    |        |     |    |   |       |              |     1 pe threshold
!   |  |    |        |     |    |   |       |              |         |   |
OM  1  1    1      -15.4  47.6 152. up    r5212-bent-tp    057810   1.0 0.1
OM  2  2    1      -15.4  47.6 132. dn    r5212-bent-coax  ?        1.0 0.1
OM  3  3    1      -15.4  47.6 112. dn    r5212-bent-tp    15717    1.0 0.1
! .... subsequent OMs omitted.
/**************************************************************************/
/* Example OM types: (see documentation for more types)                   */
/* r5212-bent-coax: Hammamatsu phototube, benthos housing, coax cable     */
/*     emi-bill-tp: EMI phototube, billings housing, twisted pair cable   */
/*    emi-bill-opt: Analog optical fiber module                           */
/**************************************************************************/

! Calibration header: what is calibrated
KH ADC TDC UTC

!    chnl  pedestal  beta    linearity
KADC  1.1    0.0    0.0324    0.0       ! Primary channel calibration
KADC  1.2    0.0    0.0214    0.0       ! Secondary channel calibration
KADC  2      5.2    0.0117    0.0       ! Implies channel 2.1
KADC  3     -3.7    0.0254    0.0       ! Ditto
! ...
         
!    chnl  beta   t0   amp-dependece
KTDC  1.1   0.5  6370   1200.4
KTDC  1.2   0.5  2318    315.7
KTDC  2     0.5  4254    214.6
KTDC  3     0.5  6312    996.8
! ...

!    used shift of measured to stored time
KUTC GPS 31.0 ! Assumes 31.0 nsec been added to the true-time clock
                     ! to produce the stored UTC in event header.


! ************** NOTE NOTE NOTE **************
! Since calibration (KH line) is present for TDCs, ADCs and UTC, the values
! in the file are the CALIBRATED rather than the RAW values.
! ************** NOTE NOTE NOTE **************

! ********************* NOTE *****************************
! From now on, slow and muon events can come in any order
! *********************************************************

/*************************************************************************/
/*************************** File start **********************************/
/*************************************************************************/
ES fbegin 1997 32 2764135.2 ! year, day, sec.nsec(since midnight);
! Slow event denoting start of data file. It's presence is strongly suggested.
EE    ! Slow event end

/*************************************************************************/
/******************************** Muon Event *****************************/
/*************************************************************************/
       
! Event header
!      +------------------------------- Event number
!      |     +------------------------- Run number
!      |     |   +--------------------- Year
!      |     |   |    +---------------- Day
!      |     |   |    |   +------------ UTC [seconds.nsec](since Midnight).
!      |     |   |    |   |            +-- tshift [nsec]
!      |     |   |    |   |            |   
EM 1230598 666 1997  32   4801.1029332 0.0

STATUS GPS 2. 28.  ! GPS device and status word
           
/* Even though GPSSTAT implies data, we also show MC truth information for */
/* the event, to illustrate the format:                                    */

! Muon track (implying that the file is MC rather than data).
!  Track number
!  | Parent track
!  | |  Particle type
!  | |  |     Starting position (x,y,z)
!  | |  |      |      |       |   zenith (0 means straight downgoing)
!  | |  |      |      |       |     |    azimuth (0 means along X axis)
!  | |  |      |      |       |     |      |     length energy time
TR 1 ?  A59   1241.  9124.  1700. 120.30  47.1     ?   19151.4  ?  ! Fe primary
TR 2 ?  mu-   53.7   22.4   230.7 120.31  47.2    inf   123.5  3200.1
TR 3 1  brehm 64.0   10.2   110.2 120.31  47.2    4.3    10.0  3613.2

! Hit information follows, 2 pulses on OM 20.
!  Channel number
!   |   ADC (na = not found; * = repeat channel) 
!   |    |  Hit id (for tagging, with fits, triggers or filters)
!   |    |  | Source of pulse (1=muon, 2=secondary shower, N=noise)
!   |    |  | | Leading edge time (nsec)
!   |    |  | | |     Time-over-threshold (nsec)
HT  5  0.1  1 2 66234 102 
HT 15  5.1  2 N 67943 235
HT 16  2.1  3 3 68237 102 
HT 20  0.5  4 2 69234 102 
HT 20  *    5 2 69943 72    ! "*" for ADC indicates repeated channel.
HT 36  1.5  6 2 70234 102 
HT 58  ?    7 N 70944 782   ! "?" for ADC indicates ADC unknown.
HT 59  1.0  8 2 70231 102 
HT 70  6.6  9 3 77944 22
HT 129   ? 19 ? 30675 560
HT 129.2 ? 15 ? 31418 21   ! channel 129 readout by opt.fibres: "129.2"
! ADC values in [PE] after calibration

! Trigger information, as defined above:
TRIG amab4 68948. 22. 1.
! AMANDA-B-4 trigger, with appropriate interrupt register flag set ("1."), 
! whose trigger pulse arrived at 68948 with a TOT of 22.


TRIG filter-one
USES 1-4 6 7 9 10

! Fit info: 
!      id     typ   x    y    z     theta phi      t0    length energy
FIT time_chi2 mu   53.3 22.3 230.0  120.1 45.0    3100.01  inf   352.7
USES   1 2 3 4 5 7 8 10   ! Explains which hits were used for fit
FRESULT time_chi2 0.127 17  ! fit results: chi2=0.127 loops=17
! Error matrix of fit should appear somewhere, but it hasn't been
! specified yet.

! user-defined information as defined above (if necessary)
US laser 1 1 0.023

! MC info as defined above if needed
MC corsica 0.34

EE      ! End of event

/*************************************************************************/
/*************************** Slow event **********************************/
/*************************************************************************/
ES hv 1997  32   4810.1043322   ! HV slow event
! Listing of HV on all channels
STATUS hv_level 1 1855 1845     
STATUS hv_level 2 1900 1915
!...
EE

/*************************************************************************/
/*************************** End of file **********************************/
/*************************************************************************/
ES fend 1997 32 2785233.4
! Event matching 'ES fbegin'
EE  ! End of event

END     ! end of file
       
       

********* Example of a file which contains only one event with
********* two tracks of infinite length:

V 2000.1.4
HI basiev (1.7) -r250 -d1170
! Basiev version (1.7) run by Ole@ifh.de
! Detector line is always needed 
ARRAY amanda-b-10 0.0 -90.0 1730 10 302 
! Note: no calibration is needed here!
EM 1230598 1 1997 32 15.102933202  
TR 1 ?  mu 53.7  22.4 230.7 120.31 47.2 inf 123.5 3200
TR 2 ?  mu 12.0 147.1  16.2 120.31 47.2 inf 121.0 147
EE
END