manual/s_ecco/exf.tex

\section{The external forcing package \texttt{exf}
\label{sectionexf}}
\begin{rawhtml}
<!-- CMIREDIR:sectionexf: -->
\end{rawhtml}

\subsection{Summary}

{\footnotesize
\begin{verbatim}
c     Field definitions, units, and sign conventions:
c     ===============================================
c
c     ustress   :: Zonal surface wind stress in N/m^2
c                  > 0 for increase in uVel, which is west to
c                      east for cartesian and spherical polar grids
c                  Typical range: -0.5 < ustress < 0.5
c                  Southwest C-grid U point
c                  Input field
c
c     vstress   :: Meridional surface wind stress in N/m^2
c                  > 0 for increase in vVel, which is south to
c                      north for cartesian and spherical polar grids
c                  Typical range: -0.5 < vstress < 0.5
c                  Southwest C-grid V point
c                  Input field
c
c     hflux     :: Net upward surface heat flux excluding shortwave in W/m^2
c                  hflux = latent + sensible + lwflux
c                  > 0 for decrease in theta (ocean cooling)
c                  Typical range: -250 < hflux < 600
c                  Southwest C-grid tracer point
c                  Input field
c
c     sflux     :: Net upward freshwater flux in m/s
c                  sflux = evap - precip - runoff
c                  > 0 for increase in salt (ocean salinity)
c                  Typical range: -1e-7 < sflux < 1e-7
c                  Southwest C-grid tracer point
c                  Input field
c
c     swflux    :: Net upward shortwave radiation in W/m^2
c                  swflux = - ( swdown - ice and snow absorption - reflected )
c                  > 0 for decrease in theta (ocean cooling)
c                  Typical range: -350 < swflux < 0
c                  Southwest C-grid tracer point
c                  Input field
c
c     uwind     :: Surface (10-m) zonal wind velocity in m/s
c                  > 0 for increase in uVel, which is west to
c                      east for cartesian and spherical polar grids
c                  Typical range: -10 < uwind < 10
c                  Southwest C-grid U point
c                  Input or input/output field
c
c     vwind     :: Surface (10-m) meridional wind velocity in m/s
c                  > 0 for increase in vVel, which is south to
c                      north for cartesian and spherical polar grids
c                  Typical range: -10 < vwind < 10
c                  Southwest C-grid V point
c                  Input or input/output field
c
c     atemp     :: Surface (2-m) air temperature in deg K
c                  Typical range: 200 < atemp < 300
c                  Southwest C-grid tracer point
c                  Input or input/output field
c
c     aqh       :: Surface (2m) specific humidity in kg/kg
c                  Typical range: 0 < aqh < 0.02
c                  Southwest C-grid tracer point
c                  Input or input/output field
c
c     lwflux    :: Net upward longwave radiation in W/m^2
c                  lwflux = - ( lwdown - ice and snow absorption - emitted )
c                  > 0 for decrease in theta (ocean cooling)
c                  Typical range: -20 < lwflux < 170
c                  Southwest C-grid tracer point
c                  Input field
c
c     evap      :: Evaporation in m/s
c                  > 0 for increase in salt (ocean salinity)
c                  Typical range: 0 < evap < 2.5e-7
c                  Southwest C-grid tracer point
c                  Input, input/output, or output field
c
c     precip    :: Precipitation in m/s
c                  > 0 for decrease in salt (ocean salinity)
c                  Typical range: 0 < precip < 5e-7
c                  Southwest C-grid tracer point
c                  Input or input/output field
c
c     runoff    :: River and glacier runoff in m/s
c                  > 0 for decrease in salt (ocean salinity)
c                  Typical range: 0 < runoff < ????
c                  Southwest C-grid tracer point
c                  Input or input/output field
c                  !!! WATCH OUT: Default exf_inscal_runoff !!!
c                  !!! in exf_readparms.F is not 1.0        !!!
c
c     swdown    :: Downward shortwave radiation in W/m^2
c                  > 0 for increase in theta (ocean warming)
c                  Typical range: 0 < swdown < 450
c                  Southwest C-grid tracer point
c                  Input/output field
c
c     lwdown    :: Downward longwave radiation in W/m^2
c                  > 0 for increase in theta (ocean warming)
c                  Typical range: 50 < lwdown < 450
c                  Southwest C-grid tracer point
c                  Input/output field
c
c     apressure :: Atmospheric pressure field in N/m^2
c                  > 0 for ????
c                  Typical range: ???? < apressure < ????
c                  Southwest C-grid tracer point
c                  Input field
C
C
c     NOTES:
c     ======
c
c     Input and output units and sign conventions can be customized
c     using variables exf_inscal_* and exf_outscal_*, which are set
c     by exf_readparms.F
c
c     Output fields fu, fv, Qnet, Qsw, and EmPmR are
c     defined in FFIELDS.h
c
c     #ifndef SHORTWAVE_HEATING, hflux includes shortwave,
c     that is, hflux = latent + sensible + lwflux +swflux
c
c     If (EXFwindOnBgrid .EQ. .TRUE.), uwind and vwind are
c     defined on northeast B-grid U and V points, respectively.
c
c     Arrays *0 and *1 below are used for temporal interpolation.
\end{verbatim}
}

