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:

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*