|
cwb_eced
~~~~~~~~~~~~
This page provides a description of the cwb_eced command.
|
| **Usage**
|
| This command generates the CED of an event via command line (easy CED).
|
| **Syntax**
|
- ``cwb_eced`` (no arguments)
Prints help
- ``cwb_eced eced_opts [detector_opts]``
Generates the CED via command line
|
| **Further information**
|
The following options can be passed to the cwb_eced command:
.. code-block:: bash
eced_opts = gps_time : this is the GPS time of the event
or
'--gps gps --search search --sim sim --tag tag --cfg cfgfile'
In the above line, the various options have the following meaning:
--gps is the GPS time of the event
--search is the search type (r, i, s, g, R, I, S or G for the 1G pipeline, r for the 2G pipeline)
--tag is a label used to name the directory in which the CED is generated. If the tag is not
specified, the default tag is used (corresponding to the current GPS time).
--cfg is the name of the configuration file. The default configuration file used to generate
the easy CED is trunk/tools/cwb/macros/cwb_parameters.C. To chage the default values,
add the desired parameter values in a new file cfg.C and use the option --cfg cfg.C
--ced false : disable CED, only root file is created
detector_opts = '--ifo ifo --type type --chraw chraw --chmdc chmdc --factor factor'
In the above line, the various options have the following meaning:
--ifo is the detector name. If the gw_data_find tool is used, the input must be one
of the following: L1, H1, V1, G1
--type is the type which identifies the considered detector's data. It the same as the one used
by the gw_data_find tool. The following command lists the available types:
gw_data_find -y. Alternatively, the type can be the name of the file containing the list of
the considered frame files. Note that the name of this file must be of the format yyy.xxx .
If no type is defined, the following default values are used:
L1 -> L1_LDAS_C02_L2
H1 -> H1_LDAS_C02_L2
V1 -> Hreconline
G1 -> G1_RDS_C01_L3
--chraw is the name of the channel to be read in the frame files. If no channel is defined,
the following default values are used:
L1 -> L1:LDAS-STRAIN
H1 -> H1:LDAS-STRAIN
V1 -> V1:h_16384Hz
G1 -> G1:DER_DATA_H
--chmdc is the name of the mdc frame channel
--factor is the numerical factor used to rescale the hrss or the snr of the injected simulated signal
--shift is the detector shift time in seconds for non zero lag events (NOTE : must be integer!!!)
| The cwb_eced command creates a directory named according to the following format:
| ``ECED_net_TAGtag_GPSgps``
| where
- **net** corresponds to the considered network (e.g., L1H1V1)
- **tag** is part of the name of the directory in which the CED is saved, see above in this page.
- **gps** is the GPS time of the considered event
|
| An example of the directory's name is as follows:
| ``ECED_L1H1V1_TAG1048593634_GPS968654557``
| The following sub-directories are created in the main folder:
- **tmp:** this directory contains temporary files
- **ced:** this directory contains the CED of the event.
|
| A symbolic link is created in the user's public directory to make the CED accessible via a web browser, e.g.:
| ``~waveburst/WWW/LSC/ceds/ECED_L1H1V1_TAG1048593634_GPS968654557``
| Note that the cwb_eced command cannot be used in the simulation mode.
|
| **Examples**
|
- The examples reported in this section have been performed on the ATLAS computing cluster.
- The following command lines generate the easy CED of the hardware injection performed at 968654557 GPS time on the **L1H1V1 network** (Big Dog event):
``cwb_eced 968654557 L1 H1 V1``
or
``cwb_eced 968654557 '--ifo L1' '--ifo H1' '--ifo V1'``
- | The CED is saved at ATLAS here:
`/home/waveburst/REPORTS/ECED\_L1H1V1\_TAG1048598836\_GPS968654557 `__
and is available on the internet at the following link:
`CED link `__
|
- | The following command lines generate the easy CED of the hardware injection performed at 968654557 GPS time on the **L1H1 network** (Big Dog event):
.. code-block:: bash
cwb_eced 968654557 '--ifo L1' '--ifo H1'``
or
cwb_eced '--gps 968654557' '--ifo L1' '--ifo H1'``
or
cwb_eced 968654557 '--ifo L1 --type L1_LDAS_C02_L2' '--ifo H1 --type H1_LDAS_C02_L2'
or
cwb_eced 968654557 '--ifo L1 --type L1_LDAS_C02_L2 --channel L1:LDAS-STRAIN' '--ifo H1 --type H1_LDAS_C02_L2 --channel H1:LDAS-STRAIN'
- | The following command line generates the easy CED of the hardware injection performed at 968654557 GPS time on **H1 data** (Big Dog event):
| ``cwb_eced 968654557 H1``
The CED is saved at ATLAS here:
`/home/waveburst/REPORTS/ECED\_H1\_TAG1048598281\_GPS968654557 `__
and is available on the internet at the following link:
`CED link `__.
The same CED can be generated also starting from the H1.frames file, which contains the list of the frame files:
``cwb_eced 968654557 '--ifo H1 --type H1.frames'``
|
- | The following command line generates the easy CED of the noise event reconstructed at 934327040 GPS time on **L1 data**:
| ``cwb_eced 934327040 L1``
The CED is saved at ATLAS here:
`/home/waveburst/REPORTS/ECED\_L1\_TAG1048598553\_GPS934327040 `__
and is available on the internet at the following link: `CED
link `__.
- | The following command line generates the easy CED of an S5 event in H1 at GPS=825676252 specifing the type,chraw used in S5, ced is disabled, only root file is created:
``cwb_eced "--gps 825676252 --tag _CR --ced false" "--ifo H1 --type H1_RDS_C03_L2 --chraw H1:LSC-STRAIN"``
- | The following command line generates the easy CED of a non zero lag
L1H1V1 noise event reconstructed at 934970296 GPS time on **L1
data**, 934970296+272 GPS time on **H1 data**, 934970296+79 GPS time on **V1 data**:
|
``cwb_eced "--gps 934970296 --cfg config/user_parameters_eced.C --ced true --tag BKG"``
``"--ifo L1 --shift 0" "--ifo H1 --shift -272" "--ifo V1 --shift -79"``
The CED is saved at ATLAS here:
`/home/waveburst/REPORTS/S6A\_BKG\_LF\_L1H1V1\_2G\_RSRA\_eced `__
and is available on the internet at the following link: `CED
link `__.
.. note::
if **"-ced false"** is declared then only the standard wave\*.root is created.