Skip to content

Commit

Permalink
Update paper text with more detail and more citations
Browse files Browse the repository at this point in the history
  • Loading branch information
Deborah Ferguson authored and Deborah Ferguson committed Apr 5, 2024
1 parent c4f75ef commit 73d5f91
Show file tree
Hide file tree
Showing 2 changed files with 75 additions and 3 deletions.
65 changes: 65 additions & 0 deletions paper.bib
Original file line number Diff line number Diff line change
Expand Up @@ -524,4 +524,69 @@ @software{Bozzola_kuibit_2021
@softward{Hinder,
author = {Ian Hinder and Barry Wardell},
url = {http://simulationtools.org}
}

@software{Kastaun,
author = {Wolfgang Kastaun},
url = {https://github.com/wokast/PyCactus},
}

@software{Johnson,
author = {Daniel Johnson, E. A. Huerta, Roland Haas},
url = {https://git.ncsa.illinois.edu/elihu/Gravitational_Waveform_Extractor},
}

@article{Baumgarte:1998te,
author = "Baumgarte, Thomas W. and Shapiro, Stuart L.",
title = "{On the numerical integration of Einstein's field equations}",
eprint = "gr-qc/9810065",
archivePrefix = "arXiv",
doi = "10.1103/PhysRevD.59.024007",
journal = "Phys. Rev. D",
volume = "59",
pages = "024007",
year = "1998"
}

@article{PhysRevD.52.5428,
title = {Evolution of three-dimensional gravitational waves: Harmonic slicing case},
author = {Shibata, Masaru and Nakamura, Takashi},
journal = {Phys. Rev. D},
volume = {52},
issue = {10},
pages = {5428--5444},
numpages = {0},
year = {1995},
month = {Nov},
publisher = {American Physical Society},
doi = {10.1103/PhysRevD.52.5428},
url = {https://link.aps.org/doi/10.1103/PhysRevD.52.5428}
}

@article{Schnetter:2003rb,
author = "Schnetter, Erik and Hawley, Scott H. and Hawke, Ian",
title = "{Evolutions in 3-D numerical relativity using fixed mesh refinement}",
eprint = "gr-qc/0310042",
archivePrefix = "arXiv",
reportNumber = "AEI-2003-078",
doi = "10.1088/0264-9381/21/6/014",
journal = "Class. Quant. Grav.",
volume = "21",
pages = "1465--1488",
year = "2004"
}

@InProceedings{Goodale2002a,
author = {Tom Goodale and Gabrielle Allen and Gerd Lanfermann
and Joan Mass{\'o} and Thomas Radke and Edward
Seidel and John Shalf},
title = {The {Cactus} Framework and Toolkit: Design and
Applications},
booktitle = {Vector and Parallel Processing -- VECPAR'2002, 5th
International Conference, Lecture Notes in Computer
Science},
year = 2003,
address = {Berlin},
publisher = {Springer},
url = {http://edoc.mpg.de/3341},
}
13 changes: 10 additions & 3 deletions paper.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,9 +55,11 @@ While analytic solutions exist for the simplest cases within GR, e.g. single BHs
Approximate methods can be used when the BHs are far apart or have highly unequal masses, but the coalescence of BHs of comparable mass must be solved computationally.
Numerical relativity (NR) simulations accomplish this by evolving a BBH space-time on supercomputers, enabling us to study the dymanics of BBH systems as well as predict the GWs they emit.
The Einstein Toolkit (ETK) is a set of tools created to perform these NR simulations [@Loffler:2011ay], and `MAYA` is a branch of ETK used by the MAYA collaboration [@Herrmann_2007; @Jani:2016wkt; @Vaishnav:2007nm; @Healy:2009zm; @Pekowsky:2013ska].
The Einstein Toolkit is a finite-differencing code, evolved using the BSSN formulation [@Baumgarte:1998te; @PhysRevD.52.5428].
It is built upon the Cactus infrastructure [@Goodale2002a] with Carpet mesh refinement [@Schnetter:2003rb].

These tools allow us to study the coalescence of compact objects, their evolution, and the gravitational radiation they emit.
The `Mayawaves` library introduced in this paper is an analysis pipeline used to process and analyze such NR simulations.
The `Mayawaves` library introduced in this paper is an analysis pipeline used to process and analyze such NR simulations, specifically for BBHs.

# Statement of need

Expand All @@ -66,11 +68,16 @@ However, these simulations produce vast amounts of data that must be processed i
Additionally, given the complexity of these simulations, they are typically performed for many days or weeks across many processors, leading to data which is split into several output directories and files.
Sifting through all this data can be overwhelming for newcomers to the field and is cumbersome for even the most experienced numerical relativists.
While it is often important to develop an understanding of these files and their complexities, in many situations, a simpler, more streamlined workflow is appropriate.
There are existing tools to analyze ETK simulations including Kuibit [@Bozzola_kuibit_2021] and SimulationTools [@Hinder], but more versatile tools are still needed.
There are several existing tools to analyze ETK simulations including, but not limited to, Kuibit [@Bozzola_kuibit_2021], Power [@Johsnon], PyCactus [@Kastaun], and SimulationTools [@Hinder].
A more thorough list of post-processing tools can be found at https://docs.einsteintoolkit.org/et-docs/Analysis_and_post-processing.
Each of these tools tackles specific aspects of studying numerical relativity simulations, but more versatile tools are needed.
Several of these tools require proprietary software and others still require signicant expertise in numerical relativity data.

`Mayawaves` is an open-source python library for processing, studying, and exporting NR simulations performed using ETK and `MAYA`.
When using the library to interact with a simulation, the user does not need to be familiar with all the types of output files generated by the simulation, but rather, can think in terms of physical concepts such as *coalescences* and *compact objects*.
Mayawaves stitches together raw numerical relativity simulations and stores them in h5 files, a format that handles numerical data more efficiently than ascii.
This makes `Mayawaves` unique and particularly powerful, as it dramatically reduces the barrier to entry.
It is also versatile and easily extensible in order to perform more complex analyses.
`Mayawaves` stitches together raw numerical relativity simulations and stores them in h5 files, a format that handles numerical data more efficiently than ascii.
In addition to keeping all the data organized in one place, this also reduces the disc space taken by the simulation while still retaining the precision of the raw data.

Some of the key functionalities of this library are as follows:
Expand Down

0 comments on commit 73d5f91

Please sign in to comment.