Changes between Version 37 and Version 38 of AnugaParallel

Timestamp:

Mar 12, 2015, 2:44:52 PM (11 years ago)

Author:

steve

Comment:

--

AnugaParallel

@@ -1 +1 @@
 == INSTALLING anuga_parallel ==
 
-=== Note ===
-
-We use  {{{******}}} to represent the name of your home directory. So when running the commands below always replace {{{******}}} with the name of your home directory.
-
-=== Install anuga ===
-
-First you should install the most uptodate version of the code. Follow the [InstallUbuntuSvn instructions] to install anuga on Ubuntu. By following  those instructions you should end up with a download of the anuga_core code (which contains the sequential code (in the source/anuga directory) and the anuga_parallel code (in source/anuga_parallel)). 
-
-You should end up with a directory 
-{{{
-/home/******/anuga_core
-}}} 
-
-
-Make sure you have setup your PYTHONPATH to point to the anuga source directory
-
-For instance I have the following line in my .bashrc file
-
-{{{
-export PYTHONPATH=/home/******/anuga_core/source
-}}}
-
-At this stage you should have a working version of the sequential anuga program. I.e. you should be able to run command
-{{{
-python test_all.py
-}}}
-from the anuga_core directory and have your installation pass all the unit tests (well nearly all, as this is the development version and there are sometimes a few minor unit tests that fail).
+
+If you installed {{{anuga}}} and with the {{{ANUGA_PARALLEL}}} environment set via
+
+{{{
+export ANUGA_PARALLEL="mpich2"
+}}}
+
+or 
+{{{
+export ANUGA_PARALLEL="openmpi"
+}}}
+
+then you should already have parallel support. 
+
+
+== Setting up parallel support ==
+
+Let's suppose that you initially only set up {{{anuga}}} to run in sequential mode. Then to setup parallel mode you will need to install an {{{MPI}}} environment (mpich2 or openmpi) and the python wrapper {{{pypar}}}.
+
+We will assume you have install {{{anuga}}} from source and the source is in the directory {{{anuga_core}}}
 
 
@@ -41 +34 @@
 
 {{{
-python compile_all.py
-python test_all.py
+sudo python setup.py install
+python runtests.py
 }}}
 
@@ -50 +43 @@
 === Install anuga_parallel ===
 
-Now to get anuga_parallel to work, we need to install some other packages first, in particular {{{MPI}}} for the parallel message passing and {{{pypar}}} a simple python wrapper of {{{MPI}}}. 
+Now to get parallel version of {{{anuga}} to work, we need to install some other packages first, in particular {{{MPI}}} for the parallel message passing and {{{pypar}}} a simple python wrapper of {{{MPI}}}. 
 
 ==== MPI ====
@@ -72 +65 @@
 
 ==== pypar ====
-
-
 
 We use pypar as the interface between mpi and python. The most recent version of PYPAR is available from 
@@ -86 +77 @@
 }}}
 
-This produces a directory
-{{{
-/home/******/pypar
-}}}
-
-Change to the {{{/home/******/pypar/source}}} directory, and then run the command
+This produces a directory {{{pypar}}}
+
+Change to that directory, and then run the command
 
 {{{
@@ -117 +105 @@
 ==== Compile {{{anuga_parallel}}} code ====
 
-In the anuga_parallel directory there are two subdirectories {{{pymetis}}} and {{{pypar_extras}}}
-which contain files that need compiling. The easiest way to do this is to return to the {{{anuga_core}}} directory
-and run the {{{compile_parallel_all.py}}} script.
-
-I.e. run the following two commands
-
-{{{
-cd /home/******/anuga_core/
-python compile_parallel_all.py
-}}} 
+Actually the parallel code is already in the {{{anuga_core}}} directory. We just need to reinstall {{{anuga}}}.
+
+From the {{{anuga_core}}} directory force a rebuild and reinstall  of {{{anuga}}} via
+
+{{{
+sudo python setup.py build -f
+sudo python setup.py install
+}}}
 
 
@@ -132 +118 @@
 === Running anuga_parallel  ===
 
-You should now be ready to run some parallel anuga code. Go back to the anuga_parallel directory and run the tests
-
-{{{
-cd /home/******/anuga_core/source/anuga_parallel
-python test_all.py
-}}}
-
-Hopefully that all works. There will be some output which are warning messages generated by the unit tests
-checking out various error situations. 
+You should now be ready to run some parallel anuga code. 
+
+{{{
+python runtests.py
+}}}
+
+Hopefully that all works. If you are observant you should see that the number of unittests has increased by about 30, those are the parallel tests. 
 
 ==== Example program ====
 
+From the {{{anuga_core/examples/parallel}}} directory:
 Run run_parallel_sw_merimbula.py