/[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.12 by molod, Tue Jun 27 20:47:05 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    
# Line 23  under the directory \texttt{verification Line 26  under the directory \texttt{verification
26        
27  \item \texttt{tutorial\_barotropic\_gyre}  \item \texttt{tutorial\_barotropic\_gyre}
28    
29  \item \texttt{tutorial\_barotropic\_gyre} - single layer, ocean double gyre  \item \texttt{tutorial\_barotropic\_gyre} - single layer, ocean double
30    (barotropic with free-surface). This experiment is described in detail in section    gyre (barotropic with free-surface). This experiment is described in
31    \ref{sect:eg-baro}.    detail in section \ref{sect:eg-baro}.
32    
33    \item \texttt{tutorial\_baroclinic\_gyre} - Four layer, ocean double
34      gyre. This experiment is described in detail in section
35      \ref{sect:eg-fourlayer}.
36    
37    \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
45      ocean convection in a doubly periodic box. This experiment is
46      described in detail in section \ref{sect:eg-bconv}.
47    
48  \item \texttt{tutorial\_baroclinic\_gyre} - Four layer, ocean double gyre. This experiment  \item \texttt{front\_relax} - Relaxation of an ocean thermal front
49    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).  
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 53  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{tutorial\_held\_suarez\_cs} - 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 70  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}  \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).
# Line 88  Gent/McWilliams scheme). 2D (Y-Z). Line 95  Gent/McWilliams scheme). 2D (Y-Z).
95  \item \texttt{advect\_xz} 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  \item \texttt{tutorial\_global\_oce\_biogeo} Ocean model coupled to the dissolved  
118    inorganic carbon biogeochemistry model. This experiment is described in detail in section  \item \texttt{tutorial\_global\_oce\_biogeo} Ocean model coupled to
119    \ref{sect:eg-biogeochem\_tutorial}.    the dissolved inorganic carbon biogeochemistry model. This
120      experiment is described in detail in section
121  \item \texttt{tutorial\_global\_oce\_optim} Global ocean state estimation at $4^\circ$ resolution.    \ref{sect:eg-biogeochem_tutorial}.
122    This experiment is described in detail in section \ref{sect:eg-global\_state\_estimate}.  
123    \item \texttt{tutorial\_global\_oce\_optim} Global ocean state
124  \item \texttt{tutorial\_offline} Offline form of the MITgcm to study advection of a passive    estimation at $4^\circ$ resolution.  This experiment is described in
125    tracer.  This experiment is described in detail in section \ref{sect:eg-offline}.    detail in section \ref{sect:eg-global_state_estimate}.
126    
127  \item \texttt{rotating\_tank} Rotating tank simulation in cylindrical coordinates.  \item \texttt{tutorial\_offline} Offline form of the MITgcm to study
128    This experiment is described in detail in section \ref{sect:eg-tank}.    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.  \item \texttt{MLAdjust} Simple test for different viscosity formulations.
136    
137  \item \texttt{bottom_ctrl_5x5} Adjoint test using the bottom topography as the  \item \texttt{bottom\_ctrl\_5x5} Adjoint test using the bottom
138    control parameter.    topography as the control parameter.
139    
140  \item \texttt{cfc_example} Global ocean with online computation and advection of  \item \texttt{cfc\_example} Global ocean with online computation and
141  CFC11 and CFC12.    advection of CFC11 and CFC12.
142    
143  \item \texttt{dome} Idealized 3D test of a density-driven bottom current.  \item \texttt{dome} Idealized 3D test of a density-driven bottom current.
144    
# Line 134  CFC11 and CFC12. Line 146  CFC11 and CFC12.
146    
147  \item \texttt{exp5} Deep convection.  \item \texttt{exp5} Deep convection.
148    
149  \item \texttt{fizhi-cs-32x32x10} Global atmospheric simulation with realistic topography,  \item \texttt{fizhi-cs-32x32x10} Global atmospheric simulation with
150    10 vertical levels, a cubed sphere grid and the full atmospheric physics package.    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 aqua planet with  \item \texttt{fizhi-cs-aqualev20} Global atmospheric simulation on an
154    full atmospheric physics. Run is perpetual march with an analytical SST distribution.    aqua planet with full atmospheric physics. Run is perpetual march
155    This is the configuration for the APE (Aqua Planet Experiment) participation experiment.    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 Held-Suarez (1994) forcing,  \item \texttt{fizhi-gridalt-hs} Global atmospheric simulation
159    with the physical forcing and the dynamical forcing running on different vertical grids.    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 cubed sphere grid, using  \item \texttt{global\_ocean.cs32x15} Global ocean experiment on the
163  thermodynamic sea ice and bulk force packages.    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 grid coupled to an  \item \texttt{global\_ocean\_ebm} Global ocean experiment on a lat-lon
167  atmospheric energy balance model. Similar to global_ocean.90x40x15 experiment.    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 grid using the exf  \item \texttt{global\_with\_exf} Global ocean experiment on a lat-lon
171  package. Similar to global_ocean.90x40x15 experiment.    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 Suarez  \item \texttt{hs94.cs-32x32x5} 3D atmosphere dynamics using Held and
175    (1994) forcing on the cubed sphere. 5 vertical levels.    Suarez (1994) forcing on the cubed sphere. 5 vertical levels.
176    
177  \item \texttt{ideal_2D_oce} Idealized 2D global ocean simulation on an aqua planet.  \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 atmospheric pressure  \item \texttt{inverted\_barometer} Simple test of ocean response to
181  loading.    atmospheric pressure loading.
182    
183  \item \texttt{lab_sea} Regional Labrador Sea simulation on a lat-lon grid. Coupled to  \item \texttt{lab\_sea} Regional Labrador Sea simulation on a lat-lon
184  the sea ice model.    grid. Coupled to the sea ice model.
185    
186  \item \texttt{matrix_example} Test of experimental method to accelerated convergence towards  \item \texttt{matrix\_example} Test of experimental method to
187  equillibrium.    accelerated convergence towards equillibrium.
188    
189  \item \texttt{tutorial_cfc_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 and CFCs.    study advection of a passive tracer and CFCs.
191    
192  \item \texttt{vermix} Simple test in a small domain (3 columns) for ocean vertical mixing schemes.  \item \texttt{vermix} Simple test in a small domain (3 columns) for
193      ocean vertical mixing schemes.
194    
195  \end{enumerate}  \end{enumerate}
196    

Legend:
Removed from v.1.12  
changed lines
  Added in v.1.13

  ViewVC Help
Powered by ViewVC 1.1.22