Python Waveform Analysis Tools

The CoRe python package for the analysis of gravitational waves based on scidata, Matlab's WAT and pyGWAnalysis

Installation

The installation relies on standard Python library setuptools. Once the repository is cloned, the installation can be performed in two ways, depending on the choice of the user:

• Run the command python setup.py install or python setup.py install --user inside the project directory.
• Install the module via pip running the command python -m pip install inside the project directory. It is possible to include the --user option and the -e option for editing.

Requirements

The Python Waveform Analysis Tools are compatible with Python3 (Old versions of watpy were Python2 compatible).

Albeit WatPy is a Python package, it requires the following to be able to properly interface with the database:

• git version control system
• git-lfs API (Large File Storage)

The following Python packages are required for installation:

• Numpy (Python array-handler)
• Scipy (Python scientific library)
• Matplotlib (Nice visualization package)
• H5py (Pythonic interface to HDF5)

For users interested in interactive usage of this package we suggest ipyhton notebooks. These can be installed with the following packages:

• iPython (Strictly better version of the basic python shell)
• Jupyter (Notebooks, slides, HTML conversion of notebooks and more)

Content

watpy implements few classes to clone and work with CoRe waveforms.

• wave() and mwaves() for multipolar waveforms data, see wave.py
• CoRe_db() to clone the CoRe DB, add data etc, see coredb.py
• CoRe_idx() to work with the CoRe DB index, see coredb.py
• CoRe_sim() to work with simulation data in a CoRe repository, see coredb.py
• CoRe_run() to work with one simulation run data in a CoRe repository, see coredb.py
• CoRe_h5() to work with HDF5 data, see coredb.py
• CoRe_md() to manage the metadata, see metadata.py

Features

• Classes for multipolar waveform data
• Classes to work with the CoRe database
• Gravitational-wave energy and angular momentum calculation routines
• Psi4-to-h via FFI or time integral routines
• Waveform alignment and phasing routines
• Waveform interpolation routines
• Waveform's spectra calculation
• Richardson extrapolation
• Wave objects contain already information on merger quantities (time, frequency)
• Unit conversion package
• Compatible file formats: BAM, Cactus (WhiskyTHC / FreeTHC), CoRe database