/[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.13 by edhill, Tue Jun 27 22:34:09 2006 UTC revision 1.17 by jmc, Tue Jan 15 21:14:34 2008 UTC
# Line 24  Each example is briefly described below. Line 24  Each example is briefly described below.
24    
25  \begin{enumerate}  \begin{enumerate}
26        
27  \item \texttt{tutorial\_barotropic\_gyre}  \item \texttt{tutorial_advection\_in\_gyre} - test of various
28      advection schemes in a single-layer double-gyre experiment.
29  \item \texttt{tutorial\_barotropic\_gyre} - single layer, ocean double    This experiment is described in detail in section
30    gyre (barotropic with free-surface). This experiment is described in    \ref{sect:eg-adv-gyre}.
   detail in section \ref{sect:eg-baro}.  
31    
32  \item \texttt{tutorial\_baroclinic\_gyre} - Four layer, ocean double  \item \texttt{tutorial\_baroclinic\_gyre} - Four layer, ocean double
33    gyre. This experiment is described in detail in section    gyre. This experiment is described in detail in section
34    \ref{sect:eg-fourlayer}.    \ref{sect:eg-fourlayer}.
35    
36  \item \texttt{tutorial\_global\_oce\_latlon} - 4x4 degree global ocean  \item \texttt{tutorial\_barotropic\_gyre} - single layer, ocean double
37    simulation with steady climatological forcing. This experiment is    gyre (barotropic with free-surface). This experiment is described in
38    described in detail in section \ref{sect:eg-global}.    detail in section \ref{sect:eg-baro}.
39    
40    \item \texttt{tutorial\_cfc\_offline} Offline form of the MITgcm to
41      study advection of a passive tracer and CFCs.
42    
 \item \texttt{exp4} - Flow over a Gaussian bump in open-water or  
   channel with open boundaries.  
     
43  \item \texttt{tutorial\_deep\_convection} - Inhomogenously forced  \item \texttt{tutorial\_deep\_convection} - Inhomogenously forced
44    ocean convection in a doubly periodic box. This experiment is    ocean convection in a doubly periodic box. This experiment is
45    described in detail in section \ref{sect:eg-bconv}.    described in detail in section \ref{sect:eg-bconv}.
46    
47  \item \texttt{front\_relax} - Relaxation of an ocean thermal front  \item \texttt{tutorial\_global\_oce\_biogeo} Ocean model coupled to
48    (test for Gent/McWilliams scheme). 2D (Y-Z).    the dissolved inorganic carbon biogeochemistry model. This
49      experiment is described in detail in section
50      \ref{sect:eg-biogeochem_tutorial}.
51    
52    \item \texttt{tutorial\_global\_oce\_in\_p} Global circulation in
53      pressure coordinate (non-Boussinesq ocean model). Described in
54      detail in section \ref{sect:eg-globalpressure}.
55    
56    \item \texttt{tutorial\_global\_oce\_latlon} - 4x4 degree global ocean
57      simulation with steady climatological forcing. This experiment is
58      described in detail in section \ref{sect:eg-global}.
59    
60    \item \texttt{tutorial\_global\_oce\_optim} Global ocean state
61      estimation at $4^\circ$ resolution.  This experiment is described in
62      detail in section \ref{sect:eg-global_state_estimate}.
63    
 \item \texttt{internal\_wave} - Ocean internal wave forced by open  
   boundary conditions.  
     
 \item \texttt{natl\_box} - Eastern subtropical North Atlantic with KPP  
   scheme; 1 month integration  
     
 \item \texttt{hs94.1x64x5} - Zonal averaged atmosphere using Held and  
   Suarez '94 forcing.  
     
 \item \texttt{hs94.128x64x5} - 3D atmosphere dynamics using Held and  
   Suarez '94 forcing.  
     
64  \item \texttt{tutorial\_held\_suarez\_cs} - 3D atmosphere dynamics  \item \texttt{tutorial\_held\_suarez\_cs} - 3D atmosphere dynamics
65    using Held and Suarez (1994) forcing on the cubed sphere.  This    using Held and Suarez (1994) forcing on the cubed sphere.  This
66    experiment is described in detail in section \ref{sect:eg-hs}.    experiment is described in detail in section \ref{sect:eg-hs}.
67        
68  \item \texttt{aim.5l\_zon-ave} - Intermediate Atmospheric physics.  \item \texttt{tutorial\_offline} Offline form of the MITgcm to study
69    Global Zonal Mean configuration, 1x64x5 resolution.    advection of a passive tracer.  This experiment is described in
70        detail in section \ref{sect:eg-offline}.
71  \item \texttt{aim.5l\_XZ\_Equatorial\_Slice} - Intermediate  
72    Atmospheric physics, equatorial Slice configuration.  2D (X-Z).  \item \texttt{tutorial\_plume\_on\_slope} Gravity Plume on a
73        continental slope.  This experiment is described in detail in
74  \item \texttt{aim.5l\_Equatorial\_Channel} - Intermediate Atmospheric    section \ref{sect:eg-gravityplume}.
75    physics. 3D Equatorial Channel configuration.  
76      \item \texttt{tutorial\_tracer\_adjsens} Simple passive tracer
77  \item \texttt{aim.5l\_LatLon} - Intermediate Atmospheric physics.    experiment. Includes derivative calculation. This experiment is
78    Global configuration, on latitude longitude grid with 128x64x5 grid    described in detail in section \ref{sect:eg-simple-tracer}.
   points ($2.8^\circ$ resolution).  
     
 \item \texttt{aim.5l\_cs}  
79    
80  \item \texttt{adjustment.128x64x1} Barotropic adjustment problem on  \item \texttt{adjustment.128x64x1} Barotropic adjustment problem on
81    latitude longitude grid with 128x64 grid points ($2.8^\circ$ resolution).    latitude longitude grid with 128x64 grid points ($2.8^\circ$ resolution).
# Line 87  Each example is briefly described below. Line 85  Each example is briefly described below.
85    resolution).    resolution).
86        
87  \item \texttt{advect\_cs} Two-dimensional passive advection test on  \item \texttt{advect\_cs} Two-dimensional passive advection test on
88    cube sphere grid.    cube sphere grid (32x32 grid points per face, roughly $2.8^\circ$)
89        
90  \item \texttt{advect\_xy} Two-dimensional (horizontal plane) passive  \item \texttt{advect\_xy} Two-dimensional (horizontal plane) passive
91    advection test on Cartesian grid.    advection test on Cartesian grid.
# Line 95  Each example is briefly described below. Line 93  Each example is briefly described below.
93  \item \texttt{advect\_xz} Two-dimensional (vertical plane) passive  \item \texttt{advect\_xz} Two-dimensional (vertical plane) passive
94    advection test on Cartesian grid.    advection test on Cartesian grid.
95        
96  \item \texttt{tutorial\_tracer\_adjsens} Simple passive tracer  \item \texttt{aim.5l\_Equatorial\_Channel}
97    experiment. Includes derivative calculation. This experiment is    - 5-levels Intermediate Atmospheric physics,
98    described in detail in section \ref{sect:eg-simple-tracer}.    3D Equatorial Channel configuration.
   
 \item \texttt{flt\_example} Example of using float package.  
