[cig-commits] r6446 - long/3D/Gale/trunk

walter at geodynamics.org walter at geodynamics.org
Wed Mar 28 11:23:14 PDT 2007


Author: walter
Date: 2007-03-28 11:23:14 -0700 (Wed, 28 Mar 2007)
New Revision: 6446

Added:
   long/3D/Gale/trunk/RELEASE_NOTES
Modified:
   long/3D/Gale/trunk/
   long/3D/Gale/trunk/INSTALL
   long/3D/Gale/trunk/INSTALL.DEBIAN
   long/3D/Gale/trunk/INSTALL.MACOSX
   long/3D/Gale/trunk/INSTALL.PANGU
   long/3D/Gale/trunk/INSTALL.RHFC5
   long/3D/Gale/trunk/INSTALL.SEABORG
   long/3D/Gale/trunk/INSTALL.SUSE
   long/3D/Gale/trunk/README
Log:
 r1779 at earth:  boo | 2007-03-28 11:11:41 -0700
 update README and INSTALL's, and add RELEASE_NOTES



Property changes on: long/3D/Gale/trunk
___________________________________________________________________
Name: svk:merge
   - 3a629746-de10-0410-b17b-fd6ecaaa963e:/cig:1777
   + 3a629746-de10-0410-b17b-fd6ecaaa963e:/cig:1779

Modified: long/3D/Gale/trunk/INSTALL
===================================================================
--- long/3D/Gale/trunk/INSTALL	2007-03-28 18:15:58 UTC (rev 6445)
+++ long/3D/Gale/trunk/INSTALL	2007-03-28 18:23:14 UTC (rev 6446)
@@ -1,7 +1,7 @@
 These are generic installation instructions.  Gale has been tested on
 workstations running 
 
-  * Mac OS X 10.4.6 (G4, G5, and x86)
+  * Mac OS X 10.4 (G4, G5, and x86)
   * Windows 2000 and XP SP2 (x86)
   * RedHat Fedora Core 5 (x86)
   * OpenSuse 10.0 (x86)
@@ -35,20 +35,15 @@
 ---------
 
 The first step in installing Gale is running the script configure.py.
-This script examines your system, looking for dependencies.  It also
-determines where to install Gale.  By default, Gale will be installed
-in /usr/local.  You can override this with the --prefix option.  So to
-install it in /opt/gale, you would invoke configure.py as
+This script examines your system, looking for dependencies.  If you
+are lucky, configure.py will be able to find everything.  But many
+times, you will have to tell configure.py where different packages
+are.  For example, suppose you installed PETSc in /opt/goodies/petsc.
+Then you can tell configure.py where PETSc is with the
+--with-petsc-dir option
 
-  configure.py --prefix=/opt/gale
+  configure.py --with-petsc-dir=/opt/goodies/petsc
 
-If you are lucky, configure.py will be able to find everything.  But many
-times, you will have to tell configure.py where different packages are.
-For example, suppose you installed PETSc in /opt/goodies/petsc.  Then
-you can tell configure.py where PETSc is with the --with-petsc-dir option
-
-  configure.py --prefix=/opt/gale --with-petsc-dir=/opt/goodies/petsc
-
 PETSc has a mechanism for letting multiple installations of PETSc
 coexist in a single directory (PETSC_ARCH).  If you have multiple
 installations, Gale will use the first one it finds. To override that
@@ -60,10 +55,6 @@
 configure.py also checks the environment variables PETSC_DIR and
 PETSC_ARCH.
 
-Alternately, you can directly specify the library and include
-directories with the options --with-petsc-libdir and
---with-petsc-include.
-
 For the other dependencies, configure.py accepts the options
 
   --with-libxml2-include
@@ -107,20 +98,22 @@
 
   make install
 
-This also uses scons.py under the hood.
+and the binary will be in bin/Gale.  This also uses scons.py under the
+hood.
 
 Testing
 -------
 
 There are four sample test input files: extension.xml, shortening.xml,
