| 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 |