99        
100  \item \texttt{global\_ocean.90x40x15} Global circulation with GM, flux  \item \texttt{aim.5l\_LatLon} - 5-levels Intermediate Atmospheric physics,
101    boundary conditions and poles.    Global configuration, on latitude longitude grid with 128x64x5 grid
102      points ($2.8^\circ$ resolution).
103  \item \texttt{tutorial\_global\_oce\_in\_p} Global circulation in    
104    pressure coordinate (non-Boussinesq ocean model). Described in  \item \texttt{aim.5l\_cs} - 5-levels Intermediate Atmospheric physics,
105    detail in section \ref{sect:eg-globalpressure}.    Global configuration on cube sphere grid
106      (32x32 grid points per face, roughly $2.8^\circ$).
 \item \texttt{solid-body.cs-32x32x1} Solid body rotation test for cube  
   sphere grid.  
   
 \item \texttt{tutorial\_plume\_on\_slope} Gravity Plume on a  
   continental slope.  This experiment is described in detail in  
   section \ref{sect:eg-gravityplume}.  
   
 \item \texttt{tutorial\_global\_oce\_biogeo} Ocean model coupled to  
   the dissolved inorganic carbon biogeochemistry model. This  
   experiment is described in detail in section  
   \ref{sect:eg-biogeochem_tutorial}.  
   
 \item \texttt{tutorial\_global\_oce\_optim} Global ocean state  
   estimation at $4^\circ$ resolution.  This experiment is described in  
   detail in section \ref{sect:eg-global_state_estimate}.  
   
 \item \texttt{tutorial\_offline} Offline form of the MITgcm to study  
   advection of a passive tracer.  This experiment is described in  
   detail in section \ref{sect:eg-offline}.  
   
 \item \texttt{rotating\_tank} Rotating tank simulation in cylindrical  
   coordinates.  This experiment is described in detail in section  
   \ref{sect:eg-tank}.  
   
 \item \texttt{MLAdjust} Simple test for different viscosity formulations.  
