/[MITgcm]/manual/s_examples/text/model_examples.tex
ViewVC logotype

Diff of /manual/s_examples/text/model_examples.tex

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

revision 1.11 by molod, Tue Jun 27 19:08:22 2006 UTC revision 1.15 by jahn, Tue Jan 15 16:31:06 2008 UTC
# Line 9  Line 9 
9    
10  %% a set of pre-configured numerical experiments  %% a set of pre-configured numerical experiments
11    
12  The full MITgcm distribution comes with a set of pre-configured numerical experiments.  The full MITgcm distribution comes with a set of pre-configured
13  Some of these example experiments are tests of individual parts of the model code, but many  numerical experiments.  Some of these example experiments are tests of
14  are fully fledged numerical simulations. Full tutorials exist for a few of the examples,  individual parts of the model code, but many are fully fledged
15  and are documented in sections \ref{sect:eg-baro} - \ref{sect:eg-tank}. The other examples  numerical simulations. Full tutorials exist for a few of the examples,
16  follow the same general structure as the tutorial examples. However, they only include brief  and are documented in sections \ref{sect:eg-baro} -
17  instructions in a text file called {\it README}.  The examples are located in subdirectories  \ref{sect:eg-tank}. The other examples follow the same general
18  under the directory \texttt{verification}.  Each example is briefly described below.  structure as the tutorial examples. However, they only include brief
19    instructions in a text file called {\it README}.  The examples are
20    located in subdirectories under the directory \texttt{verification}.
21    Each example is briefly described below.
22    
23  \subsection{Full list of model examples}  \subsection{Full list of model examples}
24    
25  \begin{enumerate}  \begin{enumerate}
26        
27  \item \texttt{tutorial\_barotropic\_gyre} - single layer, ocean double gyre  \item \texttt{advection\_in\_gyre\_circulation} - test of various
28    (barotropic with free-surface). This experiment is described in detail in section    advection schemes in a single-layer double-gyre experiment.
29    \ref{sect:eg-baro}.    This experiment is described in detail in section
30      \ref{sect:eg-adv-gyre}.
31    
32    \item \texttt{tutorial\_barotropic\_gyre} - single layer, ocean double
33      gyre (barotropic with free-surface). This experiment is described in
34      detail in section \ref{sect:eg-baro}.
35    
36    \item \texttt{tutorial\_baroclinic\_gyre} - Four layer, ocean double
37      gyre. This experiment is described in detail in section
38      \ref{sect:eg-fourlayer}.
39    
40    \item \texttt{tutorial\_global\_oce\_latlon} - 4x4 degree global ocean
41      simulation with steady climatological forcing. This experiment is
42      described in detail in section \ref{sect:eg-global}.
43    
44    \item \texttt{exp4} - Flow over a Gaussian bump in open-water or
45      channel with open boundaries.
46      
47    \item \texttt{tutorial\_deep\_convection} - Inhomogenously forced
48      ocean convection in a doubly periodic box. This experiment is
49      described in detail in section \ref{sect:eg-bconv}.
50    
51  \item \texttt{tutorial\_baroclinic\_gyre} - Four layer, ocean double gyre. This experiment  \item \texttt{front\_relax} - Relaxation of an ocean thermal front
52    is described in detail in section \ref{sect:eg-fourlayer}.    (test for Gent/McWilliams scheme). 2D (Y-Z).
   
 \item \texttt{tutorial\_global\_oce\_latlon} - 4x4 degree global ocean simulation with steady  
   climatological forcing. This experiment is described in detail in section \ref{sect:eg-global}.  
   
 \item \texttt{exp4} - Flow over a Gaussian bump in open-water or channel with open boundaries.  
     
 \item \texttt{tutorial\_deep\_convection} - Inhomogenously forced ocean convection in a  
   doubly periodic box. This experiment is described in detail in section \ref{sect:eg-bconv}.  
   
 \item \texttt{front\_relax} - Relaxation of an ocean thermal front (test for  
 Gent/McWilliams scheme). 2D (Y-Z).  
