This page provides a guide to the installation of the cWB pipeline.
The easiest way to start using cWB on your computer is to install an “image” of cWB within a “virtualized” environment: you can freely choose between the cWB VirtualBox image and the cWB Docker container. Instructions on how to run cWB on VirtualBox and Docker are reported in the cWB User Manual, here and here, repectively.
Before the installation of cWB, it is necessary to install the auxiliary libraries needed to run an analysis with cWB. In case the user makes use of the cWB libraries on the LIGO-Virgo clusters, the pre-installed auxiliary libraries can be considered, in case go to cWB install. In case the user wants to install the cWB libraries on his/her local computer, the auxiliary libraries must be present on the same machine.
The cWB libraries have been tested mainly on Scientific Linux and Debian Linux distributions (though we don’t expect major problems from installing cWB on different Linux distributions). cWB can also be installed on Mac OS X (with some minor modifications).
How to install the auxiliary libraries¶
For Scientific Linux 7.6 (Nitrogen) it is possible to download a tgz file with all pre-compiled auxiliary libraries from this link: cWB_Auxiliary_Libraries_SL76_64bit_v3.tgz or from CIT cluster : cWB_Auxiliary_Libraries_SL76_64bit_v3.tgz
First, the directories where the packages will be imstalled must be created:
setenv HOME_LIBS "user libraries path" mkdir $HOME_LIBS cd $HOME_LIBS mkdir ROOT FRAMELIB HEALPix CFITSIO BAUDLINE LAL CVODE SKYMAP WAT
- ROOT is an object oriented framework for large scale data analysis
- HEALPix is an acronym for Hierarchical Equal Area isoLatitude Pixelization of a sphere
- CFITSIO is a library of C and Fortran subroutines for reading and writing data files in FITS (Flexible Image Transport System) data format
- FRAMELIB is a software (Frame Library) dedicated to the frame manipulation including file input/output
- Baudline is a time-frequency browser designed for scientific visualization of the spectral domain.
- LAL is a package including various gravitational wave data analysis routines
- CVODE (used by eBBH) solves initial value problems for ordinary differential equation (ODE) systems
The following table reports the list of the auxiliary libraries and their instructions:
|CFITSIO||mandatory||needed by HEALPix|
|LAL||optional||nedeed for CBC simulation|
|CVODE||optional||needed by eBBH simulation|
How to install the cWB libraries¶
Two scenarios are considered:
The user wants to perform an analysis with a local copy of the cWB libraries: Installing a local copy of the cWB libraries.
recommended for users willing to use a specific version and/or customize the libraries
The user wants to perform an analysis with the libraries already installed in the LVC computing clusters
Pre-installed Librares could be outdated and may be changed without any notice. If you need a specific version you have to install a local copy of the cWB library
The CWB libraries are available in the following computing clusters: CIT and CNAF. The pre-installed libraries can be used by running the cWB configuration file. The environment is set up as follows (assuming bash shell):
source $HOME_LIBS/GIT/cWB/library/[cit/cnaf]_watenv.sh cp $HOME_LIBS/GIT/cWB/library/tools/cwb/cwb.rootrc ~/.rootrc
The $HOME_LIBS path depends on the cluster:
CIT: /home/waveburst/SOFT CNAF: /opt/exp_software/virgo/virgoDev/waveburst/SOFTFor the tcsh shell, replace *_watenv.sh with *_watenv.csh.