107    
108  \item \texttt{bottom\_ctrl\_5x5} Adjoint test using the bottom  \item \texttt{bottom\_ctrl\_5x5} Adjoint test using the bottom
109    topography as the control parameter.    topography as the control parameter.
# Line 144  Each example is briefly described below. Line 115  Each example is briefly described below.
115    
116  \item \texttt{exp2} Old version of the global ocean experiment.  \item \texttt{exp2} Old version of the global ocean experiment.
117    
118    \item \texttt{exp4} - Flow over a Gaussian bump in open-water or
119      channel with open boundaries.
120      
121  \item \texttt{exp5} Deep convection.  \item \texttt{exp5} Deep convection.
122    
123  \item \texttt{fizhi-cs-32x32x10} Global atmospheric simulation with  \item \texttt{fizhi-cs-32x32x40} Global atmospheric simulation with
124    realistic topography, 10 vertical levels, a cubed sphere grid and    realistic topography, 10 vertical levels, a cubed sphere grid and
125    the full atmospheric physics package.    the full atmospheric physics package.
126    
# Line 159  Each example is briefly described below. Line 133  Each example is briefly described below.
133    Held-Suarez (1994) forcing, with the physical forcing and the    Held-Suarez (1994) forcing, with the physical forcing and the
134    dynamical forcing running on different vertical grids.    dynamical forcing running on different vertical grids.
135    
136    \item \texttt{flt\_example} Example of using float package.
137      
138    \item \texttt{front\_relax} - Relaxation of an ocean thermal front
139      (test for Gent/McWilliams scheme). 2D (Y-Z).
140    
141    \item \texttt{global\_ocean.90x40x15} Global circulation with GM, flux
142      boundary conditions and poles.
143    
144  \item \texttt{global\_ocean.cs32x15} Global ocean experiment on the  \item \texttt{global\_ocean.cs32x15} Global ocean experiment on the
145    cubed sphere grid, using thermodynamic sea ice and bulk force    cubed sphere grid, using thermodynamic sea ice and bulk force
146    packages.    packages.
# Line 171  Each example is briefly described below. Line 153  Each example is briefly described below.
153    grid using the exf package. Similar to global\_ocean.90x40x15    grid using the exf package. Similar to global\_ocean.90x40x15
154    experiment.    experiment.
155    
156    \item \texttt{hs94.128x64x5} - 3D atmosphere dynamics using Held and
157      Suarez '94 forcing.
158      
159    \item \texttt{hs94.1x64x5} - Zonal averaged atmosphere using Held and
160      Suarez '94 forcing.
161      
162  \item \texttt{hs94.cs-32x32x5} 3D atmosphere dynamics using Held and  \item \texttt{hs94.cs-32x32x5} 3D atmosphere dynamics using Held and
163    Suarez (1994) forcing on the cubed sphere. 5 vertical levels.    Suarez (1994) forcing on the cubed sphere. 5 vertical levels.
164    
165  \item \texttt{ideal\_2D\_oce} Idealized 2D global ocean simulation on  \item \texttt{ideal\_2D\_oce} Idealized 2D global ocean simulation on
166    an aqua planet.    an aqua planet.
167    
168    \item \texttt{internal\_wave} - Ocean internal wave forced by open
169      boundary conditions.
170    
171  \item \texttt{inverted\_barometer} Simple test of ocean response to  \item \texttt{inverted\_barometer} Simple test of ocean response to
172    atmospheric pressure loading.    atmospheric pressure loading.
173    
# Line 186  Each example is briefly described below. Line 177  Each example is briefly described below.
177  \item \texttt{matrix\_example} Test of experimental method to  \item \texttt{matrix\_example} Test of experimental method to
178    accelerated convergence towards equillibrium.    accelerated convergence towards equillibrium.
179    
180  \item \texttt{tutorial\_cfc\_offline} Offline form of the MITgcm to  \item \texttt{MLAdjust} Simple test for different viscosity formulations.
181    study advection of a passive tracer and CFCs.  
182    \item \texttt{natl\_box} - Eastern subtropical North Atlantic with KPP
183      scheme; 1 month integration
184      
185    \item \texttt{rotating\_tank} Rotating tank simulation in cylindrical
186      coordinates.  This experiment is described in detail in section
187      \ref{sect:eg-tank}.
188    
189    \item \texttt{solid-body.cs-32x32x1} Solid body rotation test for cube
190      sphere grid.
191    
192  \item \texttt{vermix} Simple test in a small domain (3 columns) for  \item \texttt{vermix} Simple test in a small domain (3 columns) for
193    ocean vertical mixing schemes.    ocean vertical mixing schemes.
# Line 249  Each example directory has the following Line 249  Each example directory has the following
249    In addition, you will also find in this directory the forcing and    In addition, you will also find in this directory the forcing and
250    topography files as well as the files describing the initial state    topography files as well as the files describing the initial state
251    of the experiment.  This varies from experiment to experiment. See    of the experiment.  This varies from experiment to experiment. See
252    section 2 for more details.    the verification directories refered to in this chapter for more details.
253    
254  \item \texttt{results}: this directory contains the output file  \item \texttt{results}: this directory contains the output file
255    \texttt{output.txt} produced by the simulation example. This file is    \texttt{output.txt} produced by the simulation example. This file is
256    useful for comparison with your own output when you run the    useful for comparison with your own output when you run the
257    experiment.    experiment.
258    
259    \item \texttt{build}: this directory is where the model is compiled
260      and loaded, and where the executable resides.
261    
262  \end{itemize}  \end{itemize}
263    
264  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 268  compile the code. Line 272  compile the code.
272  \input{part3/case_studies/fourlayer_gyre/fourlayer.tex}  \input{part3/case_studies/fourlayer_gyre/fourlayer.tex}
273    
274  \newpage  \newpage
275    \input{part3/case_studies/advection_in_gyre_circulation/adv_gyre.tex}
276    
277    \newpage
278  \input{part3/case_studies/climatalogical_ogcm/climatalogical_ogcm.tex}  \input{part3/case_studies/climatalogical_ogcm/climatalogical_ogcm.tex}
279    
280  \newpage  \newpage
# Line 283  compile the code. Line 290  compile the code.
290  \input{part3/case_studies/plume_on_slope/plume_on_slope.tex}  \input{part3/case_studies/plume_on_slope/plume_on_slope.tex}
291    
292  \newpage  \newpage
 \input{part3/case_studies/carbon_outgassing_sensitivity/co2sens.tex}  
   
 \newpage  
293  \input{part3/case_studies/biogeochem_tutorial/biogeochem.tex}  \input{part3/case_studies/biogeochem_tutorial/biogeochem.tex}
294    
295  \newpage  \newpage

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

  ViewVC Help
Powered by ViewVC 1.1.22