|

cwb_mkfad
~~~~~~~~~~~~~~

.. note::
 The current FAD implementation is a preliminary version and it
 has some limitations, see `FAD howto <#FAD-howto>`__

|
| **Usage**
|
| This command must be executed in the simulation working directory, it
  produces the FAD files and plots.
| For this command it is necessary to have configured the
  `user\_pparameters.C <#user_pparameters_002eC>`__ file.
| The following pp parameters are used by the cwb_mkfad command:
  `pp_fad <#Others>`__,\ `T\_win <#Thresholds>`__
  ,\ `T_cor <#Thresholds>`__ ,\ `pp_irho <#Thresholds>`__
  ,\ `T_vED <#Thresholds>`__ ,\ `T_pen <#Thresholds>`__
|

 .. note::
  it is not necessary to configure the "-nzbins" in the
  pp_fad <running.html#others>`__ option 

 .. note::
  the `pp\_fad <running.html#others>`__ option can
  be defined in a separated un-named macro which name can be provided to
  the cwb_mkfad command alternatively to the nzbins parameter.

|
| **Syntax**
|

 - ``cwb_mkfad label nzbins/fad.in [optional] odir [optional] obstime [optional]``

 - **label** : same label as

   `cwb_merge <#cwb-merge>`__/`cwb_setveto <#cwb-setveto>`__

    commands

 - **nzbins/fad.in** : (default is -1)

   -  if nzbins=0 the standard FAD statistic is used
   -  if nzbin>0 the FAD statistic is computed until there are nzbins
      consecutive bins with zero events inside
   -  if nzbin<0 the FAD statistic is computed with classical FAD and
      min-hold (un-biased FAD)
   -  if the parameter is a file name the file must be a un-named ROOT
      macro which can be used to define the pp\_fad.

 - **odir** : output fad directory (default="fad")
    the output directory is created under
    report/postprod/sim\_report\_dir
    where "sim\_report\_dir" is the standard simulation report directory
    created with the `cwb_report <#cwb_report>`__ command.
    Under the "odir" the command creates the fad.html which can be used
    by a web browser to display the FAD plots.
    This is the list of created ascii/plots files :

   -  **FARvsRHO** False Alarm Rate vs RHO
   -  **REFFvsRHO** Effective Radius vs RHO
   -  **REFFvsIRHO** Effective Radius vs Inverse RHO
   -  **VISvsRHO** Visible Volume vs RHO
   -  **PRODvsFAD** Productivity vs False Alarm Density
   -  **EVTvsRHO** Number of Expected False Alarm vs RHO
   -  **FADvsRHO** False Alarm Density vs RHO
   -  **FAPvsRHO** False Alarm Probability vs RHO
   -  **RECvsINJ** Reconstructed Events vs Injected Events

 - **obstime** : zero lag observation time (sec), if 0 then it is read from live.txt

|
| **Examples**
|

 .. code-block:: bash

    cwb_mkfad M1.C_cc2_gt_0d45 -1 unbiased_fad

    cwb_mkfad M1.C_cc2_gt_0d45 fad.in fad

    cwb_mkfad M1 0 standard_fad 840000