|
|
| (112 intermediate revisions by 15 users not shown) |
| Line 1: |
Line 1: |
| − | Here you will find a concise and straightforward guide to downloading, installing, and running the Einstein Toolkit. For a more detailed tutorial, view the [[Tutorial for New Users]].
| + | Please see https://github.com/nds-org/jupyter-et/blob/master/CactusTutorial.ipynb for build instructions on Linux, OSX and Windows. |
| − | | |
| − | ==Prerequisites==
| |
| − | | |
| − | You will need a number of packages installed in order to download the Einstein Toolkit components, and if you follow the instructions in this tutorial. On a Debian, Linux-Mint or Fedora-based system, install them as follows:
| |
| − | | |
| − | # Debian
| |
| − | su apt-get install build-essential g++ gfortran libmpich2-dev mercurial git subversion curl gnuplot
| |
| − | # Mint13 (likely Ubuntu oneiric ocelot as well)
| |
| − | sudo apt-get install libmpich2-dev gfortran g++ git mercurial subversion curl gnuplot
| |
| − | # Fedora (incomplete)
| |
| − | yum install git wget
| |
| − | | |
| − | ==Downloading==
| |
| − | | |
| − | A script called GetComponents is used to fetch the components of the Einstein Toolkit. You may download it as follows:
| |
| − | | |
| − | curl -O https://github.com/gridaphobe/CRL/raw/ET_2011_05/GetComponents
| |
| − | chmod a+x GetComponents
| |
| − | | |
| − | GetComponents accepts a thorn list as an argument. To check out the needed components:
| |
| − | | |
| − | ./GetComponents --parallel https://svn.einsteintoolkit.org/manifest/branches/ET_2012_05/einsteintoolkit.th
| |
| − | | |
| − | This checks out Cactus, the Einstein Toolkit, and Simulation Factory.
| |
| − | | |
| − | ==Configuring==
| |
| − | | |
| − | You may proceed to configure Simfactory which requires some changes for some OS.
| |
| − | | |
| − | cd Cactus
| |
| − | # for Mint13 (mpich2 needs mpl)
| |
| − | sed '/MPI_LIBS/s/mpich/mpich mpl/' <simfactory/mdb/optionlists/debian.cfg >simfactory/mdb/optionlists/mint.cfg
| |
| − | ./simfactory/bin/sim setup --optionlist=mint.cfg
| |
| − | # for Debian
| |
| − | ./simfactory/bin/sim setup --optionlist=debian.cfg
| |
| − | # for Fedora
| |
| − | ./simfactory/bin/sim setup --optionlist=fedora.cfg
| |
| − | | |
| − | Accept the default values for all options.
| |
| − | | |
| − | ==Building==
| |
| − | | |
| − | Now that you have configured Simfactory, you may build:
| |
| − | | |
| − | ./simfactory/bin/sim build --thornlist=manifest/einsteintoolkit.th
| |
| − | | |
| − | This may take a while, as it compiles all the thorns specified in manifest/einsteintoolkit.th.
| |
| − | | |
| − | ==Running==
| |
| − | The example files provided at for the most part too large to run on a single machine. You can try however to run the static_tov example which is smallest and requires about 1.3GB of RAM to run.
| |
| − | | |
| − | ./simfactory/bin/sim submit static_tov --parfile=par/static_tov.par --procs=1 --walltime=8:0:0
| |
| − | ./simfactory/bin/sim show-output --follow static_tov
| |
| − | | |
| − | TODO: create smaller parameter file
| |
| − | TODO: measure how long simulation runs
| |