The Einstein Toolkit is hosted on many different machines around the world. We provide a script called GetComponents to simplify downloading the toolkit. This page just describes how to download the toolkit - you may also be interested in the Tutorial for New Users which leads you through these steps and more.
Users of the Einstein Toolkit are encouraged to register which also offers the registrant the opportunity to sign up for the users mailing list.
If you use the Einstein Toolkit in a publication please cite the requested citations.
The development of production level scientific software, such as the components of the Einstein Toolkit, represents the academic output of researchers. These scientific contributions should be acknowledged and respected on par with those solely based in theory or experiment.
This is the recommended version of the toolkit for most users. See the release notes for more information.
Enter the directory on your machine in which you would like to download the ET (for example, your home directory), and type the commands listed below. This will create a directory called Cactus in which the components of the Einstein Toolkit are downloaded.
curl -kLO https://raw.githubusercontent.com/gridaphobe/CRL/ET_2024_05/GetComponents chmod a+x GetComponents ./GetComponents --shallow https://bitbucket.org/einsteintoolkit/manifest/raw/ET_2024_05/einsteintoolkit.th
Your download may fail if the version of OpenSSL used by subversion and git is too old (older than version 1.0.1 from 2012). In this case you should update your software stack.
The SelfForce-1D code should be checked out separately from the rest of the toolkit as it is not a Cactus component. This can be done using the commands listed below.
git clone -b ET_2024_05 https://bitbucket.org/peterdiener/selfforce-1d.git SelfForce-1D
Kuibit, the Python package for post-processing and visualizing simulations, is installed with
pip install --user -U kuibit==1.5.0 # requires Python3 version 3.7 or greater
Einstein Toolkit comes with several kuibit scripts in Cactus/utils/Analysis/kuibit/examples.
curl -kLO https://raw.githubusercontent.com/gridaphobe/CRL/master/GetComponents chmod a+x GetComponents ./GetComponents --no-shallow https://bitbucket.org/einsteintoolkit/manifest/raw/master/einsteintoolkit.th
And for the SelfForce-1D code.
git clone https://bitbucket.org/peterdiener/selfforce-1d.git SelfForce-1D
The last stable version of Kuibit is installed with
pip install --user -U kuibit
The Einstein Toolkit has been tested on many different large-scale production resources and can be compiled and run on just about any laptop, workstation, cluster or supercomputer with standard HPC software installed. The main requirements are: