[cig-commits] [commit] devel: added doc/where_to_put_the_adjoint_sources_and_how_to_name_them.txt (352fd4e)

[cig_noreply at geodynamics.org]

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

On branch  : devel
Link       : https://github.com/geodynamics/specfem3d_globe/compare/0cab2d2571e0a3b4332b244be841d7206131b2fc...352fd4e1e6d114e3c06583dcd4ff0b339c39af7a

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

commit 352fd4e1e6d114e3c06583dcd4ff0b339c39af7a
Author: Dimitri Komatitsch <komatitsch at lma.cnrs-mrs.fr>
Date:   Sun Jul 13 22:19:17 2014 +0200

    added doc/where_to_put_the_adjoint_sources_and_how_to_name_them.txt


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

352fd4e1e6d114e3c06583dcd4ff0b339c39af7a
 ..._your_adjoint_sources_here_for_adjoint_runs.txt |   0
 doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.pdf         | Bin 24400199 -> 24401165 bytes
 doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.tex         |  16 ++++++++++++++++
 ...ut_the_adjoint_sources_and_how_to_name_them.txt |  17 +++++++++++++++++
 ...abase_if_you_want_other_topographic_models.bash |   1 +
 5 files changed, 34 insertions(+)

diff --git a/DATA/topo_bathy/note_etopo1_ice_c.grd_is_the_original_unmodified_data_file_from_the_Web b/SEM/put_your_adjoint_sources_here_for_adjoint_runs.txt
similarity index 100%
copy from DATA/topo_bathy/note_etopo1_ice_c.grd_is_the_original_unmodified_data_file_from_the_Web
copy to SEM/put_your_adjoint_sources_here_for_adjoint_runs.txt
diff --git a/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.pdf b/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.pdf
index db09588..e2c685d 100644
Binary files a/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.pdf and b/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.pdf differ
diff --git a/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.tex b/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.tex
index be8c30e..a711a2b 100644
--- a/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.tex
+++ b/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.tex
@@ -2014,6 +2014,22 @@ xcreate\_adjsrc\_amplitude~t1~t2~ifile{[}0-5]~E/N/Z-ascii-files~{[}baz].
 \end{lyxcode}
 \end{itemize}
 
+For adjoint runs (SIMULATION\_TYPE = 3), the adjoint sources need to be put in the "SEM" sub-directory in the root directory of the code.
+
+If your adjoint source have names of the following form for instance:
+
+STA00.NET.MXZ.sem.ascii.adj
+STA00.NET.MXZ.sem.ascii.adj
+
+you will need to rename them to:
+
+STA00.NET.MXZ.adj
+STA00.NET.MXZ.adj
+
+i.e. suppress ".sem.ascii".
+
+You will also need to create a file called STATIONS\_ADJOINT in the "DATA" directory in the root directory of the code. That file can be identical to the DATA/STATIONS file if you had a single station in STATIONS.
+
 \item \textbf{Run the kernel simulation}
 
 
diff --git a/doc/where_to_put_the_adjoint_sources_and_how_to_name_them.txt b/doc/where_to_put_the_adjoint_sources_and_how_to_name_them.txt
new file mode 100644
index 0000000..19bab78
--- /dev/null
+++ b/doc/where_to_put_the_adjoint_sources_and_how_to_name_them.txt
@@ -0,0 +1,17 @@
+
+For adjoint runs (SIMULATION_TYPE = 3), the adjoint sources need to be put in the "SEM" sub-directory in the root directory of the code.
+
+If your adjoint source have names of the following form for instance:
+
+STA00.NET.MXZ.sem.ascii.adj
+STA00.NET.MXZ.sem.ascii.adj
+
+you will need to rename them to:
+
+STA00.NET.MXZ.adj
+STA00.NET.MXZ.adj
+
+i.e. suppress ".sem.ascii".
+
+You will also need to create a file called STATIONS_ADJOINT in the "DATA" directory in the root directory of the code. That file can be identical to the DATA/STATIONS file if you had a single station in STATIONS.
+
diff --git a/download_the_whole_topography_database_if_you_want_other_topographic_models.bash b/download_the_whole_topography_database_if_you_want_other_topographic_models.bash
index 5fb29e4..13c0bfc 100755
--- a/download_the_whole_topography_database_if_you_want_other_topographic_models.bash
+++ b/download_the_whole_topography_database_if_you_want_other_topographic_models.bash
@@ -24,4 +24,5 @@ wget http://data.geodynamics.org/specfem/specfem3d_globe/topo_bathy/topo_bathy_e
 
 echo " "
 echo "You can now uncompress the topography file you want using the bunzip2 command."
+echo "You will also need to uncomment it in file setup/constants.h.in before configuring and compiling the code."
 echo " "