[cig-commits] r19625 - in seismo/3D/FAULT_SOURCE/branches/new_fault_db: . utils

[ampuero at geodynamics.org]

Author: ampuero
Date: 2012-02-14 10:11:54 -0800 (Tue, 14 Feb 2012)
New Revision: 19625

Added:
   seismo/3D/FAULT_SOURCE/branches/new_fault_db/utils/go_mesher_solver_lsf_basin.forward
Modified:
   seismo/3D/FAULT_SOURCE/branches/new_fault_db/README_SPECFEM3D_FAULT
Log:
documenting details for Fram

Modified: seismo/3D/FAULT_SOURCE/branches/new_fault_db/README_SPECFEM3D_FAULT
===================================================================
--- seismo/3D/FAULT_SOURCE/branches/new_fault_db/README_SPECFEM3D_FAULT	2012-02-14 17:15:05 UTC (rev 19624)
+++ seismo/3D/FAULT_SOURCE/branches/new_fault_db/README_SPECFEM3D_FAULT	2012-02-14 18:11:54 UTC (rev 19625)
@@ -1,27 +1,47 @@
-This package contains a version of the 3D spectral element code SPECFEM3D-SESAME (Komatitsch et al)
-modified by Galvez, Ampuero and Nissen-Meyer to model dynamic earthquake on non-planar faults
-with slip-weakening friction. The main modifications are encapsulated in three new modules: 
-src/fault_object.f90, src/fault_solver.f90) and decompose_mesh_SCOTCH/fault_scotch.f90. 
-We also include some examples and Matlab functions for post-processing and visualization. 
 
-This is a preliminary version, still under development and testing. The format of inputs, outputs
-and features are subject to change.
+This package contains a version of the 3D spectral element code SPECFEM3D-SESAME (Komatitsch, Tromp et al)
+modified by J.-P. Ampuero (Caltech Seismolab) and P. Galvez (ETH Zurich) 
+to model dynamic earthquake rupture on non-planar faults with slip-weakening friction. 
+The main modifications are encapsulated in three new modules: 
+	decompose_mesh_SCOTCH/fault_scotch.f90. 
+	src/fault_object.f90 
+	src/fault_solver.f90 
+We also include examples and Matlab functions for post-processing and visualization. 
 
+This is a preliminary version, still under development and testing. 
+The features and the format of inputs and outputs are subject to change.
+
 Details about the original package are described in its manual (manual_SPECFEM3D.pdf).
 The current README file describes how to install and run our modified version of the code.
 It is not a replacement for the original manual, which you should read first.
 
-This document assumes that the root directory containing the code is ~/SPECFEM3D.
+Contents:
+	Download
+	Installation
+	Running a simulation
+	Examples
+	Input files
+	Output files
+	Post-processing and visualization
+	Running on Fram (the Caltech GPS cluster)
 
+0. DOWNLOAD
+--------
 
+Download the package with the following Subversion comand:
 
+	>> svn checkout http://geodynamics.org/svn/cig/seismo/3D/FAULT_SOURCE/branches/new_fault_db SPECFEM3D
 
+This will create a copy of the code in a directory called SPECFEM3D.
+
+
+
 I. INSTALLATION
 ----------------
 
 1. Copy the start-up and source files to the root directory:
 
-  	>> cd ~/SPECFEM3D 
+  	>> cd SPECFEM3D 
 	>> cp START_UP/*  src/*  .
 
 
@@ -34,6 +54,8 @@
 3. Configure the package, for instance:
 
   	>> ./configure FC=ifort MPIFC=mpif90
+   or 
+  	>> ./configure FC=ifort MPIFC=mpiifort
 
   Several settings can be tuned for your system, see Chapter 2 of the manual for more details.
   The code runs by default in single precision. If you prefer to run in double precision do instead: 
@@ -122,13 +144,13 @@
 4. Edit the file DATA/Par_file: 
 
    	LOCAL_PATH = should be the path to DATABASES_MPI
-	NPROC      = number of processors. The same as the number of partitions in SCOTCH (step 2).
+	NPROC      = number of processors. The same as the number of partitions in SCOTCH (step 3).
 
 
 5. Generate databases:
 
 	>> cd ~/SPECFEM3D
-   	>> mpirun -np nproc ./xgenerate_databases      
+   	>> mpirun -np nproc ./xgenerate_databases
     	or
    	>> ./run/run.xdatabases  
 
@@ -346,3 +368,27 @@
 The directories EXAMPLES/*/post contain additional Matlab scripts to generate figures
 specific to each example.
 
+
+
+VI. RUNNING ON FRAM (THE CALTECH GPS CLUSTER)
+---------------------------------------------
+
+Add this to you ~/.bash_profile file:
+
+  # Load modules:
+  module load intel/intel-12
+  module load intel/impi
+
+  # Set huge stack size:
+  ulimit -s unlimited
+
+Compiler settings:
+   FC = ifort
+   MPIFC = mpiifort
+
+Compiling SCOTCH:
+
+Submitting a job:
+        See example script
+        qsub
+

Added: seismo/3D/FAULT_SOURCE/branches/new_fault_db/utils/go_mesher_solver_lsf_basin.forward
===================================================================
--- seismo/3D/FAULT_SOURCE/branches/new_fault_db/utils/go_mesher_solver_lsf_basin.forward	                        (rev 0)
+++ seismo/3D/FAULT_SOURCE/branches/new_fault_db/utils/go_mesher_solver_lsf_basin.forward	2012-02-14 18:11:54 UTC (rev 19625)
@@ -0,0 +1,13 @@
+#!/bin/bash -v
+
+
+cd $PBS_O_WORKDIR
+
+
+current_pwd=$PWD
+
+mpirun $PWD/xgenerate_databases
+mpirun $PWD/xspecfem3D
+
+
+