Skip to content

Commit

Permalink
Started writing JOSS paper
Browse files Browse the repository at this point in the history
  • Loading branch information
ShaunFell committed Apr 18, 2024
1 parent 6f43fc1 commit ec9fcfa
Show file tree
Hide file tree
Showing 2 changed files with 97 additions and 0 deletions.
48 changes: 48 additions & 0 deletions paper/paper.bib
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
@article{Andrade2021,
doi = {10.21105/joss.03703},
url = {https://doi.org/10.21105/joss.03703},
year = {2021},
publisher = {The Open Journal},
volume = {6},
number = {68},
pages = {3703},
author = {Tomas Andrade and Llibert Areste Salo and Josu C. Aurrekoetxea and Jamie Bamber and Katy Clough and Robin Croft and Eloy de Jong and Amelia Drew and Alejandro Duran and Pedro G. Ferreira and Pau Figueras and Hal Finkel and Tiago Fran\c{c}a and Bo-Xuan Ge and Chenxia Gu and Thomas Helfer and Juha Jäykkä and Cristian Joana and Markus Kunesch and Kacper Kornet and Eugene A. Lim and Francesco Muia and Zainab Nazari and Miren Radia and Justin Ripley and Paul Shellard and Ulrich Sperhake and Dina Traykova and Saran Tunyasuvunakool and Zipeng Wang and James Y. Widdicombe and Kaze Wong},
title = {GRChombo: An adaptable numerical relativity code for fundamental physics},
journal = {Journal of Open Source Software}
}

@article{Clough2015sqa,
author = "Clough, Katy and Figueras, Pau and Finkel, Hal and Kunesch, Markus and Lim, Eugene A. and Tunyasuvunakool, Saran",
title = "{GRChombo : Numerical Relativity with Adaptive Mesh Refinement}",
eprint = "1503.03436",
archivePrefix = "arXiv",
primaryClass = "gr-qc",
reportNumber = "KCL-PH-TH-2015-40",
doi = "10.1088/0264-9381/32/24/245011",
journal = "Class. Quant. Grav.",
volume = "32",
number = "24",
pages = "245011",
year = "2015"
}

@article{Adams:2015kgr,
author = "Adams, M. and others",
title = "{Chombo software package for AMR applications - design document}",
reportNumber = "LBNL-6616E",
month = "12",
year = "2015"
}

@article{Aurrekoetxea2024,
doi = {10.21105/joss.05956},
url = {https://doi.org/10.21105/joss.05956},
year = {2024},
publisher = {The Open Journal},
volume = {9},
number = {96},
pages = {5956},
author = {Josu C. Aurrekoetxea and Jamie Bamber and Sam E. Brady and Katy Clough and Thomas Helfer and James Marsden and Miren Radia and Dina Traykova and Zipeng Wang},
title = {GRDzhadzha: A code for evolving relativistic matter on analytic metric backgrounds},
journal = {Journal of Open Source Software}
}
49 changes: 49 additions & 0 deletions paper/paper.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
---
title: 'GRBoondi: A code for evolving generalized Proca theories on arbitrary analytic backgrounds'
tags:
- c++
- MPI
- Open MP
- vector intrinsics
- generalized Proca
- gravity
- general relativity
- numerical relativity
- adaptive refinement

authors:
- name: Shaun David Brocus Fell
orcid: 0000-0002-8059-0359
affiliation: 1

affiliations:
- name: Institute for Theoretical Physics, Universitaet Heidelberg, Philosophenweg 12, 69120 Heidelberg, Germany
index: 1

date: 18-04-2024

bibliography: paper.bib
---

# Summary

Generalized Proca theories provide a rich landscape to search for solutions to deep, fundamental questions, such as the nature of dark matter. Moreover, strong gravity regimes, such as those around heavy, compact astrophysical objects, permits multimessenger probes of these fundamental fields. These measurements require accurate models in order to search through the huge quantities data. Developing these models for generalized Proca theories is an immense undertaking and usually resorts to numerical methods.

GRBoondi provides a unified interface for computing the evolution of a specific generalized proca model on any arbitrary analytic background. Given a specific background with known analytic expressions for the metric variables and initial data for the Proca field, GRBoondi numerically computes the time evolution of the Proca field, given user-specified generalized Proca equations of motion. While the full evolution of the background and matter fields in tandem provides the most complete description of the evolution, in many cases, the density of the Proca field is entirely negligible compared to the background curvature. Hence, fixed background evolution routines provide a remarkably good approximation to the full mutual evolution. A core feature of GRBoondi is that it simplifies many of the boiler-plate code required to get a simulation running from scratch. The only additions a user needs to input are the initial conditions, the modifications to the equations of motion above standard Proca, and specify the background functions. GRBoondi will automatically compute various diagnostic quantities and plot files. Moreover, GRBoondi is incredibly modular and modifications to any of the in-built functions is effortless.

The fixed background approximation provides a huge speedup, compared to the full evolution, since only a small fraction of the variables actually require a time integration. Not only do simulations now require far less resources, the speed up can be up to hundreds of times faster. GRBoondi is based on the publicly available NR code GRChombo [@Andrade2021;@Clough2015sqa], which itself is based on the open source adaptive mesh refinement (AMR)-based differential equation solver Chombo [@Adams:2015kgr]. Some minor pieces of GRBoondi are also based off the recently released open source software GRDzhadzha [@Aurrekoetxea2024], which is also based off of GRChombo.

# Statement of need

In practice, any numerical relativity software library can be used to evolve generalized Proca theories. Examples of these include (Einstein toolkit, Cactus, Kranc, LEAN, Canuda, BAM, AMSS-NCKU, PAMR, HAD, SPeC, SpECTRE, NRPy, CosmoGRaPH, GRAMSES, Simflowny, GRAthena++, GRDzhadzha)

While an extensive collection of NR libraries exist, none of them provide a tailored unified interface for studying the vast landscape of generalized Proca theories.

# Key features of GRBoondi

# Acknowledgements

# References



0 comments on commit ec9fcfa

Please sign in to comment.