Triangle-BBH

Frequency-domain BBH TDI-2.0 response template and basic analysis tools, including the TDI-2.0 response wrappers of 2 waveforms: (1) the IMRPhenomD & HM waveform of BBHx (CPU & GPU) and (2) the IMRPhenomD & HM waveform of WF4PY (CPU only). The responses are consistent with the time-domain simulations of Triangle-Simulator (see Example 3). Also offered is an illustrative example (Example 4) for the preliminary analysis of Taiji Data Challenge II (TDC II), nevertheless, it should not be regarded as a solution to all the challenges. There are at least three factors in TDC that this examples do not account for: 1) more realistic noises, 2) signal overlap, 3) more complex waveforms. Besides, Example 0 - 2 might be useful for the researchers who are interested in studying GW sciences with Bayesian method.

Installation

Tested platforms: Ubuntu22.04 (recommanded), MacOS15 (only WF4Py CPU waveform). While we donot ensure that installation will success on all the unix systems, even the aforementioned two.

1. Install Triangle-Simulator
   Install Triangle-Simulator and activate the tri_env environment by

   conda activate tri_env 

2. Download or Clone the Repository, then

   cd Triangle-BBH

3. Install WF4PY
   Install modified WF4PY (optional, if use WF4PY CPU waveform):

   cd WF4Py 
   pip install . 
   cd .. 

4. Install BBHx
   Install BBHx (optional, if use BBHx GPU waveform): follow the instructions of BBHx. For a brief instruction, please unzip the BBHx package in this repo, enter the folder and run

   conda install -c conda-forge gcc_linux-64 gxx_linux-64 gsl lapack=3.6.1 Cython
   

   then

   pip install cupy-cudaxx.xx
   

   with xx.xx being the version of cupy that is compatible with your cuda toolkits. Then install BBHx from source:

   python setup.py install 
   

5. Install Triangle_BBH

   pip install -e . 

6. Install MCMC Tools to Run the Examples

   pip install eryn corner  

Comparison with time-domain simulation

References

Please make sure to cite BBHx or WF4PY if Triangle-BBH is used in your published research.

• The TDC II paper.
• The frequency-domain detector response formalism of inspiral-merger-ringdown waveforms for space-based detectors: S. Marsat et al, arXiv:1806.10734, S. Marsat et al, Phys. Rev. D 103, 083011 (2021)
• BBHx: BBHx documentations
• WF4PY: WF4PY documentations