53    
54  \item \texttt{internal\_wave} - Ocean internal wave forced by open  \item \texttt{internal\_wave} - Ocean internal wave forced by open
55    boundary conditions.    boundary conditions.
# Line 51  Gent/McWilliams scheme). 2D (Y-Z). Line 63  Gent/McWilliams scheme). 2D (Y-Z).
63  \item \texttt{hs94.128x64x5} - 3D atmosphere dynamics using Held and  \item \texttt{hs94.128x64x5} - 3D atmosphere dynamics using Held and
64    Suarez '94 forcing.    Suarez '94 forcing.
65        
66  \item \texttt{hs94.cs-32x32x5} - 3D atmosphere dynamics using Held and Suarez  \item \texttt{tutorial\_held\_suarez\_cs} - 3D atmosphere dynamics
67    (1994) forcing on the cubed sphere.  This experiment is described in detail in    using Held and Suarez (1994) forcing on the cubed sphere.  This
68    section \ref{sect:eg-hs}.    experiment is described in detail in section \ref{sect:eg-hs}.
69        
70  \item \texttt{aim.5l\_zon-ave} - Intermediate Atmospheric physics.  \item \texttt{aim.5l\_zon-ave} - Intermediate Atmospheric physics.
71    Global Zonal Mean configuration, 1x64x5 resolution.    Global Zonal Mean configuration, 1x64x5 resolution.
# Line 68  Gent/McWilliams scheme). 2D (Y-Z). Line 80  Gent/McWilliams scheme). 2D (Y-Z).
80    Global configuration, on latitude longitude grid with 128x64x5 grid    Global configuration, on latitude longitude grid with 128x64x5 grid
81    points ($2.8^\circ$ resolution).    points ($2.8^\circ$ resolution).
82        
83    \item \texttt{aim.5l\_cs}
84    
85  \item \texttt{adjustment.128x64x1} Barotropic adjustment problem on  \item \texttt{adjustment.128x64x1} Barotropic adjustment problem on
86    latitude longitude grid with 128x64 grid points ($2.8^\circ$ resolution).    latitude longitude grid with 128x64 grid points ($2.8^\circ$ resolution).
87        
# Line 81  Gent/McWilliams scheme). 2D (Y-Z). Line 95  Gent/McWilliams scheme). 2D (Y-Z).
95  \item \texttt{advect\_xy} Two-dimensional (horizontal plane) passive  \item \texttt{advect\_xy} Two-dimensional (horizontal plane) passive
96    advection test on Cartesian grid.    advection test on Cartesian grid.
97        
98  \item \texttt{advect\_yz} Two-dimensional (vertical plane) passive  \item \texttt{advect\_xz} Two-dimensional (vertical plane) passive
99    advection test on Cartesian grid.    advection test on Cartesian grid.
100        
101  \item \texttt{tutorial\_tracer\_adjsens} Simple passive tracer experiment. Includes  \item \texttt{tutorial\_tracer\_adjsens} Simple passive tracer
102    derivative calculation. This experiment is described in detail in section    experiment. Includes derivative calculation. This experiment is
103    \ref{sect:eg-simple-tracer}.    described in detail in section \ref{sect:eg-simple-tracer}.
104    
105  \item \texttt{flt\_example} Example of using float package.  \item \texttt{flt\_example} Example of using float package.
106        
107  \item \texttt{global\_ocean.90x40x15} Global circulation with GM, flux  \item \texttt{global\_ocean.90x40x15} Global circulation with GM, flux
108    boundary conditions and poles.    boundary conditions and poles.
109    
110  \item \texttt{tutorial\_global\_oce\_in\_p} Global circulation in pressure  \item \texttt{tutorial\_global\_oce\_in\_p} Global circulation in
111    coordinate (non-Boussinesq ocean model). Described in detail in    pressure coordinate (non-Boussinesq ocean model). Described in
112    section \ref{sect:eg-globalpressure}.    detail in section \ref{sect:eg-globalpressure}.
113    
114  \item \texttt{solid-body.cs-32x32x1} Solid body rotation test for cube  \item \texttt{solid-body.cs-32x32x1} Solid body rotation test for cube
115    sphere grid.    sphere grid.
116    
117  \item \texttt{tutorial\_plume\_on\_slope} Gravity Plume on a continental slope.  \item \texttt{tutorial\_plume\_on\_slope} Gravity Plume on a
118    This experiment is described in detail in section \ref{sect:eg-gravityplume}.    continental slope.  This experiment is described in detail in
119      section \ref{sect:eg-gravityplume}.
120    
121    \item \texttt{tutorial\_global\_oce\_biogeo} Ocean model coupled to
122      the dissolved inorganic carbon biogeochemistry model. This
123      experiment is described in detail in section
124      \ref{sect:eg-biogeochem_tutorial}.
125    
126    \item \texttt{tutorial\_global\_oce\_optim} Global ocean state
127      estimation at $4^\circ$ resolution.  This experiment is described in
128      detail in section \ref{sect:eg-global_state_estimate}.
129    
130    \item \texttt{tutorial\_offline} Offline form of the MITgcm to study
131      advection of a passive tracer.  This experiment is described in
132      detail in section \ref{sect:eg-offline}.
133    
134    \item \texttt{rotating\_tank} Rotating tank simulation in cylindrical
135      coordinates.  This experiment is described in detail in section
136      \ref{sect:eg-tank}.
137    
138    \item \texttt{MLAdjust} Simple test for different viscosity formulations.
139    
140    \item \texttt{bottom\_ctrl\_5x5} Adjoint test using the bottom
141      topography as the control parameter.
142    
143    \item \texttt{cfc\_example} Global ocean with online computation and
144      advection of CFC11 and CFC12.
145    
146    \item \texttt{dome} Idealized 3D test of a density-driven bottom current.
147    
148    \item \texttt{exp2} Old version of the global ocean experiment.
149    
150    \item \texttt{exp5} Deep convection.
151    
152  \item \texttt{tutorial\_global\_oce\_biogeo} Ocean model coupled to the dissolved  \item \texttt{fizhi-cs-32x32x10} Global atmospheric simulation with
153    inorganic carbon biogeochemistry model. This experiment is described in detail in section    realistic topography, 10 vertical levels, a cubed sphere grid and
154    \ref{sect:eg-biogeochem\_tutorial}.    the full atmospheric physics package.
155    
156  \item \texttt{tutorial\_global\_oce\_optim} Global ocean state estimation at $4^\circ$ resolution.  \item \texttt{fizhi-cs-aqualev20} Global atmospheric simulation on an
157    This experiment is described in detail in section \ref{sect:eg-global\_state\_estimate}.    aqua planet with full atmospheric physics. Run is perpetual march
158      with an analytical SST distribution.  This is the configuration for
159      the APE (Aqua Planet Experiment) participation experiment.
160    
161  \item \texttt{tutorial\_offline} Offline form of the MITgcm to study advection of a passive  \item \texttt{fizhi-gridalt-hs} Global atmospheric simulation
162    tracer.  This experiment is described in detail in section \ref{sect:eg-offline}.    Held-Suarez (1994) forcing, with the physical forcing and the
163      dynamical forcing running on different vertical grids.
164    
165  \item \texttt{rotating\_tank} Rotating tank simulation in cylindrical coordinates.  \item \texttt{global\_ocean.cs32x15} Global ocean experiment on the
166    This experiment is described in detail in section \ref{sect:eg-tank}.    cubed sphere grid, using thermodynamic sea ice and bulk force
167      packages.
168    
169    \item \texttt{global\_ocean\_ebm} Global ocean experiment on a lat-lon
170      grid coupled to an atmospheric energy balance model. Similar to
171      global\_ocean.90x40x15 experiment.
172    
173    \item \texttt{global\_with\_exf} Global ocean experiment on a lat-lon
174      grid using the exf package. Similar to global\_ocean.90x40x15
175      experiment.
176    
177    \item \texttt{hs94.cs-32x32x5} 3D atmosphere dynamics using Held and
178      Suarez (1994) forcing on the cubed sphere. 5 vertical levels.
179    
180    \item \texttt{ideal\_2D\_oce} Idealized 2D global ocean simulation on
181      an aqua planet.
182    
183    \item \texttt{inverted\_barometer} Simple test of ocean response to
184      atmospheric pressure loading.
185    
186    \item \texttt{lab\_sea} Regional Labrador Sea simulation on a lat-lon
187      grid. Coupled to the sea ice model.
188    
189    \item \texttt{matrix\_example} Test of experimental method to
190      accelerated convergence towards equillibrium.
191    
192    \item \texttt{tutorial\_cfc\_offline} Offline form of the MITgcm to
193      study advection of a passive tracer and CFCs.
194    
195    \item \texttt{vermix} Simple test in a small domain (3 columns) for
196      ocean vertical mixing schemes.
197    
198  \end{enumerate}  \end{enumerate}
199    
# Line 173  Each example directory has the following Line 252  Each example directory has the following
252    In addition, you will also find in this directory the forcing and    In addition, you will also find in this directory the forcing and
253    topography files as well as the files describing the initial state    topography files as well as the files describing the initial state
254    of the experiment.  This varies from experiment to experiment. See    of the experiment.  This varies from experiment to experiment. See
255    section 2 for more details.    the verification directories refered to in this chapter for more details.
256    
257  \item \texttt{results}: this directory contains the output file  \item \texttt{results}: this directory contains the output file
258    \texttt{output.txt} produced by the simulation example. This file is    \texttt{output.txt} produced by the simulation example. This file is
259    useful for comparison with your own output when you run the    useful for comparison with your own output when you run the
260    experiment.    experiment.
261    
262    \item \texttt{build}: this directory is where the model is compiled
263      and loaded, and where the executable resides.
264    
265  \end{itemize}  \end{itemize}
266    
267  Once you have chosen the example you want to run, you are ready to  Once you have chosen the example you want to run, you are ready to
# Line 186  compile the code. Line 269  compile the code.
269    
270    
271  \newpage  \newpage
272    \input{part3/case_studies/advection_in_gyre_circulation/adv_gyre.tex}
273    
274    \newpage
275  \input{part3/case_studies/barotropic_gyre/baro.tex}  \input{part3/case_studies/barotropic_gyre/baro.tex}
276    
277  \newpage  \newpage
Legend:
Removed from v.1.11  
changed lines
  Added in v.1.15
  ViewVC Help
Powered by ViewVC 1.1.22