/[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.17 by jmc, Tue Jan 15 21:14:34 2008 UTC revision 1.21 by jmc, Fri Aug 27 13:25:32 2010 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_advection\_in\_gyre} - test of various  \item \texttt{tutorial\_advection\_in\_gyre} - Test of various
28    advection schemes in a single-layer double-gyre experiment.    advection schemes in a single-layer double-gyre experiment.
29    This experiment is described in detail in section    This experiment is described in detail in section
30    \ref{sect:eg-adv-gyre}.    \ref{sect:eg-adv-gyre}.
# Line 33  Each example is briefly described below. Line 33  Each example is briefly described below.
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\_barotropic\_gyre} - single layer, ocean double  \item \texttt{tutorial\_barotropic\_gyre} - Single layer, ocean double
37    gyre (barotropic with free-surface). This experiment is described in    gyre (barotropic with free-surface).
38    detail in section \ref{sect:eg-baro}.    This experiment is described in detail in section \ref{sect:eg-baro}.
39    
40  \item \texttt{tutorial\_cfc\_offline} Offline form of the MITgcm to  \item \texttt{tutorial\_cfc\_offline} - Offline form of the MITgcm to
41    study advection of a passive tracer and CFCs.    study advection of a passive tracer and CFCs.
42      This experiment is described in detail in section \ref{sect:eg-offline-cfc}.
43    
44  \item \texttt{tutorial\_deep\_convection} - Inhomogenously forced  \item \texttt{tutorial\_deep\_convection} - Inhomogenously forced
45    ocean convection in a doubly periodic box. This experiment is    ocean convection in a doubly periodic box. This experiment is
46    described in detail in section \ref{sect:eg-bconv}.    described in detail in section \ref{sect:eg-bconv}.
47    
48  \item \texttt{tutorial\_global\_oce\_biogeo} Ocean model coupled to  \item \texttt{tutorial\_global\_oce\_biogeo} - Ocean model coupled to
49    the dissolved inorganic carbon biogeochemistry model. This    the dissolved inorganic carbon biogeochemistry model. This
50    experiment is described in detail in section    experiment is described in detail in section
51    \ref{sect:eg-biogeochem_tutorial}.    \ref{sect:eg-biogeochem_tutorial}.
52    
53  \item \texttt{tutorial\_global\_oce\_in\_p} Global circulation in  \item \texttt{tutorial\_global\_oce\_in\_p} - Global ocean simulation in
54    pressure coordinate (non-Boussinesq ocean model). Described in    pressure coordinate (non-Boussinesq ocean model). Described in
55    detail in section \ref{sect:eg-globalpressure}.    detail in section \ref{sect:eg-globalpressure}.
56    
# Line 57  Each example is briefly described below. Line 58  Each example is briefly described below.
58    simulation with steady climatological forcing. This experiment is    simulation with steady climatological forcing. This experiment is
59    described in detail in section \ref{sect:eg-global}.    described in detail in section \ref{sect:eg-global}.
60    
61  \item \texttt{tutorial\_global\_oce\_optim} Global ocean state  \item \texttt{tutorial\_global\_oce\_optim} - Global ocean state
62    estimation at $4^\circ$ resolution.  This experiment is described in    estimation at $4^\circ$ resolution.  This experiment is described in
63    detail in section \ref{sect:eg-global_state_estimate}.    detail in section \ref{sect:eg-global_state_estimate}.
64    
65  \item \texttt{tutorial\_held\_suarez\_cs} - 3D atmosphere dynamics  \item \texttt{tutorial\_held\_suarez\_cs} - 3D atmosphere dynamics
66    using Held and Suarez (1994) forcing on the cubed sphere.  This    using Held and Suarez (1994) forcing on cubed sphere grid.  This
67    experiment is described in detail in section \ref{sect:eg-hs}.    experiment is described in detail in section \ref{sect:eg-hs}.
68        
69  \item \texttt{tutorial\_offline} Offline form of the MITgcm to study  \item \texttt{tutorial\_offline} - Offline form of the MITgcm to study
70    advection of a passive tracer.  This experiment is described in    advection of a passive tracer.  This experiment is described in
71    detail in section \ref{sect:eg-offline}.    detail in section \ref{sect:eg-offline}.
72    
73  \item \texttt{tutorial\_plume\_on\_slope} Gravity Plume on a  \item \texttt{tutorial\_plume\_on\_slope} - Gravity Plume on a
74    continental slope.  This experiment is described in detail in    continental slope.  This experiment is described in detail in
75    section \ref{sect:eg-gravityplume}.    section \ref{sect:eg-gravityplume}.
76    
77  \item \texttt{tutorial\_tracer\_adjsens} Simple passive tracer  \item \texttt{tutorial\_tracer\_adjsens} - Simple passive tracer
78    experiment. Includes derivative calculation. This experiment is    experiment. Includes derivative calculation. This experiment is
79    described in detail in section \ref{sect:eg-simple-tracer}.    described in detail in section \ref{sect:eg-simple-tracer-adjoint}.
80    
81  \item \texttt{adjustment.128x64x1} Barotropic adjustment problem on  \item \texttt{adjustment.128x64x1} - Barotropic adjustment problem on
82    latitude longitude grid with 128x64 grid points ($2.8^\circ$ resolution).    latitude longitude grid with 128x64 grid points ($2.8^\circ$ resolution).
83        
84  \item \texttt{adjustment.cs-32x32x1} Barotropic adjustment problem on  \item \texttt{adjustment.cs-32x32x1} - Barotropic adjustment problem on
85    cube sphere grid with 32x32 points per face (roughly $2.8^\circ$    cube sphere grid with 32x32 points per face (roughly $2.8^\circ$
86    resolution).    resolution).\\
87      Also contains a non-linear free-surface adjustment version ({\it input.nlfs/}).
88        
89  \item \texttt{advect\_cs} Two-dimensional passive advection test on  \item \texttt{advect\_cs} Two-dimensional passive advection test on
90    cube sphere grid (32x32 grid points per face, roughly $2.8^\circ$)    cube sphere grid (32x32 grid points per face, roughly $2.8^\circ$)
91        
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      Also contains an additional set-up using Adams-Bashforth 3 ({\it input.ab3\_c4/}).
95        
96  \item \texttt{advect\_xz} Two-dimensional (vertical plane) passive  \item \texttt{advect\_xz} - Two-dimensional (vertical plane) passive
97    advection test on Cartesian grid.    advection test on Cartesian grid.
98        
99  \item \texttt{aim.5l\_Equatorial\_Channel}  \item \texttt{aim.5l\_Equatorial\_Channel}
# Line 103  Each example is briefly described below. Line 106  Each example is briefly described below.
106        
107  \item \texttt{aim.5l\_cs} - 5-levels Intermediate Atmospheric physics,  \item \texttt{aim.5l\_cs} - 5-levels Intermediate Atmospheric physics,
108    Global configuration on cube sphere grid    Global configuration on cube sphere grid
109    (32x32 grid points per face, roughly $2.8^\circ$).    (32x32 grid points per face, roughly $2.8^\circ$).\\
110      Also contains an additional set-up with an ocean mixed layer and thermodynamics
111      sea-ice ({\it input.thSI/}).
112    
113  \item \texttt{bottom\_ctrl\_5x5} Adjoint test using the bottom  \item \texttt{bottom\_ctrl\_5x5} - Adjoint test using the bottom
114    topography as the control parameter.    topography as the control parameter.
115    
116  \item \texttt{cfc\_example} Global ocean with online computation and  \item \texttt{cfc\_example} - Global ocean with online computation and
117    advection of CFC11 and CFC12.    advection of CFC11 and CFC12.
118    
119  \item \texttt{dome} Idealized 3D test of a density-driven bottom current.  \item \texttt{cpl\_aim+ocn} - Coupled Ocean - Atmosphere realistic
120      configuration on cubed-sphere cs32 horizontal grid,
121  \item \texttt{exp2} Old version of the global ocean experiment.    using Intermediate Atmospheric physics ({\it pkg/aim\_v23})
122      thermodynamics seaice ({\it pkg/thsice}) and land packages.
123      on cubed-sphere cs32 in a realistics configuration.
124    
125    \item \texttt{cpl\_atm2d+ocn} - Coupled Ocean - Atmosphere realistic
126      configuration using 2-D Atmospheric Model ({\it pkg/atm2d}).
127    
128    \item \texttt{deep\_anelastic} - Convection simulation on a giant planet:
129      relax both the Boussinesq approximation (anelastic) and the thin atmosphere
130      approximation (deep atmosphere).
131    
132    \item \texttt{dome} - Idealized 3D test of a density-driven bottom current.
133    
134    \item \texttt{exp2} - Old version of the global ocean experiment (no GM,
135          no partial-cells).\\
136      Also contains an additional set-up with ridid-lid ({\it input.rigidLid/}).
137    
138  \item \texttt{exp4} - Flow over a Gaussian bump in open-water or  \item \texttt{exp4} - Flow over a Gaussian bump in open-water or
139    channel with open boundaries.    channel with open boundaries.
140        
141  \item \texttt{exp5} Deep convection.  \item \texttt{exp5} - Deep convection.
142    
143  \item \texttt{fizhi-cs-32x32x40} Global atmospheric simulation with  \item \texttt{fizhi-cs-32x32x40} - Global atmospheric simulation with
144    realistic topography, 10 vertical levels, a cubed sphere grid and    realistic topography, 40 vertical levels, a cubed sphere grid and
145    the full atmospheric physics package.    the full atmospheric physics package.
146    
147  \item \texttt{fizhi-cs-aqualev20} Global atmospheric simulation on an  \item \texttt{fizhi-cs-aqualev20} - Global atmospheric simulation on an
148    aqua planet with full atmospheric physics. Run is perpetual march    aqua planet with full atmospheric physics. Run is perpetual march
149    with an analytical SST distribution.  This is the configuration for    with an analytical SST distribution.  This is the configuration for
150    the APE (Aqua Planet Experiment) participation experiment.    the APE (Aqua Planet Experiment) participation experiment.
151    
152  \item \texttt{fizhi-gridalt-hs} Global atmospheric simulation  \item \texttt{fizhi-gridalt-hs} - Global atmospheric simulation
153    Held-Suarez (1994) forcing, with the physical forcing and the    Held-Suarez (1994) forcing, with the physical forcing and the
154    dynamical forcing running on different vertical grids.    dynamical forcing running on different vertical grids.
155    
156  \item \texttt{flt\_example} Example of using float package.  \item \texttt{flt\_example} - Example of using float package.
157        
158  \item \texttt{front\_relax} - Relaxation of an ocean thermal front  \item \texttt{front\_relax} - Relaxation of an ocean thermal front
159    (test for Gent/McWilliams scheme). 2D (Y-Z).    (test for Gent/McWilliams scheme). 2D (Y-Z).\\
160      Also contains an additional set-up with Mixed-Layer Eddy parameterization
161  \item \texttt{global\_ocean.90x40x15} Global circulation with GM, flux    (Ferrari \& McWilliams, 2007) ({\it input.mxl/}).
162    boundary conditions and poles.  
163    \item \texttt{global1x1\_tot} - ECCO-GODAE production configuration
164     version 1, 2 \& 3
165    
166    \item \texttt{global2x2\_tot} - ECCO production configuration version 0
167    
168    \item \texttt{global\_ocean.90x40x15} Global ocean simulation at 4x4
169      degree resolution. Similar to tutorial\_global\_oce\_latlon, with
170      quasi-non-hydrostatics and non-hydrostatic metric terms.\\
171      Also contains an adjoint set-up ({\it code\_ad/, input\_ad/}).
172    
173    \item \texttt{global\_ocean.cs32x15} - Global ocean experiment on the
174      cubed sphere grid.\\
175      Also contains additional set-ups:
176      \begin{enumerate}
177       \item non-hydrostratic with biharmonic viscosity ({\it input.viscA4/})
178       \item using thermodynamic sea ice and bulk force ({\it input.thsice/})
179       \item using thermodynamic ({\it pkg/thsice}) dynamics ({\it pkg/seaice}) sea-ice
180             and EXF package ({\it input.icedyn/})
181      \end{enumerate}
182    
183  \item \texttt{global\_ocean.cs32x15} Global ocean experiment on the  \item \texttt{global\_ocean\_ebm} - Global ocean experiment on a lat-lon
   cubed sphere grid, using thermodynamic sea ice and bulk force  
   packages.  
   
 \item \texttt{global\_ocean\_ebm} Global ocean experiment on a lat-lon  
