Datareader home        Runlist        Outputs        Stage6        Template        Spectrum


The pilot file defines the settings of the analysis. These settings will be the same for all runs of a same run list. The pilot file follows the standard pilot convention of the GrISU package. The settings are given after a five capital letters flag which is activated if there is a * before.

a)Input Control

  • NBEVT 50000
    NBEVT sets the number of analyzed events per run. This function is useful to check if there is any problem before launching the analysis of a huge run list. 0 implies no limitation (default value).

  • NBRUN 8 2
    NBRUN is used when one wants analyze only a portion of the run list. It sets the first run by its position in the run list (here 8) and the number of run to be processed (here 2). The run list numeration starts at zero. A zero in second position implies no limitation (default value: NBRUN 0 0).
  • b)Output Control

    The default setting of all the output flags are 0. Then without * no output will be produced.

  • ROOTF 1 0 0 1 ./data.root
    ROOTF controls the root output. There is four 0/1 flags and the output root file name.
    1st flag: Fill the root TTrees
    2nd flag: Put only the reconstructed event in the root TTrees
    3rd flag: Display some plots on line
    4th flag: Write the TTrees in a root file
  • OUTFI 1 ./
    OUTFI sets the "Gamma-ray Like Events" (.gle) output file: flag and file name.

  • SUMFI 1 ./summary.txt 14
    SUMFI defines the Summary output file: flag (0 or 1), file name and the length of the path to reach the input data file (cf. run list section).

  • ENGFI 1 ./data
    ENGFI sets the energy list (.els) output files: flag and file name root. If the command above is activated, the files data_on.els and data_off.els would be produced. (or data_simu.rcs in the case of "spectrum_info" on simulation data)
  • c)Analysis settings

  • CUTTS 2 0.0225 4 2 2 325. 0.04 0.1 16 1.8 8. 0.18
    CUTTS defines the cuts parameters in the following order:
  • mode (0: just theta2 and size cut, 1: detections cuts, 2: spectrum cuts, 3: user cuts)
  • theta square cuts (deg2)
  • min pixel number (pxl)
  • min telescope pairs used for the reconstruction
  • min number of images wich have to pass the cuts
  • min image size (dc)
  • min image width (deg)
  • max image width (deg)
  • min ratio p3/ntub or (p1+p2+p3)/ntub (dc/pxl)
  • min dist_IT/length (m/deg)
  • max dist_IT/length (m/deg)
  • radical cut of the image width (deg)
  • the default settings are for the detection of a 10% crab source.
  • RECON 1
    RECON sets the reconstruction algorithm used.
    0 use the reconstruction provided by Analysis/analysis
    1 is the default and standard algorithm (vector).
    2 is an other algorithm
  • CUTTL 1 1 1 0
    CUTTL defines the used telescopes for the cuts.
    4 flags for the 4 telescopes (T1 T2 T3 T4). Default value: the 4 telescopes used.
  • RECTL 1 0 1 1
    RECTL defines the used telescopes for the reconstruction.
    4 flags for the 4 telescopes (T1 T2 T3 T4). Default value: the 4 telescopes used.
  • d)Background settings

  • ONOFF 1 6. 16.
    ONOFF followed by 1 sets the "ring background" method. Then the 2 following values define the ring design:
    value1 * theta square cut < theta square of the ring region < value2 * theta square cut
  • ONOFF 10 .5 0.
    ONOFF followed by n>1 sets the "necklace background" method. Then n is the number of OFF region around the ON region and the next value is the offset of these regions.
  • ONOFF 0 0. 0.
    ONOFF followed by 0 sets the "reflected mirror" background method. (default value)
    The settings are then controlled by the following line:
  • WOBL3 3 0. 60. -60. (applied to 0.3 deg wobble offset data)
  • WOBL5 7 0. 36. -36. 72. -72. 108. -108. (applied to 0.5 deg wobble offset data)
  • WOBL8 7 0. 36. -36. 72. -72. 108. -108. (applied to 0.8 deg wobble offset data)
  • WOB11 7 0. 36. -36. 72. -72. 108. -108. (applied to 1.1 deg wobble offset data)
  • WOB14 7 0. 36. -36. 72. -72. 108. -108. (applied to 1.4 deg wobble offset data)
  • The integer number define the number of OFF region and the following float set their angular position. Check any overlap before change these settings.
    The default setting is one OFF region opposed to the ON region ( WOBLx 1 0. 0. )
  • e)Maps and Graphics

  • 2DMAP 1 1.6 0 blue
    2DMAP sets the map flag, the field of view of one run and the palette used for the maps.
  • map flag :
    0 = no maps (default value)
    1 = maps in camera coordinates, tracked source put in the center.
    2 = maps in R.A./Decl., center define by the command ZERRO.
  • max radius of the field of view (events beyond this limit are not take into account)
  • root palette number (1 is standard)
  • palette name. if the palette number is set to 0, the palette used is the one define in "Datareader/define_palette.h" with the name entered here.
  • SZBIN 45 135 1.5
    SZBIN sets the binning and the size of the map.
    The first integer is the number of bin of ON-OFF maps.
    The 2nd integer is the number of bin of significance-rate maps.
    The float defines the size of the map: the map is a square shape plus or minus this value around the tracked source or the center defined with ZERRO.
    Default settings are: SZBIN 25 75 1.2
  • ZERRO 1.47 0.38
    ZERRO defines the center of the map in R.A./Decl. coordinates (in radian). The default center is the tracked source position of the first run of the run list.
    It works only in R.A./Decl. mode (map flag = 2)
  • SIGNI 100 -6. 14.
    SIGNI defines the binning, the min and the max of the significance histogram.
    Default settings are: SZBIN 100 -7 13
  • THETA 30 0. 0.15 0.1 0.0065 0.6
    THETA defines the binning, the min and the max of the theta square histogram.
    The two last values are the parameters of PSF fit.
    (if the parameters is set at 0. it will be free for the fit on the data)
    Default settings are: THETA 40 0. 0.16 0.01 0.73
  • RAFIT 0.1 1
    RAFIT sets the sigma of the 2D Gaussian smoothing for the rate map.
    The second value is a flag to fit the rate map with a 2D Gaussian low at find the position of the excess and its uncertainty.
    Default settings are: RAFIT 0.1 0
  • f)Source Targets

  • TARGT 2 1.45967 0.384225 Crab 1.47 0.38 source_name
    TARGT defines a list of targets for which datareader will estimate the excess and significance and write the results in the summary file.
    The first integer is the number of targets (default value is 0).
    Next is the list of R.A./Decl. coordinates (in radian) and name of the target.
    This option works only in R.A./Decl. mode (R.A./Decl provided in the run list)
  • The position of the targets will appear on the sky maps (if map flag = 2).
    The theta2 distribution, the excess and significance vs observation time will be draw for the position of the first target.
    In the significance distribution, the background will be estimate without the region around the first target

    Datareader home        Runlist        Outputs        Stage6        Template        Spectrum