/[MITgcm]/manual/s_software/text/sarch.tex

Diff of /manual/s_software/text/sarch.tex

Parent Directory | Revision Log | View Revision Graph Revision Graph | View Patch Patch

-revision 1.13 by afe,
Wed Jan 28 20:27:54 2004 UTC
+revision 1.16 by afe,
Thu Jan 29 16:02:58 2004 UTC
 Line 977 
 program, MPI is used. The calls to the M
  routines must be activated at compile time.  Currently MPI libraries are
  invoked by
  specifying the appropriate options file with the
- \begin{verbatim}-of\end{verbatim} flag when running the {\em genmake2}
+ {\tt-of} flag when running the {\em genmake2}
  script, which generates the Makefile for compiling and linking MITgcm.
  (Previously this was done by setting the {\em ALLOW\_USE\_MPI} and
  {\em ALWAYS\_USE\_MPI} flags in the {\em CPP\_EEOPTIONS.h} file.)  More
  detailed information about the use of {\em genmake2} for specifying
- local compiler flags is located in section 3 ??\\
+ local compiler flags is located in section \ref{sect:genmake}.\\
  \fbox{
  \begin{minipage}{4.75in}
+ Directory: {\em tools/build\_options}\\
  File: {\em tools/genmake2}
  \end{minipage}
  } \\
-Line 1005 
 product of the processor grid settings o
+Line 1006 
 product of the processor grid settings o
  in the file {\em SIZE.h}. The parameter {\em mf} specifies that a text file
  called ``mf'' will be read to get a list of processor names on
  which the sixty-four processes will execute. The syntax of this file
- is specified by the MPI distribution
+ is specified by the MPI distribution.
  \\
  \fbox{
-Line 1056 
 to processor identification are are used
+Line 1057 
 to processor identification are are used
  Allocation of processes to tiles in controlled by the routine
  {\em INI\_PROCS()}. For each process this routine sets
  the variables {\em myXGlobalLo} and {\em myYGlobalLo}.
- These variables specify (in index space) the coordinate
+ These variables specify in index space the coordinates
- of the southern most and western most corner of the
+ of the southernmost and westernmost corner of the
- southern most and western most tile owned by this process.
+ southernmost and westernmost tile owned by this process.
  The variables {\em pidW}, {\em pidE}, {\em pidS} and {\em pidN}
  are also set in this routine. These are used to identify
  processes holding tiles to the west, east, south and north
-Line 1067 
 in the header file {\em EESUPPORT.h} for
+Line 1068 
 in the header file {\em EESUPPORT.h} for
  communication routines.  The above does not hold when the
  exch2 package is used -- exch2 sets its own parameters to
  specify the global indices of tiles and their relationships
- to each other.
+ to each other.  See the documentation on the exch2 package
+ (\ref{sec:exch2})  for
+ details.
  \\
  \fbox{
-Line 1093 
 operations and that can be customized fo
+Line 1096 
 operations and that can be customized fo
  describes the information that is held and used.
  \begin{enumerate}
- \item {\bf Tile-tile connectivity information} For each tile the WRAPPER
+ \item {\bf Tile-tile connectivity information}
- sets a flag that sets the tile number to the north, south, east and
+ For each tile the WRAPPER
+ sets a flag that sets the tile number to the north,
+ south, east and
  west of that tile. This number is unique over all tiles in a
- configuration. The number is held in the variables {\em tileNo}
+ configuration. Except when using the cubed sphere and the exch2 package,
+ the number is held in the variables {\em tileNo}
  ( this holds the tiles own number), {\em tileNoN}, {\em tileNoS},
  {\em tileNoE} and {\em tileNoW}. A parameter is also stored with each tile
  that specifies the type of communication that is used between tiles.
-Line 1119 
 of the WRAPPER exchange primitive
+Line 1125 
 of the WRAPPER exchange primitive
  (see figure \ref{fig:communication_primitives}). The routine
  {\em ini\_communication\_patterns()} is responsible for setting the
  communication mode values for each tile.
- \\
+ When using the cubed sphere configuration with the exch2 package, the
+ relationships between tiles and their communication methods are set
+ by the package in other variables.  See the exch2 package documentation
+ (\ref{sec:exch2} for details.
  \fbox{
  \begin{minipage}{4.75in}
-Line 1255 
 The \_EXCH operation is also central to
+Line 1267 
 The \_EXCH operation is also central to
  the cube-sphere grid. In this class of grid a rotation may be required
  between tiles. Aligning the coordinate requiring rotation with the
  tile decomposition, allows the coordinate transformation to
- be embedded within a custom form of the \_EXCH primitive.
+ be embedded within a custom form of the \_EXCH primitive.  In these
+ cases \_EXCH is mapped to exch2 routines, as detailed in the exch2
+ package documentation  \ref{sec:exch2}.
  \item {\bf Reverse Mode}
  The communication primitives \_EXCH and \_GSUM both employ
-Line 1272 
 operations. However, the routine argumen
+Line 1286 
 operations. However, the routine argumen
  is set to the value {\em REVERSE\_SIMULATION}. This signifies
  ti the low-level routines that the adjoint forms of the
  appropriate communication operation should be performed.
  \item {\bf MAX\_NO\_THREADS}
  The variable {\em MAX\_NO\_THREADS} is used to indicate the
  maximum number of OS threads that a code will use. This
-Line 1376 
 a series of template files, for example
+Line 1391 
 a series of template files, for example
  This is done to allow a large number of variations on the exchange
  process to be maintained. One set of variations supports the
  cube sphere grid. Support for a cube sphere grid in MITgcm is based
- on having each face of the cube as a separate tile (or tiles).
+ on having each face of the cube as a separate tile or tiles.
  The exchange routines are then able to absorb much of the
  detailed rotation and reorientation required when moving around the
  cube grid. The set of {\em \_EXCH} routines that contain the

 Legend:



Removed from v.1.13
 


changed lines


 
Added in v.1.16
 Legend:



Removed from v.1.13
 


changed lines


 
Added in v.1.16
-Removed from v.1.13
+Added in v.1.16

	ViewVC Help
Powered by ViewVC 1.1.22