-subduction.xml, and sinusoid.xml.  If you installed Gale in /foo/gale,
-then to run the extension model type
+subduction.xml, and sinusoid.xml.  To run the extension model type
 
-  /foo/gale/bin/Gale input/extension.xml
+  bin/Gale input/extension.xml
 
 For some MPI implementations, you may have to speficy the complete
-path to the input file.
+path to the input file
 
+  bin/Gale /home/juser/gale/input/extension.xml
+
 Gale is nearly feature complete, although we do not vouch that it is
 free of serious errors.  If you find any bugs, please send a meesage
 to

Modified: long/3D/Gale/trunk/INSTALL.DEBIAN
===================================================================
--- long/3D/Gale/trunk/INSTALL.DEBIAN	2007-03-28 18:15:58 UTC (rev 6445)
+++ long/3D/Gale/trunk/INSTALL.DEBIAN	2007-03-28 18:23:14 UTC (rev 6446)
@@ -11,15 +11,17 @@
   In this case, petsc is already packaged for you (petsc-dev).  To
 build and install Gale, type
 
-  configure.py --prefix=/path/to/install/gale
+  configure.py
   make
   make install
 
+and the binary will be in bin/Gale.
+
 2) Stable
 
   The version of petsc in stable is too old (2.2.0).  So download a
-newer version from the petsc website (2.3.0 or 2.3.1, but not 2.3.2).
-Unpack it, and cd into the directory.  Configure it with
+newer version from the petsc website (2.3.2 only).  Unpack it, and cd
+into the directory.  Configure it with
 
   export PETSC_DIR=$PWD
   config/configure.py --prefix=/path/to/install/petsc --with-debugging=no
@@ -38,6 +40,8 @@
 
 To build Gale, cd into the Gale directory and run
 
-  configure.py --prefix=~/Gale --with-petsc-dir=/path/to/install/petsc
+  configure.py --with-petsc-dir=/path/to/install/petsc
   make
   make install
+
+and the binary will be in bin/Gale.

Modified: long/3D/Gale/trunk/INSTALL.MACOSX
===================================================================
--- long/3D/Gale/trunk/INSTALL.MACOSX	2007-03-28 18:15:58 UTC (rev 6445)
+++ long/3D/Gale/trunk/INSTALL.MACOSX	2007-03-28 18:23:14 UTC (rev 6446)
@@ -14,8 +14,8 @@
 
 Once those are installed, you have to install petsc.  Petsc will
 download mpi for you.  So once you have gotten the petsc tarball from
-the website (2.3.0 or 2.3.1, but not 2.3.2), unpack it and cd into the
-directory.  Configure it with
+the website (2.3.2 only), unpack it and cd into the directory.  Configure
+it with
 
   export PETSC_DIR=$PWD
   config/configure.py --prefix=/path/to/install/petsc --download-mpich=1 --with-external-packages-dir=/path/to/install/mpich
@@ -35,6 +35,8 @@
 
 To build Gale, cd into the Gale directory and run
 
-  configure.py --prefix=/path/to/install/Gale --with-petsc-dir=/path/to/install/petsc/ --with-mpi-dir=/path/to/install/mpich/mpich2-1.0.3
+  configure.py --with-petsc-dir=/path/to/install/petsc/ --with-mpi-dir=/path/to/install/mpich/mpich2-1.0.3
   make
   make install
+
+and the binary will be in bin/Gale.

Modified: long/3D/Gale/trunk/INSTALL.PANGU
===================================================================
--- long/3D/Gale/trunk/INSTALL.PANGU	2007-03-28 18:15:58 UTC (rev 6445)
+++ long/3D/Gale/trunk/INSTALL.PANGU	2007-03-28 18:23:14 UTC (rev 6446)
@@ -1,21 +1,20 @@
 You need to build petsc.  I configured with
 