184    grid coupled to an atmospheric energy balance model. Similar to    grid coupled to an atmospheric energy balance model. Similar to
185    global\_ocean.90x40x15 experiment.    global\_ocean.90x40x15 experiment.\\
186      Also contains an adjoint set-up ({\it code\_ad/, input\_ad/}).
187    
188  \item \texttt{global\_with\_exf} Global ocean experiment on a lat-lon  \item \texttt{global\_with\_exf} - Global ocean experiment on a lat-lon
189    grid using the exf package. Similar to global\_ocean.90x40x15    grid using the exf package. Similar to global\_ocean.90x40x15
190    experiment.    experiment.
191    
192  \item \texttt{hs94.128x64x5} - 3D atmosphere dynamics using Held and  \item \texttt{hs94.128x64x5} - 3D atmosphere dynamics on lat-lon grid,
193    Suarez '94 forcing.    using Held and Suarez '94 forcing.
     
 \item \texttt{hs94.1x64x5} - Zonal averaged atmosphere using Held and  
   Suarez '94 forcing.  
194        
195  \item \texttt{hs94.cs-32x32x5} 3D atmosphere dynamics using Held and  \item \texttt{hs94.1x64x5} - Zonal averaged atmosphere dynamics
196    Suarez (1994) forcing on the cubed sphere. 5 vertical levels.    using Held and Suarez '94 forcing.\\
197      Also contains an adjoint set-up ({\it code\_ad/, input\_ad/}).
198      
199    \item \texttt{hs94.cs-32x32x5} - 3D atmosphere dynamics using Held and
200      Suarez (1994) forcing on the cubed sphere. 5 vertical levels.\\
201      Also contains an additional set-up with Implicit Internal gravity waves
202      treatment ({\it input.impIGW/}).
203    
204  \item \texttt{ideal\_2D\_oce} Idealized 2D global ocean simulation on  \item \texttt{ideal\_2D\_oce} - Idealized 2D global ocean simulation on
205    an aqua planet.    an aqua planet.
206    
207  \item \texttt{internal\_wave} - Ocean internal wave forced by open  \item \texttt{internal\_wave} - Ocean internal wave forced by open
208    boundary conditions.    boundary conditions.
209    
210  \item \texttt{inverted\_barometer} Simple test of ocean response to  \item \texttt{inverted\_barometer} - Simple test of ocean response to
211    atmospheric pressure loading.    atmospheric pressure loading.
212    
213  \item \texttt{lab\_sea} Regional Labrador Sea simulation on a lat-lon  \item \texttt{isomip} - ISOMIP like set-up including ice-shelf cavities
214    grid. Coupled to the sea ice model.    ({\it pkg/shelfice}).\\
215      Also contains an additional set-up with ({\it input.htd/})
216      but only Martin knows what "htd" stands for.
217    
218    \item \texttt{lab\_sea} - Regional Labrador Sea simulation on a lat-lon
219      grid using the sea ice package.\\
220      Also contains additional set-ups:
221      \begin{enumerate}
222       \item using the LSR solver (instead of EVP dynamics) ({\it input.lsr/})
223       \item using Hibler and Bryan (1987) sea-ice ocean stress ({\it input.hb87/})
224       \item using package {\it salt\_plume} ({\it input.salt\_plume/})
225      \end{enumerate}
226      and also 3 adjoint set-ups ({\it code\_ad/, input\_ad/, input\_ad.noseaicedyn/,
227      input\_ad.noseaice/}).
228    
229  \item \texttt{matrix\_example} Test of experimental method to  \item \texttt{matrix\_example} - Test of experimental method to
230    accelerated convergence towards equillibrium.    accelerated convergence towards equillibrium.
231    
232  \item \texttt{MLAdjust} Simple test for different viscosity formulations.  \item \texttt{MLAdjust} - Simple tests for different viscosity formulations.\\
233      Also contains additional set-ups:
234      \begin{enumerate}
235       \item ({\it input.0.leith/})
236       \item ({\it input.0.leithD/})
237       \item ({\it input.0.smag/})
238       \item ({\it input.1.leith/})
239      \end{enumerate}
240    
241  \item \texttt{natl\_box} - Eastern subtropical North Atlantic with KPP  \item \texttt{natl\_box} - Eastern subtropical North Atlantic with KPP
242    scheme; 1 month integration    scheme; 1 month integration
243    
244    \item \texttt{natl\_box\_adjoint} - Eastern subtropical North Atlantic with KPP
245      scheme; adjoint set-up.
246    
247    \item \texttt{offline\_exf\_seaice} - oceanic surface forcing computed
248      by bulk-formulae ({\it pkg/exf}) and inposed SST (offline ocean).\\
249      Also contains additional set-ups:
250      \begin{enumerate}
251       \item with sea-ice ({\it pkg/seaice}) thermodynamics ({\it input.seaicetd/})
252       \item an adjoint test ({\it code\_ad/, input\_ad/}).
253      \end{enumerate}
254        
255    \item \texttt{OpenAD} simple Adjoint experiement (used also to test
256      open-AD compiler)
257    
258  \item \texttt{rotating\_tank} Rotating tank simulation in cylindrical  \item \texttt{rotating\_tank} Rotating tank simulation in cylindrical
259    coordinates.  This experiment is described in detail in section    coordinates.  This experiment is described in detail in section
260    \ref{sect:eg-tank}.    \ref{sect:eg-tank}.
261    
262    \item \texttt{seaice\_obcs} similar to "lab\_sea" ({\it input.salt\_plume/})
263      experiment with only a fraction of the domain and open-boundary conditions
264      derived from "lab\_sea" experiment.
265    
266  \item \texttt{solid-body.cs-32x32x1} Solid body rotation test for cube  \item \texttt{solid-body.cs-32x32x1} Solid body rotation test for cube
267    sphere grid.    sphere grid.
268    
269    \item \texttt{tidal\_basin\_2d} 2-D vertical section (X-Z) with tidal forcing
270    
271  \item \texttt{vermix} Simple test in a small domain (3 columns) for  \item \texttt{vermix} Simple test in a small domain (3 columns) for
272    ocean vertical mixing schemes.    ocean vertical mixing schemes. The standard set-up ({\it input/}) uses
273      KPP scheme.\\
274      Also contains additional set-ups:
275      \begin{enumerate}
276       \item with Gaspar et al. (1990) ({\it pkg/ggl90}) scheme ({\it input.ggl90/})
277       \item with Mellor \& Yamada (1982) level 2. ({\it pkg/my82}) scheme ({\it input.my82/})
278       \item with Paluszkiewicz \& Romea (1997) ({\it pkg/opps}) scheme ({\it input.opps/})
279       \item with Pacanowski \& Philander (1981) ({\it pkg/pp81}) scheme ({\it input.pp81/})
280      \end{enumerate}
281    
282  \end{enumerate}  \end{enumerate}
283    
# Line 266  compile the code. Line 353  compile the code.
353    
354    
355  \newpage  \newpage
356  \input{part3/case_studies/barotropic_gyre/baro.tex}  \input{s_examples/barotropic_gyre/baro.tex}
357    
358  \newpage  \newpage
359  \input{part3/case_studies/fourlayer_gyre/fourlayer.tex}  \input{s_examples/baroclinic_gyre/fourlayer.tex}
360    
361  \newpage  \newpage
362  \input{part3/case_studies/advection_in_gyre_circulation/adv_gyre.tex}  \input{s_examples/advection_in_gyre/adv_gyre.tex}
363    
364  \newpage  \newpage
365  \input{part3/case_studies/climatalogical_ogcm/climatalogical_ogcm.tex}  \input{s_examples/global_oce_latlon/climatalogical_ogcm.tex}
366    
367  \newpage  \newpage
368  \input{part3/case_studies/ogcm_in_pressure/ogcm_in_pressure.tex}  \input{s_examples/global_oce_in_p/ogcm_in_pressure.tex}
369    
370  \newpage  \newpage
371  \input{part3/case_studies/held_suarez_cs/held_suarez_cs.tex}  \input{s_examples/held_suarez_cs/held_suarez_cs.tex}
372    
373  \newpage  \newpage
374  \input{part3/case_studies/doubly_periodic_convection/convection.tex}  \input{s_examples/deep_convection/convection.tex}
375    
376  \newpage  \newpage
377  \input{part3/case_studies/plume_on_slope/plume_on_slope.tex}  \input{s_examples/plume_on_slope/plume_on_slope.tex}
378    
379  \newpage  \newpage
380  \input{part3/case_studies/biogeochem_tutorial/biogeochem.tex}  \input{s_examples/global_oce_biogeo/biogeochem.tex}
381    
382  \newpage  \newpage
383  \input{part3/case_studies/global_oce_estimation/global_oce_estimation.tex}  \input{s_examples/global_oce_optim/global_oce_estimation.tex}
384    
385  \newpage  \newpage
386  \input{part3/case_studies/sens_airsea_tracer/doc_ad_examples.tex}  \input{s_examples/tracer_adjsens/doc_ad_examples.tex}
387    
388  \newpage  \newpage
389  \input{part3/case_studies/offline/offline_tutorial.tex}  \input{s_examples/cfc_offline/offline_tutorial.tex}
390    
391  \newpage  \newpage
392  \input{part3/case_studies/rotating_tank/tank.tex}  \input{s_examples/rotating_tank/tank.tex}

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

  ViewVC Help
Powered by ViewVC 1.1.22