1 |
% $Header: /u/gcmpack/manual/part6/part6.tex,v 1.39 2006/06/27 20:47:05 molod 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} |