/[MITgcm]/manual/s_phys_pkgs/text/gchem.tex
ViewVC logotype

Diff of /manual/s_phys_pkgs/text/gchem.tex

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph | View Patch Patch

revision 1.8 by molod, Wed Jun 28 15:35:07 2006 UTC revision 1.9 by stephd, Tue Jan 15 18:03:30 2008 UTC
# Line 17  Note that the gchem package itself is on Line 17  Note that the gchem package itself is on
17  the subroutines used by specific biogeochemical experiments,  the subroutines used by specific biogeochemical experiments,
18  and does not "do" anything on its own.  and does not "do" anything on its own.
19    
20  There are two examples: cfc which looks at 2 tracers with a  There are two examples: {\bf cfc} which looks at 2 tracers with a
21  simple external forcing and dic with 5 tracers whose tendency terms  simple external forcing and {\bf dic} with 4,5 or 6 tracers
22    whose tendency terms
23  are related to one another. We will discuss these here only as  are related to one another. We will discuss these here only as
24  how they provide examples to use this package.  how they provide examples to use this package.
25    
# Line 27  how they provide examples to use this pa Line 28  how they provide examples to use this pa
28    
29  \noindent  \noindent
30  {{\bf FRAMEWORK}} \\  {{\bf FRAMEWORK}} \\
31    The different biogeochemistry frameworks (e.g. cfc of dic)
32    are specified in the packages\_conf file.
33  {\it GCHEM\_OPTIONS.h} includes the compiler options to be used  {\it GCHEM\_OPTIONS.h} includes the compiler options to be used
34  in any experiment. For instance \#define ALLOW\_CFC allows  in any experiment.
35  the CFC code to be run. An important compiler option is  An important compiler option is
36   \#define GCHEM\_SEPARATE\_FORCING which determined   \#define GCHEM\_SEPARATE\_FORCING which determined
37  how and when the tracer forcing is applied (see discussion  how and when the tracer forcing is applied (see discussion
38  on Forcing below).  on Forcing below). See section on dic for some additional
39    flags that can be set for that experiment.
40   There are further runtime parameters   There are further runtime parameters
41  set in {\it data.gchem} and kept in common block {\it GCHEM.h}.  set in {\it data.gchem} and kept in common block {\it GCHEM.h}.
42  These runtime options include:\\  These runtime options include:\\
43  $\bullet$ {\bf tIter0} which is the integer timestep when the tracer experiment  $\bullet$ Parameters to set the timing for periodic forcing files to
44   is initialized. If {\bf nIter0} $=$ {\bf tIter0} then the tracers  be loaded are: {\it gchem\_ForcingPeriod}, {\it gchem\_ForcingCycle}.
45   are initialized to zero or from initial files. If {\bf nIter0} $>$  The former is how often to load, the latter is how often to cycle
46   {\bf tIter0} then tracers (and previous timestep tendency terms)  through those fields (eg. period couple be monthly and cycle one year).
47    are read in from a the ptracers pickup file. Note that tracers  This is used in {\it dic} and {\it cfc}, with gchem\_ForcingPeriod=0
48    of zeros will be carried around if {\bf nIter0} $<$ {\bf tIter0}.  meaning no periodic forcing.
 \\  
49  $\bullet$ {\bf nsubtime} is the integer number of extra timesteps  $\bullet$ {\bf nsubtime} is the integer number of extra timesteps
50   required by the tracer experiment. This will give a timestep   required by the tracer experiment. This will give a timestep
51   of {\bf deltaTtracer}$/${\bf nsubtime} for the dependencies   of {\bf deltaTtracer}$/${\bf nsubtime} for the dependencies
# Line 53  $\bullet$ File names - these are several Line 56  $\bullet$ File names - these are several
56   wind speed is needed in both DIC and CFC packages to calculate   wind speed is needed in both DIC and CFC packages to calculate
57   the air-sea exchange of gases. Not all file names will be used   the air-sea exchange of gases. Not all file names will be used
58   for every tracer experiment.   for every tracer experiment.
59    \\
60    $\bullet$ {\bf gchem\_int\_*} are variable names for run-time set integer numbers. (Currently 1 through 5).
61    \\
62    $\bullet$ {\bf gchem\_rl\_*} are variable names for run-time set real numbers. (Currently 1 through 5).
63    $\bullet$ Note that the old {\bf tIter0} has been replaced by {\bf PTRACERS\_Iter0} which is
64    set in data.ptracers instead.
65    
66  \vspace{.5cm}  \vspace{.5cm}
67    
# Line 125  out by {\it dic\_biotic\_diags.F} which Line 134  out by {\it dic\_biotic\_diags.F} which
134  \subsubsection{GCHEM Diagnostics}  \subsubsection{GCHEM Diagnostics}
135  \label{sec:pkg:gchem:diagnostics}  \label{sec:pkg:gchem:diagnostics}
136    
137    These diagnostics are particularly for the {\bf dic} package.
138    
139  {\footnotesize  {\footnotesize
140  \begin{verbatim}  \begin{verbatim}
141    
# Line 156  to dic and cfc pkgs). Line 167  to dic and cfc pkgs).
167  \label{sec:pkg:gchem:experiments}  \label{sec:pkg:gchem:experiments}
168    
169  \begin{itemize}  \begin{itemize}
170  \item{Global Ocean tutorial, in tutorial\_global\_oce\_biogeo verification directory,    \item{Global Ocean biogeochemical tutorial, in tutorial\_global\_oce\_biogeo verification directory,  
171  described in section \ref{sect:eg-biogeochem_tutorial} }  described in section \ref{sect:eg-biogeochem_tutorial} uses gchem and dic }
172    
173    \item{Global Ocean cfc tutorial, in tutorial\_cfc\_offline verification directory,  
174    uses gchem and cfc (and offline) described in \ref{sect:eg-cfc_offline} }
175    
176    \item{Global Ocean online cfc example in cfc\_example verification directory,  
177    uses gchem and cfc}
178    
179    
180    
181  \end{itemize}  \end{itemize}
182    
Legend:
Removed from v.1.8  
changed lines
  Added in v.1.9
  ViewVC Help
Powered by ViewVC 1.1.22