1	heimbach	1.2	\section{The external forcing package \texttt{exf}
2	heimbach	1.1	\label{sectionexf}}
3	edhill	1.3	\begin{rawhtml}
4			<!-- CMIREDIR:sectionexf: -->
5			\end{rawhtml}
6	heimbach	1.1
7			\subsection{Summary}
8
9			{\footnotesize
10			\begin{verbatim}
11			c Field definitions, units, and sign conventions:
12			c ===============================================
13			c
14			c ustress :: Zonal surface wind stress in N/m^2
15			c > 0 for increase in uVel, which is west to
16			c east for cartesian and spherical polar grids
17			c Typical range: -0.5 < ustress < 0.5
18			c Southwest C-grid U point
19			c Input field
20			c
21			c vstress :: Meridional surface wind stress in N/m^2
22			c > 0 for increase in vVel, which is south to
23			c north for cartesian and spherical polar grids
24			c Typical range: -0.5 < vstress < 0.5
25			c Southwest C-grid V point
26			c Input field
27			c
28			c hflux :: Net upward surface heat flux excluding shortwave in W/m^2
29			c hflux = latent + sensible + lwflux
30			c > 0 for decrease in theta (ocean cooling)
31			c Typical range: -250 < hflux < 600
32			c Southwest C-grid tracer point
33			c Input field
34			c
35			c sflux :: Net upward freshwater flux in m/s
36			c sflux = evap - precip - runoff
37			c > 0 for increase in salt (ocean salinity)
38			c Typical range: -1e-7 < sflux < 1e-7
39			c Southwest C-grid tracer point
40			c Input field
41			c
42			c swflux :: Net upward shortwave radiation in W/m^2
43			c swflux = - ( swdown - ice and snow absorption - reflected )
44			c > 0 for decrease in theta (ocean cooling)
45			c Typical range: -350 < swflux < 0
46			c Southwest C-grid tracer point
47			c Input field
48			c
49			c uwind :: Surface (10-m) zonal wind velocity in m/s
50			c > 0 for increase in uVel, which is west to
51			c east for cartesian and spherical polar grids
52			c Typical range: -10 < uwind < 10
53			c Southwest C-grid U point
54			c Input or input/output field
55			c
56			c vwind :: Surface (10-m) meridional wind velocity in m/s
57			c > 0 for increase in vVel, which is south to
58			c north for cartesian and spherical polar grids
59			c Typical range: -10 < vwind < 10
60			c Southwest C-grid V point
61			c Input or input/output field
62			c
63			c atemp :: Surface (2-m) air temperature in deg K
64			c Typical range: 200 < atemp < 300
65			c Southwest C-grid tracer point
66			c Input or input/output field
67			c
68			c aqh :: Surface (2m) specific humidity in kg/kg
69			c Typical range: 0 < aqh < 0.02
70			c Southwest C-grid tracer point
71			c Input or input/output field
72			c
73			c lwflux :: Net upward longwave radiation in W/m^2
74			c lwflux = - ( lwdown - ice and snow absorption - emitted )
75			c > 0 for decrease in theta (ocean cooling)
76			c Typical range: -20 < lwflux < 170
77			c Southwest C-grid tracer point
78			c Input field
79			c
80			c evap :: Evaporation in m/s
81			c > 0 for increase in salt (ocean salinity)
82			c Typical range: 0 < evap < 2.5e-7
83			c Southwest C-grid tracer point
84			c Input, input/output, or output field
85			c
86			c precip :: Precipitation in m/s
87			c > 0 for decrease in salt (ocean salinity)
88			c Typical range: 0 < precip < 5e-7
89			c Southwest C-grid tracer point
90			c Input or input/output field
91			c
92			c runoff :: River and glacier runoff in m/s
93			c > 0 for decrease in salt (ocean salinity)
94			c Typical range: 0 < runoff < ????
95			c Southwest C-grid tracer point
96			c Input or input/output field
97			c !!! WATCH OUT: Default exf_inscal_runoff !!!
98			c !!! in exf_readparms.F is not 1.0 !!!
99			c
100			c swdown :: Downward shortwave radiation in W/m^2
101			c > 0 for increase in theta (ocean warming)
102			c Typical range: 0 < swdown < 450
103			c Southwest C-grid tracer point
104			c Input/output field
105			c
106			c lwdown :: Downward longwave radiation in W/m^2
107			c > 0 for increase in theta (ocean warming)
108			c Typical range: 50 < lwdown < 450
109			c Southwest C-grid tracer point
110			c Input/output field
111			c
112			c apressure :: Atmospheric pressure field in N/m^2
113			c > 0 for ????
114			c Typical range: ???? < apressure < ????
115			c Southwest C-grid tracer point
116			c Input field
117			C
118			C
119			c NOTES:
120			c ======
121			c
122			c Input and output units and sign conventions can be customized
123			c using variables exf_inscal_* and exf_outscal_*, which are set
124			c by exf_readparms.F
125			c
126			c Output fields fu, fv, Qnet, Qsw, and EmPmR are
127			c defined in FFIELDS.h
128			c
129			c #ifndef SHORTWAVE_HEATING, hflux includes shortwave,
130			c that is, hflux = latent + sensible + lwflux +swflux
131			c
132			c If (EXFwindOnBgrid .EQ. .TRUE.), uwind and vwind are
133			c defined on northeast B-grid U and V points, respectively.
134			c
135			c Arrays 0 and 1 below are used for temporal interpolation.
136			\end{verbatim}
137			}
138