nrutils is a low-level suite for working with Numerical Relativity data (i.e. gravitational waveforms) from binary black hole mergers.
There are several ways you can install nrutils
If you just want to start using nrutils
pip install git https://github.com/llondon6/nrutils_dev.git
If you want to have local copies of examples and workflows
git clone https://github.com/llondon6/nrutils_dev.git
pip install .
If you want to develop nrutils and useful if installing in a virtual environment
git clone https://github.com/llondon6/nrutils_dev.git
pip install -e .
nrutils uses a class based system where the simulation (i.e. its related metadata) is encapsulated a "simulation catalog entry" or "scentry" class. General purpose waveforms are encapsulated by the gwf
(graviational waveform) class, but the user will most likey be interested in the gwylm
class, which loads desired spherical harmonic multipoles, and then (semi-automatically) performs low level processing of data (e.g. strain calculation, ffts, windowing, plotting). In the context of the gwylm class, individual multipoles are gwf
objects.
To get a sense of how these concepts work togerther please see the core usage example. NOTE that you will need to configure or build catalog files before trying to run this example. Please see sections below for how to do this.
If you installed nrutils
in editable mode then you should edit the files in the cloned
repository otherwise you should edit the files installed in your python environment.
- nrutils/config/bam.template -> nrutils/config/bam.ini
- nrutils/config/sxs.template -> nrutils/config/sxs.ini
- nrutils/config/bam_gw150914_followup.template -> nrutils/config/bam_gw150914_followup.ini
This is done using the command scbuild()
to create a database of the NR simulations. (Documentaion incomplete)
The related example ipython notebook is:
The related example ipython notebook is:
The best way to learn what's in nrutils is to brows through the package contents and skim over the comments. The second best way to figure out what's going on is to skim though the example ipython notbooks located in the examples folder: