/[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.13 by edhill, Tue Jun 27 22:34:09 2006 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{tutorial\_barotropic\_gyre}
   (barotropic with free-surface). This experiment is described in detail in section  
   \ref{sect:eg-baro}.  
28    
29  \item \texttt{tutorial\_baroclinic\_gyre} - Four layer, ocean double gyre. This experiment  \item \texttt{tutorial\_barotropic\_gyre} - single layer, ocean double
30    is described in detail in section \ref{sect:eg-fourlayer}.    gyre (barotropic with free-surface). This experiment is described in
31      detail in section \ref{sect:eg-baro}.
32    
33  \item \texttt{tutorial\_global\_oce\_latlon} - 4x4 degree global ocean simulation with steady  \item \texttt{tutorial\_baroclinic\_gyre} - Four layer, ocean double
34    climatological forcing. This experiment is described in detail in section \ref{sect:eg-global}.    gyre. This experiment is described in detail in section
35      \ref{sect:eg-fourlayer}.
36    
37  \item \texttt{exp4} - Flow over a Gaussian bump in open-water or channel with open boundaries.  \item \texttt{tutorial\_global\_oce\_latlon} - 4x4 degree global ocean
38      simulation with steady climatological forcing. This experiment is
39      described in detail in section \ref{sect:eg-global}.
40    
41    \item \texttt{exp4} - Flow over a Gaussian bump in open-water or
42      channel with open boundaries.
43        
44  \item \texttt{tutorial\_deep\_convection} - Inhomogenously forced ocean convection in a  \item \texttt{tutorial\_deep\_convection} - Inhomogenously forced
45    doubly periodic box. This experiment is described in detail in section \ref{sect:eg-bconv}.    ocean convection in a doubly periodic box. This experiment is
46      described in detail in section \ref{sect:eg-bconv}.
47    
48  \item \texttt{front\_relax} - Relaxation of an ocean thermal front (test for  \item \texttt{front\_relax} - Relaxation of an ocean thermal front
49  Gent/McWilliams scheme). 2D (Y-Z).    (test for Gent/McWilliams scheme). 2D (Y-Z).
50    
51  \item \texttt{internal\_wave} - Ocean internal wave forced by open  \item \texttt{internal\_wave} - Ocean internal wave forced by open
52    boundary conditions.    boundary conditions.
# Line 51  Gent/McWilliams scheme). 2D (Y-Z). Line 60  Gent/McWilliams scheme). 2D (Y-Z).
60  \item \texttt{hs94.128x64x5} - 3D atmosphere dynamics using Held and  \item \texttt{hs94.128x64x5} - 3D atmosphere dynamics using Held and
61    Suarez '94 forcing.    Suarez '94 forcing.
62        
63  \item \texttt{hs94.cs-32x32x5} - 3D atmosphere dynamics using Held and Suarez  \item \texttt{tutorial\_held\_suarez\_cs} - 3D atmosphere dynamics
64    (1994) forcing on the cubed sphere.  This experiment is described in detail in    using Held and Suarez (1994) forcing on the cubed sphere.  This
65    section \ref{sect:eg-hs}.    experiment is described in detail in section \ref{sect:eg-hs}.
66        
67  \item \texttt{aim.5l\_zon-ave} - Intermediate Atmospheric physics.  \item \texttt{aim.5l\_zon-ave} - Intermediate Atmospheric physics.
68    Global Zonal Mean configuration, 1x64x5 resolution.    Global Zonal Mean configuration, 1x64x5 resolution.
# Line 68  Gent/McWilliams scheme). 2D (Y-Z). Line 77  Gent/McWilliams scheme). 2D (Y-Z).
77    Global configuration, on latitude longitude grid with 128x64x5 grid    Global configuration, on latitude longitude grid with 128x64x5 grid
78    points ($2.8^\circ$ resolution).    points ($2.8^\circ$ resolution).
79        
80    \item \texttt{aim.5l\_cs}
81    
82  \item \texttt{adjustment.128x64x1} Barotropic adjustment problem on  \item \texttt{adjustment.128x64x1} Barotropic adjustment problem on
83    latitude longitude grid with 128x64 grid points ($2.8^\circ$ resolution).    latitude longitude grid with 128x64 grid points ($2.8^\circ$ resolution).
84        
# Line 81  Gent/McWilliams scheme). 2D (Y-Z). Line 92  Gent/McWilliams scheme). 2D (Y-Z).
92  \item \texttt{advect\_xy} Two-dimensional (horizontal plane) passive  \item \texttt{advect\_xy} Two-dimensional (horizontal plane) passive
93    advection test on Cartesian grid.    advection test on Cartesian grid.
94        
95  \item \texttt{advect\_yz} Two-dimensional (vertical plane) passive  \item \texttt{advect\_xz} Two-dimensional (vertical plane) passive
96    advection test on Cartesian grid.    advection test on Cartesian grid.
97        
98  \item \texttt{tutorial\_tracer\_adjsens} Simple passive tracer experiment. Includes  \item \texttt{tutorial\_tracer\_adjsens} Simple passive tracer
99    derivative calculation. This experiment is described in detail in section    experiment. Includes derivative calculation. This experiment is
100    \ref{sect:eg-simple-tracer}.    described in detail in section \ref{sect:eg-simple-tracer}.
101    
102  \item \texttt{flt\_example} Example of using float package.  \item \texttt{flt\_example} Example of using float package.
103        
104  \item \texttt{global\_ocean.90x40x15} Global circulation with GM, flux  \item \texttt{global\_ocean.90x40x15} Global circulation with GM, flux
105    boundary conditions and poles.    boundary conditions and poles.
106    
107  \item \texttt{tutorial\_global\_oce\_in\_p} Global circulation in pressure  \item \texttt{tutorial\_global\_oce\_in\_p} Global circulation in
108    coordinate (non-Boussinesq ocean model). Described in detail in    pressure coordinate (non-Boussinesq ocean model). Described in
109    section \ref{sect:eg-globalpressure}.    detail in section \ref{sect:eg-globalpressure}.
110    
111  \item \texttt{solid-body.cs-32x32x1} Solid body rotation test for cube  \item \texttt{solid-body.cs-32x32x1} Solid body rotation test for cube
112    sphere grid.    sphere grid.
113    
114  \item \texttt{tutorial\_plume\_on\_slope} Gravity Plume on a continental slope.  \item \texttt{tutorial\_plume\_on\_slope} Gravity Plume on a
115    This experiment is described in detail in section \ref{sect:eg-gravityplume}.    continental slope.  This experiment is described in detail in
116      section \ref{sect:eg-gravityplume}.
117    
118    \item \texttt{tutorial\_global\_oce\_biogeo} Ocean model coupled to
119      the dissolved inorganic carbon biogeochemistry model. This
120      experiment is described in detail in section
121      \ref{sect:eg-biogeochem_tutorial}.
122    
123    \item \texttt{tutorial\_global\_oce\_optim} Global ocean state
124      estimation at $4^\circ$ resolution.  This experiment is described in
125      detail in section \ref{sect:eg-global_state_estimate}.
126    
127    \item \texttt{tutorial\_offline} Offline form of the MITgcm to study
128      advection of a passive tracer.  This experiment is described in
129      detail in section \ref{sect:eg-offline}.
130    
131    \item \texttt{rotating\_tank} Rotating tank simulation in cylindrical
132      coordinates.  This experiment is described in detail in section
133      \ref{sect:eg-tank}.
134    
135    \item \texttt{MLAdjust} Simple test for different viscosity formulations.
136    
137    \item \texttt{bottom\_ctrl\_5x5} Adjoint test using the bottom
138      topography as the control parameter.
139    
140    \item \texttt{cfc\_example} Global ocean with online computation and
141      advection of CFC11 and CFC12.
142    
143    \item \texttt{dome} Idealized 3D test of a density-driven bottom current.
144    
145    \item \texttt{exp2} Old version of the global ocean experiment.
146    
147    \item \texttt{exp5} Deep convection.
148    
149    \item \texttt{fizhi-cs-32x32x10} Global atmospheric simulation with
150      realistic topography, 10 vertical levels, a cubed sphere grid and
151      the full atmospheric physics package.
152    
153    \item \texttt{fizhi-cs-aqualev20} Global atmospheric simulation on an
154      aqua planet with full atmospheric physics. Run is perpetual march
155      with an analytical SST distribution.  This is the configuration for
156      the APE (Aqua Planet Experiment) participation experiment.
157    
158    \item \texttt{fizhi-gridalt-hs} Global atmospheric simulation
159      Held-Suarez (1994) forcing, with the physical forcing and the
160      dynamical forcing running on different vertical grids.
161    
162    \item \texttt{global\_ocean.cs32x15} Global ocean experiment on the
163      cubed sphere grid, using thermodynamic sea ice and bulk force
164      packages.
165    
166    \item \texttt{global\_ocean\_ebm} Global ocean experiment on a lat-lon
167      grid coupled to an atmospheric energy balance model. Similar to
168      global\_ocean.90x40x15 experiment.
169    
170    \item \texttt{global\_with\_exf} Global ocean experiment on a lat-lon
171      grid using the exf package. Similar to global\_ocean.90x40x15
172      experiment.
173    
174    \item \texttt{hs94.cs-32x32x5} 3D atmosphere dynamics using Held and
175      Suarez (1994) forcing on the cubed sphere. 5 vertical levels.
176    
177    \item \texttt{ideal\_2D\_oce} Idealized 2D global ocean simulation on
178      an aqua planet.
179    
180    \item \texttt{inverted\_barometer} Simple test of ocean response to
181      atmospheric pressure loading.
182    
183  \item \texttt{tutorial\_global\_oce\_biogeo} Ocean model coupled to the dissolved  \item \texttt{lab\_sea} Regional Labrador Sea simulation on a lat-lon
184    inorganic carbon biogeochemistry model. This experiment is described in detail in section    grid. Coupled to the sea ice model.
   \ref{sect:eg-biogeochem\_tutorial}.  
185    
186  \item \texttt{tutorial\_global\_oce\_optim} Global ocean state estimation at $4^\circ$ resolution.  \item \texttt{matrix\_example} Test of experimental method to
187    This experiment is described in detail in section \ref{sect:eg-global\_state\_estimate}.    accelerated convergence towards equillibrium.
188    
189  \item \texttt{tutorial\_offline} Offline form of the MITgcm to study advection of a passive  \item \texttt{tutorial\_cfc\_offline} Offline form of the MITgcm to
190    tracer.  This experiment is described in detail in section \ref{sect:eg-offline}.    study advection of a passive tracer and CFCs.
191    
192  \item \texttt{rotating\_tank} Rotating tank simulation in cylindrical coordinates.  \item \texttt{vermix} Simple test in a small domain (3 columns) for
193    This experiment is described in detail in section \ref{sect:eg-tank}.    ocean vertical mixing schemes.
194    
195  \end{enumerate}  \end{enumerate}
196    
Legend:
Removed from v.1.11  
changed lines
  Added in v.1.13
  ViewVC Help
Powered by ViewVC 1.1.22