Simplified Tutorial for New Users - Revision history

Rhaas at 15:12, 24 July 2020

2020-07-24T15:12:45Z

Rhaas: wipe content and point to new user tutorial to avoid duplication

2020-07-24T15:12:02Z

wipe content and point to new user tutorial to avoid duplication

Show changes

Rhaas: add warning about out of date tutorial

2019-03-31T19:39:08Z

add warning about out of date tutorial

Rhaas: fix link to Cactus user guide

2019-03-30T01:08:04Z

fix link to Cactus user guide

Rhaas: modernize further reading section

2019-03-30T01:06:40Z

modernize further reading section

Rhaas: remove proposals to reduce things GetComponents downloads

2019-03-28T20:08:40Z

remove proposals to reduce things GetComponents downloads

Rhaas: remove --with-fortran from hdf5 install instructions

2019-03-15T15:35:59Z

remove --with-fortran from hdf5 install instructions

Rhaas: update macports gcc to gcc8

2019-02-15T23:00:02Z

update macports gcc to gcc8

Boud: /* Downloading */ s/a+x/u+x/ - should run in user space - no need (or point) in giving group or world execute access

2018-10-11T13:28:51Z

‎Downloading: s/a+x/u+x/ - should run in user space - no need (or point) in giving group or world execute access

Boud: /* Speed up installation by using native packages */ no point bolding debian/stretch - the obsolete comment on jessie should be enough

2018-10-11T13:18:00Z

‎Speed up installation by using native packages: no point bolding debian/stretch - the obsolete comment on jessie should be enough

←Older revision		Revision as of 15:12, 24 July 2020
Line 1:		Line 1:
−	https://~~docs.einsteintoolkit~~.org/et~~-docs~~/~~Compiling_the_Einstein_Toolkit~~	+	Please see https://github.com/nds-org/jupyter-et/blob/master/CactusTutorial.ipynb for build instructions on Linux, OSX and Windows.

