/TianQinGWSpace

Primary LanguageJupyter NotebookGNU General Public License v3.0GPL-3.0

GWSpace: A multi-mission Science Data Simulator for Space-based Gravitational Wave Detection

GWSpace is a multi-mission science data simulator for space-based gravitational wave detection. It is a Python package that can compute correlated gravitational wave signals that could be detected by TianQin, LISA and Taiji simultaneously in a possible joint detection scenario, either in time domain (GCB, EMRI and Burst) or in frequency domain (BHB and SGWB). For more details, see doc file or arXiv:2309:15020.

gwspace-structure

Quick install

python setup.py install --with-gsl=/your/gsl/path

GW waveforms

As seen in the figure above, we use different waveforms for different gravitational wave sources:

  • EMRI: FastEMRIWaveforms or few

    • We use FastEMRIWaveforms for EMRI. If you want to do data analysis of EMRI, you have to install it manually.

    • Need to install gsl and lapack

  • Galactic compact binary: FastGB and GCBWaveform

    • FastGB: a modified version of galactic compact binary (GCB) waveform generation code, which is based on the implementation of Galaxy in the Mock LISA Data Challenge (MLDC). The code using a fast/slow decomposition of the waveform to reduce the computational cost, for more details about the original construction of the method see arXiv:0704.1808. It will be automatically compiled during the installation.
    • GCBWaveform: a Python code to generate the waveform of GCB in time domain.

  • Binary black hole (BBH): PyIMRPhenomD and pyIMRPhenomD

    • PyIMRPhenomD: implements the IMRPhenomD waveform in a pure python code, compiled with the numba just in time compiler. If you prefer using this code, you need to install it manually.
    • pyIMRPhenomD: a C code developed by Michael Puerrer to implement the IMRPhenomD waveform. It will be compiled automatically.

  • Stellar-mass BBH (with eccentricity): EccentricFD

    • This is a modified version of EccentricFD waveform, which is specially for space-detector responses.

    • If you want to check the original codes, see files in LALSuite

    • If you want a pure modified version of this waveform, check this link

  • Stochastic gravitational wave background (SGWB):

    • With the help of healpy to generate a SGWB signal of power law type.

Library dependence

C language: gsl:

All waveforms will be compiled with gsl.

  • To find the lib path of gsl:
echo $LD_LIBIARY_PATH | grep gsl
  • To find the software installed manually:
ldconfig -p | grep gsl

Python package:

check requirements.txt for details, or you can directly install them by

pip install -r requirements.txt

For EMRI: install lapack & lapacke

  • As lapack-3.11.0 already includes lapacke, you can compile the lapack, and then enter the LAPACKE dir, and compile lapacke.
  • The generated lib liblapacke.a will be generated at the top dir.
  • Copy the liblapacke.a and liblapack.a to your lib path (e.g. /usr/local/lib)
  • Copy files in the LAPACKE/include to your include path (e.g. /usr/local/include)

Author lists