/[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.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}  \item \texttt{advection\_in\_gyre\_circulation} - test of various
28      advection schemes in a single-layer double-gyre experiment.
29      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\_barotropic\_gyre} - single layer, ocean double gyre  \item \texttt{front\_relax} - Relaxation of an ocean thermal front
52    (barotropic with free-surface). This experiment is described in detail in section    (test for Gent/McWilliams scheme). 2D (Y-Z).
   \ref{sect:eg-baro}.  
   
 \item \texttt{tutorial\_baroclinic\_gyre} - Four layer, ocean double gyre. This experiment  
   is described in detail in section \ref{sect:eg-fourlayer}.  
   
 \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 53  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{tutorial\_held\_suarez\_cs} - 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 70  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}  \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).
# Line 88  Gent/McWilliams scheme). 2D (Y-Z). Line 98  Gent/McWilliams scheme). 2D (Y-Z).
98  \item \texttt{advect\_xz} 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  \item \texttt{tutorial\_global\_oce\_biogeo} Ocean model coupled to the dissolved  
121    inorganic carbon biogeochemistry model. This experiment is described in detail in section  \item \texttt{tutorial\_global\_oce\_biogeo} Ocean model coupled to
122    \ref{sect:eg-biogeochem\_tutorial}.    the dissolved inorganic carbon biogeochemistry model. This
123      experiment is described in detail in section
124  \item \texttt{tutorial\_global\_oce\_optim} Global ocean state estimation at $4^\circ$ resolution.    \ref{sect:eg-biogeochem_tutorial}.
125    This experiment is described in detail in section \ref{sect:eg-global\_state\_estimate}.  
126    \item \texttt{tutorial\_global\_oce\_optim} Global ocean state
127  \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
128    tracer.  This experiment is described in detail in section \ref{sect:eg-offline}.    detail in section \ref{sect:eg-global_state_estimate}.
129    
130  \item \texttt{rotating\_tank} Rotating tank simulation in cylindrical coordinates.  \item \texttt{tutorial\_offline} Offline form of the MITgcm to study
131    This experiment is described in detail in section \ref{sect:eg-tank}.    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.  \item \texttt{MLAdjust} Simple test for different viscosity formulations.
139    
140  \item \texttt{bottom_ctrl_5x5} Adjoint test using the bottom topography as the  \item \texttt{bottom\_ctrl\_5x5} Adjoint test using the bottom
141    control parameter.    topography as the control parameter.
142    
143  \item \texttt{cfc_example} Global ocean with online computation and advection of  \item \texttt{cfc\_example} Global ocean with online computation and
144  CFC11 and CFC12.    advection of CFC11 and CFC12.
145    
146  \item \texttt{dome} Idealized 3D test of a density-driven bottom current.  \item \texttt{dome} Idealized 3D test of a density-driven bottom current.
147    
# Line 134  CFC11 and CFC12. Line 149  CFC11 and CFC12.
149    
150  \item \texttt{exp5} Deep convection.  \item \texttt{exp5} Deep convection.
151    
152  \item \texttt{fizhi-cs-32x32x10} Global atmospheric simulation with realistic topography,  \item \texttt{fizhi-cs-32x32x10} Global atmospheric simulation with
153    10 vertical levels, a cubed sphere grid and the full atmospheric physics package.    realistic topography, 10 vertical levels, a cubed sphere grid and
154      the full atmospheric physics package.
155    
156    \item \texttt{fizhi-cs-aqualev20} Global atmospheric simulation on an
157      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{fizhi-gridalt-hs} Global atmospheric simulation
162      Held-Suarez (1994) forcing, with the physical forcing and the
163      dynamical forcing running on different vertical grids.
164    
165    \item \texttt{global\_ocean.cs32x15} Global ocean experiment on the
166      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{fizhi-cs-aqualev20} Global atmospheric simulation on an aqua planet with  \item \texttt{global\_with\_exf} Global ocean experiment on a lat-lon
174    full atmospheric physics. Run is perpetual march with an analytical SST distribution.    grid using the exf package. Similar to global\_ocean.90x40x15
175    This is the configuration for the APE (Aqua Planet Experiment) participation experiment.    experiment.
   
 \item \texttt{fizhi-gridalt-hs} Global atmospheric simulation Held-Suarez (1994) forcing,  
   with the physical forcing and the dynamical forcing running on different vertical grids.  
   
 \item \texttt{global_ocean.cs32x15} Global ocean experiment on the cubed sphere grid, using  
 thermodynamic sea ice and bulk force packages.  
   
 \item \texttt{global_ocean_ebm} Global ocean experiment on a lat-lon grid coupled to an  
 atmospheric energy balance model. Similar to global_ocean.90x40x15 experiment.  
   
 \item \texttt{global_with_exf} Global ocean experiment on a lat-lon grid using the exf  
 package. Similar to global_ocean.90x40x15 experiment.  
176    
177  \item \texttt{hs94.cs-32x32x5} 3D atmosphere dynamics using Held and Suarez  \item \texttt{hs94.cs-32x32x5} 3D atmosphere dynamics using Held and
178    (1994) forcing on the cubed sphere. 5 vertical levels.    Suarez (1994) forcing on the cubed sphere. 5 vertical levels.
179    
180  \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
181      an aqua planet.
182    
183  \item \texttt{inverted_barometer} Simple test of ocean response to atmospheric pressure  \item \texttt{inverted\_barometer} Simple test of ocean response to
184  loading.    atmospheric pressure loading.
185    
186  \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
187  the sea ice model.    grid. Coupled to the sea ice model.
188    
189  \item \texttt{matrix_example} Test of experimental method to accelerated convergence towards  \item \texttt{matrix\_example} Test of experimental method to
190  equillibrium.    accelerated convergence towards equillibrium.
191    
192  \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
193    tracer and CFCs.    study advection of a passive tracer and CFCs.
194    
195  \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
196      ocean vertical mixing schemes.
197    
198  \end{enumerate}  \end{enumerate}
199    
# Line 229  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 242  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.12  
changed lines
  Added in v.1.15
  ViewVC Help
Powered by ViewVC 1.1.22