Difference between revisions of "Simplified Tutorial for New Users"

From Einstein Toolkit Documentation
Jump to: navigation, search
(add static TOV)
 
(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
 

Latest revision as of 15:12, 24 July 2020

Please see https://github.com/nds-org/jupyter-et/blob/master/CactusTutorial.ipynb for build instructions on Linux, OSX and Windows.