Changeset 8191 for trunk/anuga_core/source/anuga_parallel/INSTALL-README

Timestamp:

Jul 7, 2011, 10:23:57 AM (13 years ago)

Author:

steve

Message:

Just adding an install readme for anuga_parallel

File:

• trunk/anuga_core/source/anuga_parallel/INSTALL-README (modified) (4 diffs)

trunk/anuga_core/source/anuga_parallel/INSTALL-README

@@ -1 +1 @@
 
-
+=========================
 INSTALLING anuga_parallel
+=========================
 
 MPI
+===
 
-First thing is to install MPI on your system. OPENMPI and MPICH2 are supported.
+First thing, you need to install MPI on your system. OPENMPI and MPICH2 
+are supported by pypar (see below) so both should be ok. 
 
 Make sure mpi works. You should be able to run a program in parallel. 
@@ -16 +19 @@
 
 PYPAR
+======
 
-We use pypar as the interface between mpi and python. THe most recent 
+We use pypar as the interface between mpi and python. The most recent 
 version of PYPAR is available from 
 
 http://code.google.com/p/pypar/ 
 
-There is an old version on sourceforge
-http://sourceforge.net/projects/pypar/
+(There is an old version on sourceforge
+http://sourceforge.net/projects/pypar/)
 
-Should make sure the pypar examples work (and that it is in your python path)
+Install pypar following the instructions in hte download. Should be able
+use standard python setup.py install
+
+Make sure the pypar examples work
 
 
-In the anuga_parallel directory there is a subdirectory pymetis. You can 
-use the make file to compile. This should create a metis.so file in that 
-directory. From the pymetis directory, test using test_all.py
+PYMETIS
+=======
 
-Now go back to the anuga_parallel directory and run test_all.py
+In the anuga_parallel directory there is a subdirectory pymetis. 
+
+Follow the instructions in README to install. Essentially just run make.
+
+From the pymetis directory, test using test_all.py
+
+ANUGA_PARALLEL
+==============
+
+Should now be ready to run some parallel anuga code.
+
+Go back to the anuga_parallel directory and run test_all.py
 
 Hopefully that all works.
 
-Then run run_parallel_sw_merimbula.py
+Run run_parallel_sw_merimbula.py
 
-There are some choices in the script to use a small mesh, and a somewhat 
-larger mesh (the small one has 100 triangles the other 10000)
+First just run it a sequential program. 
 
-Run that script using a command like
+Then try a parallel run using a command like
 
 mpirun -np 4 python run_parallel_sw_merimbula.py
@@ -49 +65 @@
 You should look at the code in  run_parallel_sw_merimbula.py
 
-Essentially a fairly standard example, with the extra command domain= 
-distribute(domain)
+Essentially a fairly standard example, with the extra command 
+
+domain = distribute(domain)
 
 which sets up all the parallel stuff.
 
-Also for efficiency reasons we only setup the original sequential mesh 
+Also for efficiency reasons we only setup the original full sequential mesh 
 on processor 0, hence the statement
 
@@ -64 +81 @@
 
 The output will be an sww file associated to each 
-processor. Somewhere someone has created a script to combine these sww 
-files into one file. Will have to search for that.
+processor. 
 
-Hope this helps
+There is a script anuga/utilities/sww_merge.py which provides
+a function to merge sww files into one sww file for viewing 
+with the anuga viewer.