[cig-commits] [commit] devel, master: updated README files for examples (4d96129)

[cig_noreply at geodynamics.org]

Repository : https://github.com/geodynamics/specfem3d

On branches: devel,master
Link       : https://github.com/geodynamics/specfem3d/compare/6026e367984905ab133865f62fa6293b343759b9...47f703851338234f96397e7da9fbff63d8178b8a

>---------------------------------------------------------------

commit 4d96129077934534b7cfae81269f71c0580baa5c
Author: Carl Tape <carltape at gi.alaska.edu>
Date:   Sat Jan 29 23:22:37 2011 +0000

    updated README files for examples


>---------------------------------------------------------------

4d96129077934534b7cfae81269f71c0580baa5c
 homogeneous_halfspace/README  |  2 +-
 layered_halfspace/README      |  2 +-
 tomographic_model/README      | 29 ++++++++++++++++-------------
 waterlayered_halfspace/README |  4 ++--
 4 files changed, 20 insertions(+), 17 deletions(-)

diff --git a/homogeneous_halfspace/README b/homogeneous_halfspace/README
index 8b59d8c..7da7664 100644
--- a/homogeneous_halfspace/README
+++ b/homogeneous_halfspace/README
@@ -61,7 +61,7 @@ step-by-step tutorial:
      > make xdecompose_mesh_SCOTCH
 
    - run decomposer
-     (example assumes 4 partitions with mesh files in ../examples/homogeneous_halfspace/MESH/)
+     (example assumes 4 partitions with mesh files in examples/homogeneous_halfspace/MESH/)
      > ./bin/xdecompose_mesh_SCOTCH 4 examples/homogeneous_halfspace/MESH/ in_out_files/DATABASES_MPI/
 
      this creates mesh partitions "proc000***_Database" in directory in_out_files/DATABASES_MPI/.
diff --git a/layered_halfspace/README b/layered_halfspace/README
index 52f0a98..ba8817f 100644
--- a/layered_halfspace/README
+++ b/layered_halfspace/README
@@ -50,7 +50,7 @@ step-by-step tutorial:
 2. decompose mesh files:
 
     - run decomposer in directory bin/:
-      (example assumes 4 partitions with mesh files in OUTPUT_FILES/)
+      (example assumes 4 partitions with mesh files in examples/layered_halfspace/MESH/)
       > cd SPECFEM3D
       > make
       > ./bin/xdecompose_mesh_SCOTCH 4 examples/layered_halfspace/MESH/ in_out_files/DATABASES_MPI/
diff --git a/tomographic_model/README b/tomographic_model/README
index 366045c..1bf492b 100644
--- a/tomographic_model/README
+++ b/tomographic_model/README
@@ -21,24 +21,30 @@ step-by-step tutorial:
      claro -> Menu "Tools" -> "Play Journal File" ... and select file: "tomoblock_mesh.py"
 
      this creates all the mesh files in subdirectory MESH/
+     note: this is a simple uniform block mesh
 
 
 2. create tomography_model file:
 
-    in examples/tomographic_model, run bash script:
-
-    > sh create_tomography_model_file.sh
+   - in examples/tomographic_model, run bash script:
+     > sh create_tomography_model_file.sh
 
     which creates an example model: tomography_model.xyz
     ( elastic model with a constant velocity gradient with depth)
 
-    copy this file into directory SPECFEM3D/in_data_files/
+   - copy this file into directory SPECFEM3D/in_data_files/
+     > cp tomography_model.xyz ../../in_data_files/
+
+   - copy Par_file, CMTSOLUTION & STATIONS files provided in this examples directory to SPECFEM3D/in_data_files/
+     > cd in_data_files/
+     > cp * ../../../in_data_files/
+     note: these are needed prior to running xgenerate_databases
 
 
 3. decompose mesh files:
 
-    - run decomposer in directory decompose_mesh_SCOTCH/:
-      (example assumes 4 partitions with mesh files in OUTPUT_FILES/)
+    - run decomposer
+      (example assumes 4 partitions with mesh files in examples/tomographic_model/MESH/)
       > cd SPECFEM3D
       > make
       > ./bin/xdecompose_mesh_SCOTCH 4 examples/tomographic_model/MESH/ in_out_files/DATABASES_MPI/
@@ -50,7 +56,6 @@ step-by-step tutorial:
 4. generate databases:
 
    - compile generate_databases from SPECFEM3D/ :
-     > cd SPECFEM3D
      > make xgenerate_databases
 
    - submit job script
@@ -59,18 +64,16 @@ step-by-step tutorial:
 
 5. run simulation:
 
-   - copy three files -- Par_file CMTSOLUTION STATIONS -- from
-      SPECFEM3D/examples/tomographic_model/ to SPECFEM3D/in_data_files/
-
    - compile specfem3D:
      > make xspecfem3D
 
    - submit job script:
      > qsub go_solver_pbs.bash
 
-   - when the job is complete, you should have 3 sets (semd,semv,sema)
-     of 672 (ls -1 *semd | wc) in the directory in_out_files/OUTPUT_FILES,
-     as well as 3 timestamp****** files
+     the simulation will take about 10 minutes
+     when the job is complete, you should have 3 sets (semd,semv,sema)
+     of 18 (ls -1 *semd | wc) in directory in_out_files/OUTPUT_FILES,
+     as well as 9 timestamp****** files
 
 ===========================================================
 
diff --git a/waterlayered_halfspace/README b/waterlayered_halfspace/README
index eff4b43..1ab1fe5 100644
--- a/waterlayered_halfspace/README
+++ b/waterlayered_halfspace/README
@@ -26,8 +26,8 @@ step-by-step tutorial:
 
 2. decompose mesh files:
 
-    - run decomposer in directory decompose_mesh_SCOTCH/:
-      (example assumes 4 partitions with mesh files in OUTPUT_FILES/)
+    - run decomposer
+      (example assumes 4 partitions with mesh files in examples/waterlayered_halfspace/MESH/)
       > cd SPECFEM3D
       > make
       > ./bin/xdecompose_mesh_SCOTCH 4 examples/waterlayered_halfspace/MESH/ in_out_files/DATABASES_MPI/