|

cwb_inet2G
~~~~~~~~~~~~~~

This page provides a description of the cwb_inet2G command.

|
| **Usage**
|
| This command is used to run the cWB 2G pipeline in the interactive mode.
|
| The 2G pipeline consists of different stages. The output of each stage is saved in a ROOT file, which also contains the configuration settings.  Thus, it is possible to perform the analysis over a specific stage without running the pipeline from the initial stage.
|
| **Syntax**
|

 - ``cwb_inet2G`` (no arguments)
    Prints help
 - ``cwb_inet2G ifile stage [jobID/user_parameters.C] [options] [mdc_factor] [lag] [ced_dir]``
    Runs the 2G pipeline in the interactive mode

|
| The options are not mandatory.
|

|
| **Further information**
|

 The following options can be passed to cwb_inet2G:

 .. code-block:: bash

    ifile =   jobFile       : output ROOT file generated by the previous analysis stage

              userConfig    : user's parameter file (config/user_parameters.C in the "input" directory)



    stage =  FULL    : it runs the whole analysis

             INIT:             

             STRAIN:           

             CSTRAIN:         

             COHERENCE:       

             SUPERCLUSTER:    

             LIKELIHOOD: 




    jobID/user_parameters.C =  it is equal to "job id" if the analysis is started from the initial stage of the cWB 
                               pipeline. Otherwise, the user can simply provide the name of the stage to be completed. 
                               In the case of a multiresolution analysis, at a given stage and with respect to those 
                               used for the previous stages, the user can pass as option a new version of the 
                               user_parameters.C. This way it is possible to perform analyses at different stages 
                               with different values of the search parameters.





    options =  false      :  cWB does not produce the CED of the events

               true/ced   :  with both options, cWB produces the CED of the events

               --tool psd --ifo H1/L1/V1 --type strain/mdc/white --draw true/false    :  it draws the psd

                        Stages :   STRAIN : strain/mdc, CSTRAIN : white
                        Ex:    '--tool psd --ifo H1 --type strain --draw true'
                        Ex:    '--tool psd --ifo H1 --type strain --draw true --save true'

               --tool inj --draw true/false    :  it draws the injected simulated signals

                        Stages :   STRAIN
                        Ex:    '--tool inj --draw true'

               --tool nRMS --ifo H1/L1/V1 --draw true/false    :  it draws the nRMS
     
                        Stages :   CSTRAIN
                        Ex:    '--tool nrms --ifo H1 --draw true'

               --tool frdisplay --ifo H1/L1/V1 --type strain/mdc/white    :  it draws the data with frdisplay

                        Stages :   STRAIN : strain/mdc, CSTRAIN : white
                        Ex:    '--tool frdisplay --hpf 50 --decimateby 16 --ifo H1 --type strain'

               --tool wdm --ifo H1/L1/V1 --type strain/mdc/white --draw true/false    :  it draws the wdm

                        Stages :   STRAIN : strain/mdc, CSTRAIN : white
                        Ex:    '--tool wdm --ifo H1 --type white --draw true'

               --tool emax --level xx (optional) --draw true/false    :  it draws the maximum energy
                        Stages :   COHERENCE
                        Ex:    '--tool emax --level 7 --draw true'

               --tool sparse --ifo H1/L1/V1 --draw true/false    :  it draws the sparse

                        Stages :   LIKELIHOOD
                        Ex:    '--tool sparse --ifo H1 --draw true'

               --tool ced --draw true/false -> draw ced

                        Stages :   LIKELIHOOD
                        Ex:    1 0 '--tool ced --draw true'


    mdc_factor  =  numerical factor used to rescale the amplitude of the injected MDC simulated signal

    lag         =  lag number [-1 = select all lags defined in the user parameters file]

    ced_dir     =  it is the directory where the CED is generated (default : data)

|
| **Examples**
|

 - The following command launches a complete analysis with the 2G pipeline:

     ``cwb_inet2G   config/user_parameters.C   FULL   1``

 - The following command lines launch a complete multistage 2G analysis:

     ``cwb_inet2G  config/user_parameters.C    INIT   1``

     ``cwb_inet2G  data/jobFile.root           STRAIN``

     ``cwb_inet2G  data/jobFile.root           CSTRAIN``

     ``cwb_inet2G  data/jobFile.root           COHERENCE``

     ``cwb_inet2G  data/jobFile.root           SUPERCLUSTER``

     ``cwb_inet2G  data/jobFile.root           LIKELIHOOD``

     At the end of each intermediate stage an output data/jobFile.root file is created, containing all the information required for the following stage

 - The following command lines launch two steps of a multistage analysis conducted with the 2G pipeline:

     ``cwb_inet2G  config/user_parameters.C    SUPERCLUSTER   1``

     ``cwb_inet2G  data/jobFile.root           LIKELIHOOD``

 - The following command line enables the change of 2G analysis options:

    ``cwb_inet2G  data/jobFile.root            LIKELIHOOD  config/user_parameters.C``

 - The following command line allows to monitor the 2G analysis data:

    ``cwb_inet2G  data/jobFile.root            COHERENCE "" '--tool emax --level 8  --draw true'``

 - The following command line allows to process the second stage of run=205, lag=410, ced=true, mdc\_factor=0, output ced\_dir=data, config=config/user\_parameters.C :


    ``cwb_inet2G output/supercluster_1124218800_600_BKG_run1_job205.root LIKELIHOOD config/user_parameters.C ced 0 410 data``

 - The following link reports a complete example of how to perform the 2G multistage analysis:q\*

    `ADV\_SIM\_SGQ9\_L1H1V1\_2G <#ADV_SIM_SGQ9_L1H1V1_2G>`__