grtlcollaboration / grdzhadzha

A code to evolve matter on curved spacetimes with an analytic time and space dependence, e.g. black holes

GRDzhadzha

GRDzhadzha is an open-source code for general relativity simulations of matter fields on a fixed black hole background, based on the publicly available 3+1D numerical relativity code GRChombo. It is developed and maintained by a collaboration of numerical relativists with a wide range of research interests, from early universe cosmology to astrophysics and mathematical general relativity.

GRDzhadzha is written entirely in C++14, using hybrid MPI/OpenMP parallelism to achieve good performance on the latest architectures. It inherits all of the capabilities of the main GRChombo code, which makes use of the Chombo library for adaptive mesh refinement.

Getting started

Detailed installation instructions and usage examples are available in our wiki, with the home page giving guidance on where to start.

Contributing

We welcome feedback, bug reports, and contributions. Please consult the wiki for our coding style and testing policy before filing a pull request.

License

GRDzhadzha is licensed under the BSD 3-Clause License. Please see LICENSE for details.

Citation

If you use GRDzhadzha as part of a paper, please cite our paper which has been submitted for review in the Journal of Open Source Software:

@article{Aurrekoetxea:2023fhl,
    author = "Aurrekoetxea, Josu C. and Bamber, Jamie and Brady, Sam E. and Clough, Katy and Helfer, Thomas and Marsden, James and Traykova, Dina and Wang, Zipeng",
    title = "{GRDzhadzha: A code for evolving relativistic matter on analytic metric backgrounds}",
    eprint = "2308.08299",
    archivePrefix = "arXiv",
    primaryClass = "gr-qc",
    month = "8",
    year = "2023"
}

as well as the GRChombo JOSS publication, which has the following BibTeX reference:

@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}
}

grdzhadzha's Issues

Minor amends to code on review

Just starting a thread here for any minor naming / bug issues notices when people review the code.

A first one - the README.md file needs updating :-)

General code comments to be actioned

• Params should be commented out if we want to default them to specific values
• the extraction params are mostly defaulted - in particular the level is hard coded so should not be a param
• remove prePlotLevel if not used
• why is there a source for the angular momentum? Kerr has an angular killing symmetry, so this should be zero?
• As James mentioned - the excision should be outside the inner horizon for KS