Home

Welcome to the GRDzhadzha wiki!

We have put together the following set of documentation which we hope will help you to get started using GRDzhadzha. A contents bar should be shown on the right hand side of the wiki (or below if you are on a small screen) to help you navigate the documentation.

Here are some suggestions on where to start depending on what you want to know:

• I want to know if GRDzhadzha is the right code for my research project

The current capabilities of the GRDzhadzha code are detailed on the page Capabilities. Note that GRChombo (as well as this fixed background version of it) is not designed to be used as a "black box" numerical relativity code - you will need to be willing to take time to understand how the code works, and to write new tools for your specific application if required. The code is designed so as to be easy and robust to adapt to new problems, but that adaptability inevitability comes at a cost in terms of simplicity of use.

In particular, if you are a supervisor planning to ask your student to work with GRDzhadzha, please consider whether you have sufficient background in numerical relativity and C++ coding to support them properly. We are unable to provide in depth support and whilst we have done our best to make it accessible, the code is far from straightforward for new users, especially those without an HPC background.

• I want to know how to compile and run some examples to see how it works, like a scalar field on a black hole background

You will need to follow the Getting started part of the wiki. It is designed to be worked through sequentially and assumes only a basic knowledge of the command line. Note that although some guidance on laptop compilation is given, to run any kind of meaningful example you will need access to a high performance computing cluster.

• I have some experience in numerical simulations in GR and want to understand how to use and amend the code for my research project

You will probably still need to follow the compilation instructions in Getting started before moving on to the sections on Doing physics with GRDzhadzha. These pages only give a broad outline of the structure of the code and our design philosophy for new examples. If you need further guidance you should contact us, and we will do our best to help. (However, note that the informal GRChombo motto is "if you want it, you build it".) Please note our License and Citation guidance.

• I use GRDzhadzha and I want to report a bug

Please file an issue in GitHub detailing the exact version of the code you are using (ideally identified with the commit hash) and provide sufficient detail for us to recreate the problem. You can also Contact us, but raising an issue is preferred if the problem is code related.

If you updated an old version of the code to the latest version, you may want to check the latest GRChombo updates as a potential cause of your issues.

• I use GRDzhadzha and I want to contribute to the code

Great! Please see Contributing to GRDzhadzha for more details.

DISCLAIMER: Whilst we have done our best to only include things which are well tested, we can't guarantee that everything works perfectly. Use of GRDzhadzha is at your own risk!