-  config/configure.py --prefix=/home/walter/petsc --with-batch=1 --with-mpi-shared=false --with-fc=0 --with-mpi-dir=/opt/mpich/myrinet_mx2g/intel --with-shared=0 --with-lapack-lib=/opt/intel/cmkl/8.1/lib/em64t/libmkl_lapack64.so --with-blas-lib=/opt/intel/cmkl/8.1/lib/em64t/libmkl.so --with-debugging=no
+  config/configure.py --prefix=/home/walter/petsc --with-batch=1 --with-mpi-shared=false --with-fc=0 --with-mpi-dir=/opt/mpich/myrinet/pgi-6.0 --with-debugging=0
 
-
 Then configure gale similarly
 
-  ./configure.py --prefix=/home/walter/gale --with-mpi-dir=/opt/mpich/myrinet_mx2g/intel --with-batch=1 --with-mpi-shared=false
+  ./configure.py --with-batch=1 --with-mpi-shared=false --with-fc=0 --with-mpi-dir=/opt/mpich/myrinet/pgi-6.0 --with-debugging=0
 
-Each time, it will stop and ask you to run a job in the batch system.
-You can just execute the command on the login node.  Then you run
+Each time, it will stop and ask you to run "conftest" in the batch
+system.  You can just execute the command on the login node.  Then you
+run
 
   python reconfigure
 
-and it will complete.
+and it will complete.  Then just type
 
-To actually run, you need to add
+  make
+  make install
 
-  /opt/mpichgm-1.2.6..14b..gcc..ifort_9.0/bin
-
-to your path.
\ No newline at end of file
+and the binary will be in bin/Gale.

Modified: long/3D/Gale/trunk/INSTALL.RHFC5
===================================================================
--- long/3D/Gale/trunk/INSTALL.RHFC5	2007-03-28 18:15:58 UTC (rev 6445)
+++ long/3D/Gale/trunk/INSTALL.RHFC5	2007-03-28 18:23:14 UTC (rev 6446)
@@ -23,6 +23,8 @@
 
 To build Gale, cd into the Gale directory and run
 
-  configure.py --prefix=~/Gale --with-petsc-dir=/path/to/install/petsc --with-mpi-dir=/usr/share/openmpi
+  configure.py --with-petsc-dir=/path/to/install/petsc --with-mpi-dir=/usr/share/openmpi
   make
   make install
+
+and the binary will be in bin/Gale.

Modified: long/3D/Gale/trunk/INSTALL.SEABORG
===================================================================
--- long/3D/Gale/trunk/INSTALL.SEABORG	2007-03-28 18:15:58 UTC (rev 6445)
+++ long/3D/Gale/trunk/INSTALL.SEABORG	2007-03-28 18:23:14 UTC (rev 6446)
@@ -12,7 +12,7 @@
 should unload GNU, because otherwise it may use the GNU ar and nm
 which may be problematic.
 
-Configure requires --with-batch and --with-mpi-shared=0.
+Configure requires --with-batch=1 and --with-mpi-shared=0.
 
 The configure can not find isnan or isinf.  Needs "-lm", so just
 comment out those tests.

Modified: long/3D/Gale/trunk/INSTALL.SUSE
===================================================================
--- long/3D/Gale/trunk/INSTALL.SUSE	2007-03-28 18:15:58 UTC (rev 6445)
+++ long/3D/Gale/trunk/INSTALL.SUSE	2007-03-28 18:23:14 UTC (rev 6446)
@@ -26,6 +26,8 @@
 
 To build Gale, cd into the Gale directory and run
 
-  configure.py --prefix=/path/to/install/Gale --with-petsc-dir=/path/to/install/petsc/ --with-mpi-dir=/path/to/install/mpich/mpich2-1.0.3
+  configure.py --with-petsc-dir=/path/to/install/petsc/ --with-mpi-dir=/path/to/install/mpich/mpich2-1.0.3
   make
   make install
+
+and the binary will be in bin/Gale.

