manual/s_ecco/exf.tex

\section{The external forcing package \texttt{exf}
\label{sectionexf}}

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