/[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.7 by cnh,
Thu Feb 28 19:32:20 2002 UTC
+revision 1.11 by afe,
Wed Jan 28 19:33:04 2004 UTC
 Line 4 
 This chapter focuses on describing the {
  both the core numerics and the pluggable packages operate. The description
  presented here is intended to be a detailed exposition and contains significant
  background material, as well as advanced details on working with the WRAPPER.
- The tutorial sections of this manual (see Chapters
+ The tutorial sections of this manual (see sections
- \ref{chap:tutorialI}, \ref{chap:tutorialII} and \ref{chap:tutorialIII})
+ \ref{sect:tutorials}  and \ref{sect:tutorialIII})
  contain more succinct, step-by-step instructions on running basic numerical
  experiments, of varous types, both sequentially and in parallel. For many
  projects simply starting from an example code and adapting it to suit a
 Line 97 
 and operating systems. This allows numer
  \resizebox{!}{4.5in}{\includegraphics{part4/fit_in_wrapper.eps}}
  \end{center}
  \caption{
- Numerical code is written too fit within a software support
+ Numerical code is written to fit within a software support
  infrastructure called WRAPPER. The WRAPPER is portable and
  can be specialized for a wide range of specific target hardware and
  programming environments, without impacting numerical code that fits
 Line 120 
 uniprocessor and multi-processor Sun sys
  (UMA) and non-uniform memory access (NUMA) designs. Significant work has also
  been undertaken on x86 cluster systems, Alpha processor based clustered SMP
  systems, and on cache-coherent NUMA (CC-NUMA) systems from Silicon Graphics.
- The MITgcm code, operating within the WRAPPER, is also used routinely used on
+ The MITgcm code, operating within the WRAPPER, is also routinely used on
  large scale MPP systems (for example T3E systems and IBM SP systems). In all
  cases numerical code, operating within the WRAPPER, performs and scales very
  competitively with equivalent numerical code that has been modified to contain
 Line 661 
 Within a {\em bi}, {\em bj} loop
  computation is performed concurrently over as many processes and threads
  as there are physical processors available to compute.
+ An exception to the the use of {\em bi} and {\em bj} in loops arises in the
+ exchange routines used when the exch2 package is used with the cubed
+ sphere.  In this case {\em bj} is generally set to 1 and the loop runs from
+,{\em bi}.  Within the loop {\em bi} is used to retrieve the tile number,
+ which is then used to reference exchange parameters.
  The amount of computation that can be embedded
  a single loop over {\em bi} and {\em bj} varies for different parts of the
  MITgcm algorithm. Figure \ref{fig:bibj_extract} shows a code extract
-Line 781 
 The global domain size is again ninety g
+Line 787 
 The global domain size is again ninety g
  forty grid points in y. The two sub-domains in each process will be computed
  sequentially if they are given to a single thread within a single process.
  Alternatively if the code is invoked with multiple threads per process
- the two domains in y may be computed on concurrently.
+ the two domains in y may be computed concurrently.
  \item
  \begin{verbatim}
        PARAMETER (
-Line 817 
 by the application code. The startup cal
+Line 823 
 by the application code. The startup cal
  WRAPPER is shown in figure \ref{fig:wrapper_startup}.
  \begin{figure}
+ {\footnotesize
  \begin{verbatim}
         MAIN
-Line 845 
 WRAPPER is shown in figure \ref{fig:wrap
+Line 852 
 WRAPPER is shown in figure \ref{fig:wrap
  \end{verbatim}
+ }
  \caption{Main stages of the WRAPPER startup procedure.
  This process proceeds transfer of control to application code, which
  occurs through the procedure {\em THE\_MODEL\_MAIN()}.
-Line 927 
 File: {\em eesupp/inc/MAIN\_PDIRECTIVES1
+Line 935 
 File: {\em eesupp/inc/MAIN\_PDIRECTIVES1
  File: {\em eesupp/inc/MAIN\_PDIRECTIVES2.h}\\
  File: {\em model/src/THE\_MODEL\_MAIN.F}\\
  File: {\em eesupp/src/MAIN.F}\\
- File: {\em tools/genmake}\\
+ File: {\em tools/genmake2}\\
  File: {\em eedata}\\
  CPP:  {\em TARGET\_SUN}\\
  CPP:  {\em TARGET\_DEC}\\
-Line 982 
 Parameter:  {\em nPy}
+Line 990 
 Parameter:  {\em nPy}
  Additionally, compile time options are required to link in the
  MPI libraries and header files. Examples of these options
- can be found in the {\em genmake} script that creates makefiles
+ can be found in the {\em genmake2} script that creates makefiles
  for compilation. When this script is executed with the {bf -mpi}
  flag it will generate a makefile that includes
  paths for search for MPI head files and for linking in
-Line 1004 
 local configuration of your system.\\
+Line 1012 
 local configuration of your system.\\
  \fbox{
  \begin{minipage}{4.75in}
- File: {\em tools/genmake}
+ File: {\em tools/genmake2}
  \end{minipage}
  } \\
  \paragraph{\bf Execution} The mechanics of starting a program in
-Line 1424 
 sequence shown in section \ref{sect:call
+Line 1432 
 sequence shown in section \ref{sect:call
  WRAPPER layer.
+ {\footnotesize
  \begin{verbatim}
         MAIN
-Line 1451 
 WRAPPER layer.
+Line 1460 
 WRAPPER layer.
         |--THE_MODEL_MAIN   :: Numerical code top-level driver routine
  \end{verbatim}
+ }
  Core equations plus packages.
+ {\footnotesize
  \begin{verbatim}
  C
  C
-Line 1792 
 C    |-COMM_STATS     :: Summarise inter
+Line 1803 
 C    |-COMM_STATS     :: Summarise inter
  C                     :: events.
  C
  \end{verbatim}
+ }
  \subsection{Measuring and Characterizing Performance}

 Legend:



Removed from v.1.7
 


changed lines


 
Added in v.1.11
 Legend:



Removed from v.1.7
 


changed lines


 
Added in v.1.11
-Removed from v.1.7
+Added in v.1.11

	ViewVC Help
Powered by ViewVC 1.1.22