Changeset 137

Timestamp:

04/07/09 12:33:39 (7 years ago)

Author:

mmckerns

Message:

added better docs for how to setup; added setup helper script

Files:

• mystic/examples/README (modified) (1 diff)
• pyina/README (added)
• pyina/applications/Make.mm (modified) (1 diff)
• pyina/applications/mpi_world.py (added)
• pyina/examples_other/Make.mm (modified) (1 diff)
• pyina/examples_other/README (modified) (1 diff)
• pyina/examples_other/test_mpi_world.py (added)
• pyina/pyina/README (modified) (1 diff)

mystic/examples/README

@@ -41 +41 @@
  - test_mogi_anneal.py: tests with scipy simulated annealing, but hasn't been tuned, so again, doesn't work at all.
  - test_mogi2.py: two mogi sources
- - test_mpimogi.py: mpi version of test_mogi.py, default uses 4 proc
- - test_mpimogi2.py: mpi version of test_mogi2.py, default uses 4 proc
  - test_mogi3.py: reimplements test_mogi 
 

pyina/applications/Make.mm

@@ -23 +23 @@
     machines.py \
     mpiversion.py \
+    mpi_world.py \
 
 export:: export-binaries release-binaries

pyina/examples_other/Make.mm

@@ -23 +23 @@
     hello.py \
     pypi.py \
+    test_mpi_world.py \
     test0.py \
     test1.py \

pyina/examples_other/README

@@ -1 @@
-To launch an mpipython job, do, for example,
+= notes on pyina examples =
+Dependencies:
+ - ...
 
-mpirun -np 4 `which mpipython.exe` python_script
+Exceptions to the rule:
+ - ...
 
-extrapolate as needed.
-
-if jobs exit uncleanly, you may need to run
-
-/opt/mpich/gnu/sbin/cleanipcs; cluster-fork /opt/mpich/gnu/sbin/cleanipcs
-
-also
-
-cluster-fork killall mpipython.exe
+Special examples:
+ - ...
 
 
-adapted from pyina CVS 2008-07-07
-requires pyre.mpi built as in svn@danse.us/pyre/branches/mpi-lib
+-------------------------------------------------------------------------------
+
+Notes on the "ezmap" examples:
+ - ...
+
+Notes on the "mogi" examples:
+ - ...
+
+
+-------------------------------------------------------------------------------
+
+Notes on the examples in the "../examples" directory:
+ - ...
+ - test_mpimogi.py: mpi version of mystic's test_mogi.py, default uses 4 proc
+ - test_mpimogi2.py: mpi version of mystic's test_mogi2.py, default uses 4 proc
+
 
 # end of file

pyina/pyina/README

@@ -1 @@
-To launch an mpipython job, do, for example,
+This package contains the beginnings of a parallel-mapping implementation
+of the mystic inversion framework.  The core launcher uses mpi.
 
-mpirun -np 4 `which mpipython.exe` python_script
+This package was adapted from the pyina CVS 2008-07-07.
+It requires:
+ - numpy
+ - mystic
+ - pyre.mpi (built from svn@danse.us/pyre/branches/mpi-lib)
+ - journal (part of pythia-0.8; see http://danse.us/trac/pyre)
 
-extrapolate as needed.
 
-if jobs exit uncleanly, you may need to run
+##############################################################################
 
-/opt/mpich/gnu/sbin/cleanipcs; cluster-fork /opt/mpich/gnu/sbin/cleanipcs; cluster-fork killall mpipython.exe
+WARNING:
+To run all of the examples in the "examples" directory,
+you _must_ copy some files from mystic/examples.
 
-adapted from pyina CVS 2008-07-07
+ * Change to the pyina root directory
+     $ cd ..
+ * Copy the files:
+     $ ./mystic_files.py 
+ * Remove the files:
+     $ ./mystic_files.py -clean
+
+
+WARNING:
+To run pyina code, you _must_ have your console configured for MPI.
+  * Start mpd
+     $ mpd &
+  * Configure master and slaves
+     $ mpi_world.py -slaves [node1,node2,node3]
+
+
+NOTE:
+It is convienent to set a shell alias for the launch of
+the mpipython jobs.  Something like the following (for bash):
+    $ alias mpython1='mpiexec -np 1 `which mpipython.exe`'
+    $ alias mpython2='mpiexec -np 2 `which mpipython.exe`'
+    $ ...
+
+
+NOTE:
+There's also a convienent script to tear down your mpi environment.
+  * Kill all
+      $ mpi_world -kill
+
+
+NOTE:
+If jobs exit uncleanly, you may need to run some cleanup scripts.
+  * Clean up
+      $ /opt/mpich/gnu/sbin/cleanipcs
+      $ cluster-fork /opt/mpich/gnu/sbin/cleanipcs
+      $ cluster-fork killall mpipython.exe
+
 
 # end of file