←Older revision		Revision as of 19:39, 31 March 2019
Line 1:		Line 1:
		+	{\|
		+	\|-
		+	\| [[File:warning.png\|128px\|frameless\|warning]] \|\| This tutorial has not (and will not be) updated for the "Proca" (2019_03) release of the Einstein Toolkit and the instructions provided here will fail if using <nowiki>ET_2019_03</nowiki> instead of <nowiki>ET_2018_09</nowiki>. Please use either the [https://www.einsteintoolkit.org/documentation/new-user-tutorial online tutorial] or the [https://nbviewer.jupyter.org/github/nds-org/jupyter-et/blob/master/CactusTutorial.ipynb offline version of the tutorial notebook] which will be kept up to date. The notebooks contain the same shell commands as used here and they can be copied & pasted into a terminal if desired. \|\| [[File:warning.png\|128px\|frameless\|warning]]
		+	\|}
		+
	Here you will find a step by step guide to downloading, installing, and running the Einstein Toolkit. This tutorial is aimed at Cactus beginners that have never used Cactus before. As such it does not expect any familiarity with Cactus terms and is intended to work on a newly installed workstation or laptop. If you find something that does not work, please feel free to edit the wiki or mail [mailto://users@einsteintoolkit.org users@einsteintoolkit.org]. For a more detailed tutorial, view the [[Tutorial for New Users]].		Here you will find a step by step guide to downloading, installing, and running the Einstein Toolkit. This tutorial is aimed at Cactus beginners that have never used Cactus before. As such it does not expect any familiarity with Cactus terms and is intended to work on a newly installed workstation or laptop. If you find something that does not work, please feel free to edit the wiki or mail [mailto://users@einsteintoolkit.org users@einsteintoolkit.org]. For a more detailed tutorial, view the [[Tutorial for New Users]].

@@ Line 132: / Line 132: @@
 ==Further reading==
 The following resources provide more in-depth explanations of the tools and concepts used in this tutorial
-* [http://einsteintoolkit.org/documentation/UsersGuide/UsersGuide.html Cactus users guide] containing detailed information on a thorn structure and the support routines offered by Cactus. Also available in the 'doc' folder of your Cactus checkout in the file 'doc/UsersGuide.pdf'
+* [https://einsteintoolkit.org/usersguide/UsersGuide.html Cactus users guide] containing detailed information on a thorn structure and the support routines offered by Cactus. Also available in the 'doc' folder of your Cactus checkout in the file 'doc/UsersGuide.pdf'
 * [https://github.com/stevenrbrandt/CactusTutorial CactusTutorial] the Cactus tutorial held in 2018 in [https://centra.tecnico.ulisboa.pt/network/grit/einsteintoolkit2018/ Lisbon]
 * [http://simfactory.org/info/documentation/ Simfactory users guide] which describes the available command for simfactory

@@ Line 133: / Line 133: @@
 The following resources provide more in-depth explanations of the tools and concepts used in this tutorial
 * [http://einsteintoolkit.org/documentation/UsersGuide/UsersGuide.html Cactus users guide] containing detailed information on a thorn structure and the support routines offered by Cactus. Also available in the 'doc' folder of your Cactus checkout in the file 'doc/UsersGuide.pdf'
 * [http://simfactory.org/info/documentation/ Simfactory users guide] which describes the available command for simfactory
 * [https://svn.einsteintoolkit.org/documents/Workshop_Spring_2012/handson_viz/handson_viz.pdf visualization] the visualization lecture of the new user's tutorial held at the APS meeting in Atlanta 2012
 * [[ET_Workshop_Spring_2012|course page]] of the new user's tutorial held at the APS meeting in Atlanta 2012
 * The [[Main Page#Documentation|Documentation]] section of the wiki

←Older revision		Revision as of 20:08, 28 March 2019
Line 137:		Line 137:
	* [[ET_Workshop_Spring_2012\|course page]] of the new user's tutorial held at the APS meeting in Atlanta 2012		* [[ET_Workshop_Spring_2012\|course page]] of the new user's tutorial held at the APS meeting in Atlanta 2012
	* The [[Main Page#Documentation\|Documentation]] section of the wiki		* The [[Main Page#Documentation\|Documentation]] section of the wiki
−
−	~~==TODO (experts only)==~~
−	* [http://cactuscode.org/pipermail/users/2018-September/003634.html proposal for semi-automating a preference for native packages]

@@ Line 14: / Line 14: @@
   sudo port -N install pkgconfig gcc8 openmpi fftw-3 gsl jpeg zlib hdf5 +fortran +gfortran openssl
   # Mac OS (High Sierra), [https://brew.sh/ Homebrew]
-  brew install gnuplot pkg-config gcc fftw gsl hdf5 --with-fortran hwloc jpeg openssl pkg-config szip open-mpi
+  brew install gnuplot pkg-config gcc fftw gsl hdf5 hwloc jpeg openssl pkg-config szip open-mpi
 For Windows 10, please install the Ubuntu Linux subsystem, then follow the instructions for a Ubuntu system. [https://docs.microsoft.com/en-us/windows/wsl/install-win10 These] are Microsoft's official instructions on how to do so, [https://www.howtogeek.com/249966/how-to-install-and-use-the-linux-bash-shell-on-windows-10/ these] are less official but slightly easier to read instructions to do the same. You may also want to install an [https://sourceforge.net/projects/vcxsrv/ X11 server] to provide graphical output.

@@ Line 12: / Line 12: @@
   su -c ' yum -y install mpich2 python pkg-config mpich2-devel gsl gsl-devel libjpeg-devel hdf5 hdf5-mpich-devel gcc gcc-c++ gcc-gfortran patch numactl-devel numactl hwloc subversion git openssl-devel lapack-static gnuplot'
   # Mac OS (High Sierra), [https://www.macports.org/index.php MacPorts]
-  sudo port -N install pkgconfig gcc7 openmpi fftw-3 gsl jpeg zlib hdf5 +fortran +gfortran openssl
+  sudo port -N install pkgconfig gcc8 openmpi fftw-3 gsl jpeg zlib hdf5 +fortran +gfortran openssl
   # Mac OS (High Sierra), [https://brew.sh/ Homebrew]
   brew install gnuplot pkg-config gcc fftw gsl hdf5 --with-fortran hwloc jpeg openssl pkg-config szip open-mpi

@@ Line 42: / Line 42: @@
   curl -O -L https://raw.githubusercontent.com/gridaphobe/CRL/ET_2018_09/GetComponents
-  chmod a+x GetComponents
+  chmod u+x GetComponents
 GetComponents accepts a thorn list as an argument. To check out the needed components:

@@ Line 26: / Line 26: @@
 Installing in addition packages for (these are Debian package names, so your mileage may vary)
-'''debian/stretch''':
+''debian/stretch'':
   libfftw3-dev libgsl-dev libatlas-base-dev libjpeg-dev libssl-dev libhdf5-serial-dev libhwloc-dev hwloc-nox liblorene-dev libpapi-dev libpfm4-dev