[cig-commits] [commit] devel, master: got rid of the two-chunk option in the users manual (but not in the code), and also mentioned that one-chunk simulations can use a mesh chunk larger than 90 degrees, following suggestions made by Lion Krischer (fa5eb6e)

Thu Nov 6 08:28:04 PST 2014

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

On branches: devel,master
Link       : https://github.com/geodynamics/specfem3d_globe/compare/bc58e579b3b0838a0968725a076f5904845437ca...be63f20cbb6f462104e949894dbe205d2398cd7f

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

commit fa5eb6e9730b891585bf611e8aa2fc9dcf6ddd12
Author: Dimitri Komatitsch <komatitsch at lma.cnrs-mrs.fr>
Date:   Wed Jul 30 18:06:04 2014 +0200

    got rid of the two-chunk option in the users manual (but not in the code), and also mentioned that one-chunk simulations can use a mesh chunk larger than 90 degrees, following suggestions made by Lion Krischer


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

fa5eb6e9730b891585bf611e8aa2fc9dcf6ddd12
 doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.pdf | Bin 24401165 -> 24370999 bytes
 doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.tex |  76 +++++++++++++++--------------
 2 files changed, 39 insertions(+), 37 deletions(-)

diff --git a/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.pdf b/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.pdf
index e2c685d..c34b319 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 7e6847f..8a9fbf0 100644
--- a/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.tex
+++ b/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.tex
@@ -1664,14 +1664,17 @@ the simulation.
 
 \chapter{\label{cha:Regional-Simulations}Regional Simulations}
 
-The code has the option of running in 1-, 2-, 3- or 6-chunk mode.
-The 1- or 2-chunk options may be used for higher resolution regional
+%% DK DK got rid of the 2-chunk and 3-chunk options here in the manual (but not in the code) because they are now untested and to my knowledge nobody uses them
+
+The code has the option of running in one-chunk or six-chunk mode.
+The one-chunk options may be used for higher resolution regional
 simulations. A one-chunk mesh may have lateral dimensions other than
 the customary $90^{\circ}$ per chunk, which can further increase
 the resolution of the mesh, and thus reduce the shortest period in
 the synthetic seismograms (but of course then also reducing the time
-step in order for the simulation to remain stable). A disadvantage
-of regional simulations is that one needs to use approximate absorbing
+step in order for the simulation to remain stable).
+
+A disadvantage of regional simulations is that one needs to use approximate absorbing
 boundary conditions on the side and bottom edges of the model (e.g.,
 see \citet{KoTr99} for a description of the paraxial boundary conditions
 used). Figure~\vref{fig:3D-spectral-element-mesh} and Figure~\vref{fig:Close-up-view-of}
@@ -1687,9 +1690,9 @@ to be set in the \texttt{Par\_file}:
 \begin{description}
 \item [{$\nchunks$}] Must be set to 1.
 \item [{\texttt{ANGULAR\_WIDTH\_XI\_IN\_DEGREES}}] Denotes the width of
-one side of the chunk ($90^{\circ}$or less).
+one side of the chunk ($90^{\circ}$ is a classical value, but you can make it more or less if you want).
 \item [{\texttt{ANGULAR\_WIDTH\_ETA\_IN\_DEGREES}}] Denotes the width of
-the second side of the chunk ($90^{\circ}$or less). Note that this
+the second side of the chunk ($90^{\circ}$ is a classical value, but you can make it more or less if you want). Note that this
 value may be different from \texttt{ANGULAR\_WIDTH\_XI\_IN\_DEGREES}.
 \item [{\texttt{CENTER\_LATITUDE\_IN\_DEGREES}}] Defines the latitude of
 the center of the chunk (degrees).
@@ -1814,36 +1817,36 @@ accurate may be determined based upon the relation \begin{equation}
 
 
 
-\section{Two-Chunk Simulations}
-
-For a two-chunk regional simulation the following parameters need
-to be set in the \texttt{Par\_file}:
-
-\begin{description}
-\item [{$\nchunks$}] Must be set to 2
-\item [{\texttt{ANGULAR\_WIDTH\_XI\_IN\_DEGREES}}] Denotes the width of
-one side of the chunk, and it has to be 90 degrees.
-\item [{\texttt{ANGULAR\_WIDTH\_ETA\_IN\_DEGREES}}] Denotes the width of
-the second side of the chunk, and it also has to be 90 degrees.
-\end{description}
-\texttt{NEX\_XI} and \texttt{NEX\_ETA} follow the same description
-in Section \ref{sec:One-Chunk-Simulations}, however, they need to
-be the same in this case. All other parameters are similar to the
-one-chunk simulations, refer to Section \ref{sec:One-Chunk-Simulations}
-for details.
-
+% \section{Two-Chunk Simulations}
 % 
-\begin{figure}[H]
-\noindent \begin{centering}
-\includegraphics[width=0.6\textwidth]{figures/2-chunk-surface}
-\par\end{centering}
-
-\caption{Geometry of a 2-chunk simulation, where the first chunk (\texttt{CHUNK\_AB})
-centers at $40^{\circ}$ latitude, $10^{\circ}$ longitude, and has
-been rotated by $20^{\circ}$ counter clockwise, and the second chunk
-(\texttt{CHUNK\_AC}) connects to the first chunk through one face.}
-
-\end{figure}
+% For a two-chunk regional simulation the following parameters need
+% to be set in the \texttt{Par\_file}:
+% 
+% \begin{description}
+% \item [{$\nchunks$}] Must be set to 2
+% \item [{\texttt{ANGULAR\_WIDTH\_XI\_IN\_DEGREES}}] Denotes the width of
+% one side of the chunk, and it has to be 90 degrees.
+% \item [{\texttt{ANGULAR\_WIDTH\_ETA\_IN\_DEGREES}}] Denotes the width of
+% the second side of the chunk, and it also has to be 90 degrees.
+% \end{description}
+% \texttt{NEX\_XI} and \texttt{NEX\_ETA} follow the same description
+% in Section \ref{sec:One-Chunk-Simulations}, however, they need to
+% be the same in this case. All other parameters are similar to the
+% one-chunk simulations, refer to Section \ref{sec:One-Chunk-Simulations}
+% for details.
+% 
+% %
+% \begin{figure}[H]
+% \noindent \begin{centering}
+% \includegraphics[width=0.6\textwidth]{figures/2-chunk-surface}
+% \par\end{centering}
+% 
+% \caption{Geometry of a 2-chunk simulation, where the first chunk (\texttt{CHUNK\_AB})
+% centers at $40^{\circ}$ latitude, $10^{\circ}$ longitude, and has
+% been rotated by $20^{\circ}$ counter clockwise, and the second chunk
+% (\texttt{CHUNK\_AC}) connects to the first chunk through one face.}
+% 
+% \end{figure}
 
 
 
@@ -2552,8 +2555,7 @@ globe\_slice\_number2.pl~CMTSOLUTION~STATIONS\_ADJOINT~
 A typical value for \texttt{belt\_width\_in\_degrees} can be 20.
 
 \item For a full 6-chunk simulation, this script will generate the \texttt{slice\_minor},
-\texttt{slice\_major}, \texttt{slice\_ic} files, but for a one- or
-two-chunk simulation, this script only generates the \texttt{slice\_minor}
+\texttt{slice\_major}, \texttt{slice\_ic} files, but for a one-chunk simulation, this script only generates the \texttt{slice\_minor}
 file.
 \item For cases with multiple sources and multiple receivers, you need to
 provide a slice file before proceeding to the next step.