Modified: long/3D/Gale/trunk/README
===================================================================
--- long/3D/Gale/trunk/README	2007-03-28 18:15:58 UTC (rev 6445)
+++ long/3D/Gale/trunk/README	2007-03-28 18:23:14 UTC (rev 6446)
@@ -1,4 +1,4 @@
-We are pleased to announce the release of Gale 1.1.1.
+We are pleased to announce the release of Gale 1.2.0.
 
 See the file INSTALL for build and installation instructions.
 

Added: long/3D/Gale/trunk/RELEASE_NOTES
===================================================================
--- long/3D/Gale/trunk/RELEASE_NOTES	2007-03-28 18:15:58 UTC (rev 6445)
+++ long/3D/Gale/trunk/RELEASE_NOTES	2007-03-28 18:23:14 UTC (rev 6446)
@@ -0,0 +1,105 @@
+1.2.0
+----------------------------------
+* Gale has been shown to scale to 128 processors
+* Gale now defaults to installing in the current directory.  So the
+  binary is in bin/Gale
+* The --with-petsc-arch and --with-libxml-libdir options now work
+
+
+1.1.1
+----------------------------------
+This latest release features a number of bug fixes and improved
+documentation.
+
+1.1.0
+----------------------------------
+   * Gale is known to work in parallel with two processors
+   * A bug preventing 3D runs on some machines was fixed.
+   * A memory leak preventing long runs was fixed.
+   * The documentation has been significantly improved, with eight
+     cookbook examples with supporting diagrams added.
+   * The subduction example is more realistic.
+   * There are a number of Matlab visualization scripts generously
+     donated by Boris Kaus
+   * We now have binaries for 32 bit x86 Linux, 64 bit AMD Linux,
+     32 bit Windows, PPC Mac, and Intel Mac.
+
+While this release should be useful to many researchers, we continue
+to work on
+
+  * Interfacing custom surface process models
+  * Frictional boundary conditions
+  * Deformed lower boundaries
+  * Improved parallel performance
+
+
+1.0.0
+----------------------------------
+  * Deformed Upper boundaries are now supported.
+
+  * Narrow faults now work well.
+
+  * Stress boundary conditions are now supported, although it may be a
+    little flaky.
+
+  * Parallel works better, but is still a bit flaky
+
+  * Binaries are available for Windows, Mac, and Linux.
+
+  * There is now an example of relaxation of topography.
+
+  * The documentation has been significantly improved.
+
+While this release should be useful to many researchers, we continue
+development.  Specifically, we will be working on
+
+  * Interfacing custom surface process models
+  * Frictional boundary conditions
+  * Deformed lower boundaries
+
+
+0.9.0
+----------------------------------
+  * There are now examples of extension, shortening, and subduction
+    that work in 2D and 3D.
+
+  * Inflow and outflow boundaries are now supported.
+
+  * A straightforward Mohr-Coulomb yielding model is now available.
+
+  * Parallel is a bit flaky and may or may not work for you.
+
+  * Narrow faults may have numerical problems
+
+  * Binaries are available for Windows, Mac, and Linux.
+
+This release is almost feature complete.  At this point, the only
+significant steps from here to 1.0 are
+
+  * Stress Boundaries
+  * Miscellaneous bug fixes
+  * Improved documentation
+  * More thorough testing
+
+0.2.0
+----------------------------------
+  * The simple-extension.xml example should work in 2D and 3D.  The
+    other input files have not been tested.
+
+  * Binaries are available for Windows, Mac, and Linux.
+
+  * Documentation has been improved, though there is still much work
+    to do.
+
+  * The parallel capabilities of the code are temporarily broken.
+
+This is a beta release, so do not be surprised if you find bugs.
+
+0.1.0
+----------------------------------
+This is an alpha release, so it is mostly of interest to developers.
+While the installation has been tested on a number of different
+machines, if you have an odd machine that you want supported, then it
+would be useful if you could try installing Gale now.  Otherwise, if
+you just want to run the code, it may be better to wait for a stable
+release.



More information about the cig-commits mailing list