/[MITgcm]/manual/s_phys_pkgs/text/top_section.tex
ViewVC logotype

Contents of /manual/s_phys_pkgs/text/top_section.tex

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


Revision 1.39 - (show annotations) (download) (as text)
Tue Jun 27 20:47:05 2006 UTC (19 years, 1 month ago) by molod
Branch: MAIN
Changes since 1.38: +31 -6 lines
File MIME type: application/x-tex
Add cross referencing for packages, verification experiments and tutorials

1 % $Header: /u/gcmpack/manual/part6/part6.tex,v 1.38 2006/04/06 21:11:57 edhill Exp $
2 % $Name: $
3
4 \chapter{Physical Parameterizations - Packages I}
5 \label{chap:packagesI}
6
7 \begin{rawhtml}
8 <!-- CMIREDIR:packages: -->
9 \end{rawhtml}
10
11 In this chapter and in the following chapter, the MITgcm ``packages'' are
12 described. While you can carry out many experiments with MITgcm by starting
13 from case studies in section \ref{sect:tutorials}, configuring
14 a brand new experiment or making major changes to an experimental configuration
15 requires some knowledge of the {\it packages}
16 that make up the full MITgcm code. Packages are used in MITgcm to
17 help organize and layer various code building blocks that are assembled
18 and selected to perform a specific experiment. Each of the specific experiments
19 described in section \ref{sect:tutorials} uses a particular combination
20 of packages.
21 Figure \ref{fig:package_organigramme} shows the full set of packages that
22 are available. As shown in the figure packages are classified into different
23 groupings that layer on top of each other. The top layer packages are
24 generally specialized to specific simulation types. In this layer there are
25 packages that deal with biogeochemical processes, ocean interior
26 and boundary layer processes, atmospheric processes, sea-ice, coupled
27 simulations and state estimation.
28 Below this layer are a set of general purpose
29 numerical and computational packages. The general purpose numerical packages
30 provide code for kernel numerical alogorithms
31 that apply to
32 many different simulation types. Similarly, the general purpose computational
33 packages implement non-numerical alogorithms that provide parallelism,
34 I/O and time-keeping functions that are used in many different scenarios.
35
36
37 \begin{figure}
38 %%\begin{minipage}{12cm}
39 %%\marginsize{0cm}{0cm}{0cm}{0cm}
40 %% \scalefig{0.6}
41 %% \epsfbox{part6/organigramme_mitgcm_pkg.eps}
42 %%\epsfig{file=part6/organigramme_mitgcm_pkg.eps, angle=-90, scale=0.85, width=17cm}
43 %%\end{minipage}
44 \resizebox{5.5in}{!}{\includegraphics{part6/organigramme_mitgcm_pkg2.eps}}
45 \label{fig:package_organigramme}
46 \caption{ Hierarchy of code layers that are assembled to make up an MITgcm
47 simulation. Conceptually (and in terms of code organization) MITgcm consists
48 of several layers. At the base is a layer of core software that provides a
49 basic numerical and computational foundation for MITgcm simulations. This
50 layer is shown marked {\bf Foundation Code} at the bottom of the figure
51 and corresponds to code in the italicised subdirectories on the figure.
52 This layer is not organized into packages. All code above the foundation layer
53 is organized as packages. Much of the code in MITgcm is contained in packages
54 which serve as a useful way of organizing and layering the different levels of
55 functionality that make up the full MITgcm software distribution.
56 The figure shows the different packages in MITgcm as boxes containing bold
57 face upper case names. Directly above the foundation layer are two layers of
58 general purpose infrastructure software that consist of computational and
59 numerical packages. These general purpose packages can be applied to both
60 online and offline simulations and are used in many different physical
61 simulation types. Above these layers are more specialized packages. }
62 \end{figure}
63
64 The following sections describe the packages shown in
65 figure \ref{fig:package_organiigramme}. Section \ref{sec:pkg:using}
66 describes the general procedure for using any package in MITgcm.
67 Following that sections \ref{}-\ref{}
68 layout the algorithms implemented in specific packages
69 and describe how to use the individual packages. A brief synopsis of the
70 function of each package is given in table \ref{tab:package_summary_tab}.
71 Organizationally package code is assigned a
72 separate subdirectory in the MITgcm code distribution
73 (within the source code directory \texttt{pkg}).
74 The name of this subdirectory is used as the package name in
75 table \ref{tab:package_summary_tab}.
76
77 %% In this chapter the schemes for parameterizing processes that are not
78 %% represented explicitly in MITgcm are described. Some of these
79 %% processes are sub-grid scale (SGS) phenomena, other processes, such as
80 %% open-boundaries, are external to the simulation.
81
82 % Overview
83 \newpage
84 \input{part6/packages.tex}
85
86 % Packages Related to Hydrodynamical Kernel
87 \newpage
88 \section{Packages Related to Hydrodynamical Kernel}
89 \input{part6/generic_advdiff.tex}
90 tutorial\_offline \ref{sect:eg-offline}
91 tutorial\_baroclinic\_gyre \ref{sect:eg-fourlayer}
92 tutorial\_tracer\_adjsens \ref{sect:eg-simple-tracer}
93
94 \newpage
95 \input{part6/zonal_filt.tex}
96 tutorial\_held\_suarez\_cs \ref{sect:eg-hs}
97
98 \newpage
99 \input{part6/exch2.tex}
100 tutorial\_held\_suarez\_cs \ref{sect:eg-hs}
101
102 \newpage
103 \input{part6/gridalt.tex}
104 fizhi-cs-32x32x40
105
106 % Some Mention of Packages that are part of the main model document
107
108 % Ocean Packages
109 \newpage
110 \section{Ocean Packages}
111 \input{part6/gmredi.tex}
112 tutorial\_global\_oce\_latlon \ref{sect:eg-global}
113 front\_relax
114 ideal\_2D\_oce
115
116 \newpage
117 \input{part6/kpp.tex}
118 lab\_sea
119
120 \newpage
121 \input{part6/bulk_force.tex}
122 global\_ocean.cs32x15/input/thsice
123
124 \newpage
125 \input{part6/exf.tex}
126 global\_with\_exf
127 lab\_sea
128
129 \newpage
130 \input{part6/cal.tex}
131 global\_with\_exf
132 lab\_sea
133
134 \newpage
135 \input{part6/obcs.tex}
136 exp4
137
138 \section{Atmosphere Packages}
139 \newpage
140 \input{part6/aim.tex}
141 aim.5l\_cs
142
143 \newpage
144 \input{part6/land.tex}
145 aim.5l\_cs
146
147 \newpage
148 \input{part6/fizhi.tex}
149 fizhi-cs-aqualev20
150 fizhi-cs-32x32x40
151
152 \section{Sea Ice Packages}
153 \newpage
154 \input{part6/thsice.tex}
155 aim.5l\_cs/input.thsice
156 global\_ocean.cs32x15/input.thsice
157
158 \newpage
159 \input{part6/seaice.tex}
160 lab\_sea
161
162 \section{Packages Related to Coupled Model}
163 \newpage
164 \input{part6/aim_compon_interf.tex}
165 cpl\_aim+ocean
166
167 \newpage
168 \input{part6/aim_ocn_coupler.tex}
169 cpl\_aim+ocean
170
171 \newpage
172 \input{part6/component_communications.tex}
173 cpl\_aim+ocean
174
175 \section{Biogeochemistry Packages}
176 \newpage
177 \input{part6/gchem.tex}
178 tutorial\_global\_oce\_biogeo \ref{sect:eg-biogeochem\_tutorial}
179
180 \newpage
181 \input{part6/dic.tex}
182 tutorial\_global\_oce\_biogeo \ref{sect:eg-biogeochem\_tutorial}

  ViewVC Help
Powered by ViewVC 1.1.22