10 |
%% o automatically inserted at \section{Reference} |
%% o automatically inserted at \section{Reference} |
11 |
|
|
12 |
|
|
13 |
\section{exch2: Extended Cubed Sphere \mbox{Topology}} |
\subsection{exch2: Extended Cubed Sphere \mbox{Topology}} |
14 |
\label{sec:exch2} |
\label{sec:exch2} |
15 |
|
|
16 |
|
|
17 |
\subsection{Introduction} |
\subsubsection{Introduction} |
18 |
|
|
19 |
The \texttt{exch2} package extends the original cubed sphere topology |
The \texttt{exch2} package extends the original cubed sphere topology |
20 |
configuration to allow more flexible domain decomposition and |
configuration to allow more flexible domain decomposition and |
41 |
\file{utils/exch2/code-mods} along with the appropriate \file{SIZE.h} |
\file{utils/exch2/code-mods} along with the appropriate \file{SIZE.h} |
42 |
file for single-processor execution. |
file for single-processor execution. |
43 |
|
|
44 |
\subsection{Invoking exch2} |
\subsubsection{Invoking exch2} |
45 |
|
|
46 |
To use exch2 with the cubed sphere, the following conditions must be |
To use exch2 with the cubed sphere, the following conditions must be |
47 |
met: \\ |
met: \\ |
96 |
|
|
97 |
|
|
98 |
|
|
99 |
\subsection{Generating Topology Files for exch2} |
\subsubsection{Generating Topology Files for exch2} |
100 |
\label{sec:topogen} |
\label{sec:topogen} |
101 |
|
|
102 |
Alternate cubed sphere topologies may be created using the Matlab |
Alternate cubed sphere topologies may be created using the Matlab |
182 |
|
|
183 |
|
|
184 |
|
|
185 |
\subsection{exch2, SIZE.h, and Multiprocessing} |
\subsubsection{exch2, SIZE.h, and Multiprocessing} |
186 |
\label{sec:exch2mpi} |
\label{sec:exch2mpi} |
187 |
|
|
188 |
Once the topology configuration files are created, the Fortran |
Once the topology configuration files are created, the Fortran |
271 |
|
|
272 |
|
|
273 |
|
|
274 |
\subsection{Key Variables} |
\subsubsection{Key Variables} |
275 |
|
|
276 |
The descriptions of the variables are divided up into scalars, |
The descriptions of the variables are divided up into scalars, |
277 |
one-dimensional arrays indexed to the tile number, and two and |
one-dimensional arrays indexed to the tile number, and two and |
281 |
arrays to individual tiles, and the arrays indexed by tile and |
arrays to individual tiles, and the arrays indexed by tile and |
282 |
neighbor to relationships between tiles and their neighbors. \\ |
neighbor to relationships between tiles and their neighbors. \\ |
283 |
|
|
284 |
\subsubsection{Scalars} |
Scalars: |
285 |
|
|
286 |
The number of tiles in a particular topology is set with the parameter |
The number of tiles in a particular topology is set with the parameter |
287 |
\code{NTILES}, and the maximum number of neighbors of any tiles by |
\code{NTILES}, and the maximum number of neighbors of any tiles by |
304 |
$x$ axis, and the $y$ axis variable \varlink{bj}{bj} is assumed to |
$x$ axis, and the $y$ axis variable \varlink{bj}{bj} is assumed to |
305 |
equal \code{1} throughout the package. \\ |
equal \code{1} throughout the package. \\ |
306 |
|
|
307 |
\subsubsection{Arrays indexed to tile number} |
Arrays indexed to tile number: |
308 |
|
|
309 |
The following arrays are of length \code{NTILES} and are indexed to |
The following arrays are of length \code{NTILES} and are indexed to |
310 |
the tile number, which is indicated in the diagrams with the notation |
the tile number, which is indicated in the diagrams with the notation |
357 |
corners of the cube. \\ |
corners of the cube. \\ |
358 |
|
|
359 |
|
|
360 |
\subsubsection{Arrays Indexed to Tile Number and Neighbor} |
Arrays Indexed to Tile Number and Neighbor: |
361 |
|
|
362 |
The following arrays have vectors of length \code{MAX\_NEIGHBOURS} and |
The following arrays have vectors of length \code{MAX\_NEIGHBOURS} and |
363 |
\code{NTILES} and describe the orientations between the the tiles. \\ |
\code{NTILES} and describe the orientations between the the tiles. \\ |
501 |
width of \code{T}'s northern edge, expanded by one into the halo. \\ |
width of \code{T}'s northern edge, expanded by one into the halo. \\ |
502 |
|
|
503 |
|
|
504 |
\subsection{Key Routines} |
\subsubsection{Key Routines} |
505 |
|
|
506 |
Most of the subroutines particular to exch2 handle the exchanges |
Most of the subroutines particular to exch2 handle the exchanges |
507 |
themselves and are of the same format as those described in |
themselves and are of the same format as those described in |