1 |
jmc |
1.11 |
C $Header: /u/gcmpack/MITgcm/pkg/thsice/thsice_get_exf.F,v 1.10 2007/05/09 12:46:10 jmc Exp $ |
2 |
mlosch |
1.1 |
C $Name: $ |
3 |
|
|
|
4 |
|
|
#include "THSICE_OPTIONS.h" |
5 |
|
|
#ifdef ALLOW_EXF |
6 |
|
|
#include "EXF_OPTIONS.h" |
7 |
|
|
#endif |
8 |
|
|
|
9 |
|
|
CBOP |
10 |
|
|
C !ROUTINE: THSICE_GET_EXF |
11 |
|
|
C !INTERFACE: |
12 |
|
|
SUBROUTINE THSICE_GET_EXF( |
13 |
jmc |
1.3 |
I iceornot, tsfCel, |
14 |
mlosch |
1.1 |
O flxExceptSw, df0dT, evapLoc, dEvdT, |
15 |
|
|
I i,j,bi,bj,myThid ) |
16 |
|
|
C !DESCRIPTION: \bv |
17 |
|
|
C *==========================================================* |
18 |
|
|
C | S/R THSICE_GET_EXF |
19 |
|
|
C *==========================================================* |
20 |
|
|
C | Interface S/R : get Surface Fluxes from pkg EXF |
21 |
|
|
C *==========================================================* |
22 |
|
|
C \ev |
23 |
|
|
|
24 |
|
|
C !USES: |
25 |
|
|
IMPLICIT NONE |
26 |
|
|
|
27 |
|
|
C == Global data == |
28 |
jmc |
1.10 |
#include "SIZE.h" |
29 |
|
|
#include "EEPARAMS.h" |
30 |
|
|
#include "PARAMS.h" |
31 |
mlosch |
1.1 |
#ifdef ALLOW_EXF |
32 |
jmc |
1.5 |
# include "EXF_CONSTANTS.h" |
33 |
|
|
# include "EXF_PARAM.h" |
34 |
|
|
# include "EXF_FIELDS.h" |
35 |
mlosch |
1.1 |
#endif |
36 |
heimbach |
1.6 |
#ifdef ALLOW_AUTODIFF_TAMC |
37 |
|
|
# include "tamc.h" |
38 |
|
|
# include "tamc_keys.h" |
39 |
|
|
#endif |
40 |
mlosch |
1.1 |
|
41 |
|
|
C !INPUT/OUTPUT PARAMETERS: |
42 |
|
|
C === Routine arguments === |
43 |
|
|
C iceornot :: 0=open water, 1=ice cover |
44 |
jmc |
1.3 |
C tsfCel :: surface (ice or snow) temperature (oC) |
45 |
mlosch |
1.1 |
C flxExceptSw :: net (downward) surface heat flux, except short-wave [W/m2] |
46 |
|
|
C df0dT :: deriv of flx with respect to Tsf [W/m/K] |
47 |
|
|
C evapLoc :: surface evaporation (>0 if evaporate) [kg/m2/s] |
48 |
|
|
C dEvdT :: deriv of evap. with respect to Tsf [kg/m2/s/K] |
49 |
|
|
C i,j, bi,bj :: current grid point indices |
50 |
jmc |
1.9 |
C myThid :: My Thread Id number |
51 |
mlosch |
1.1 |
INTEGER i,j, bi,bj |
52 |
|
|
INTEGER myThid |
53 |
|
|
INTEGER iceornot |
54 |
jmc |
1.3 |
_RL tsfCel |
55 |
mlosch |
1.1 |
_RL flxExceptSw |
56 |
|
|
_RL df0dT |
57 |
|
|
_RL evapLoc |
58 |
|
|
_RL dEvdT |
59 |
|
|
CEOP |
60 |
|
|
|
61 |
|
|
#ifdef ALLOW_EXF |
62 |
jmc |
1.7 |
#ifdef ALLOW_ATM_TEMP |
63 |
mlosch |
1.1 |
|
64 |
|
|
C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----| |
65 |
|
|
C === Local variables === |
66 |
jmc |
1.4 |
C hsLocal, hlLocal :: sensible & latent heat flux over sea-ice |
67 |
jmc |
1.9 |
C t0 :: virtual temperature (K) |
68 |
|
|
C ssq :: saturation specific humidity (kg/kg) |
69 |
|
|
C deltap :: potential temperature diff (K) |
70 |
mlosch |
1.1 |
|
71 |
jmc |
1.4 |
_RL hsLocal, hlLocal |
72 |
jmc |
1.9 |
INTEGER iter |
73 |
mlosch |
1.1 |
_RL delq |
74 |
|
|
_RL deltap |
75 |
jmc |
1.9 |
_RL czol |
76 |
|
|
_RL ws ! wind speed [m/s] (unlimited) |
77 |
|
|
_RL wsm ! limited wind speed [m/s] (> umin) |
78 |
|
|
_RL t0 ! virtual temperature [K] |
79 |
|
|
_RL ustar ! friction velocity [m/s] |
80 |
|
|
_RL tstar ! turbulent temperature scale [K] |
81 |
|
|
_RL qstar ! turbulent humidity scale [kg/kg] |
82 |
|
|
_RL ssq |
83 |
|
|
_RL rd ! = sqrt(Cd) [-] |
84 |
|
|
_RL re ! = Ce / sqrt(Cd) [-] |
85 |
|
|
_RL rh ! = Ch / sqrt(Cd) [-] |
86 |
|
|
_RL rdn, ren, rhn ! neutral, zref (=10m) values of rd, re, rh |
87 |
|
|
_RL usn, usm ! neutral, zref (=10m) wind-speed (+limited) |
88 |
|
|
_RL stable ! = 1 if stable ; = 0 if unstable |
89 |
|
|
_RL huol ! stability parameter at zwd [-] (=z/Monin-Obuklov length) |
90 |
|
|
_RL htol ! stability parameter at zth [-] |
91 |
|
|
_RL hqol |
92 |
|
|
_RL x ! stability function [-] |
93 |
|
|
_RL xsq ! = x^2 [-] |
94 |
|
|
_RL psimh ! momentum stability function |
95 |
|
|
_RL psixh ! latent & sensib. stability function |
96 |
|
|
_RL zwln ! = log(zwd/zref) |
97 |
|
|
_RL ztln ! = log(zth/zref) |
98 |
|
|
_RL tau ! surface stress coef = rhoA * Ws * sqrt(Cd) |
99 |
|
|
_RL tmpbulk |
100 |
mlosch |
1.1 |
|
101 |
|
|
C additional variables that are copied from bulkf_formula_lay: |
102 |
|
|
C upward LW at surface (W m-2) |
103 |
|
|
_RL flwup |
104 |
|
|
C net (downward) LW at surface (W m-2) |
105 |
|
|
_RL flwNet_dwn |
106 |
jmc |
1.3 |
C gradients of latent/sensible net upward heat flux |
107 |
mlosch |
1.1 |
C w/ respect to temperature |
108 |
|
|
_RL dflhdT, dfshdT, dflwupdT |
109 |
|
|
C emissivities, called emittance in exf |
110 |
|
|
_RL emiss |
111 |
jmc |
1.3 |
C Tsf :: surface temperature [K] |
112 |
|
|
C Ts2 :: surface temperature square [K^2] |
113 |
|
|
_RL Tsf |
114 |
mlosch |
1.1 |
_RL Ts2 |
115 |
jmc |
1.3 |
C latent heat of evaporation or sublimation [J/kg] |
116 |
|
|
_RL lath |
117 |
jmc |
1.9 |
_RL qsat_fac, qsat_exp |
118 |
heimbach |
1.6 |
#ifdef ALLOW_AUTODIFF_TAMC |
119 |
jmc |
1.9 |
INTEGER ikey_1 |
120 |
|
|
INTEGER ikey_2 |
121 |
heimbach |
1.6 |
#endif |
122 |
mlosch |
1.1 |
|
123 |
jmc |
1.3 |
C == external functions == |
124 |
mlosch |
1.1 |
|
125 |
jmc |
1.3 |
c _RL exf_BulkqSat |
126 |
|
|
c external exf_BulkqSat |
127 |
jmc |
1.9 |
c _RL exf_BulkCdn |
128 |
|
|
c external exf_BulkCdn |
129 |
|
|
c _RL exf_BulkRhn |
130 |
|
|
c external exf_BulkRhn |
131 |
mlosch |
1.1 |
|
132 |
jmc |
1.3 |
C == end of interface == |
133 |
mlosch |
1.1 |
|
134 |
heimbach |
1.6 |
#ifdef ALLOW_AUTODIFF_TAMC |
135 |
|
|
act1 = bi - myBxLo(myThid) |
136 |
|
|
max1 = myBxHi(myThid) - myBxLo(myThid) + 1 |
137 |
|
|
act2 = bj - myByLo(myThid) |
138 |
|
|
max2 = myByHi(myThid) - myByLo(myThid) + 1 |
139 |
|
|
act3 = myThid - 1 |
140 |
|
|
max3 = nTx*nTy |
141 |
|
|
act4 = ikey_dynamics - 1 |
142 |
|
|
|
143 |
|
|
ikey_1 = i |
144 |
|
|
& + sNx*(j-1) |
145 |
|
|
& + sNx*sNy*act1 |
146 |
|
|
& + sNx*sNy*max1*act2 |
147 |
|
|
& + sNx*sNy*max1*max2*act3 |
148 |
|
|
& + sNx*sNy*max1*max2*max3*act4 |
149 |
|
|
#endif |
150 |
|
|
|
151 |
mlosch |
1.1 |
C copy a few variables to names used in bulkf_formula_lay |
152 |
jmc |
1.3 |
Tsf = tsfCel+cen2kel |
153 |
|
|
Ts2 = Tsf*Tsf |
154 |
jmc |
1.9 |
C wind speed |
155 |
jmc |
1.11 |
ws = wspeed(i,j,bi,bj) |
156 |
jmc |
1.9 |
#ifdef ALLOW_AUTODIFF_TAMC |
157 |
|
|
CADJ STORE sh(i,j,bi,bj) = comlev1_exf_1, key = ikey_1 |
158 |
|
|
#endif |
159 |
|
|
wsm = sh(i,j,bi,bj) |
160 |
jmc |
1.3 |
IF ( iceornot.EQ.0 ) THEN |
161 |
|
|
lath = flamb |
162 |
jmc |
1.9 |
qsat_fac = cvapor_fac |
163 |
|
|
qsat_exp = cvapor_exp |
164 |
jmc |
1.3 |
ELSE |
165 |
|
|
lath = flamb+flami |
166 |
jmc |
1.9 |
qsat_fac = cvapor_fac_ice |
167 |
|
|
qsat_exp = cvapor_exp_ice |
168 |
jmc |
1.3 |
ENDIF |
169 |
mlosch |
1.1 |
|
170 |
jmc |
1.3 |
C-- Use atmospheric state to compute surface fluxes. |
171 |
jmc |
1.10 |
IF ( atemp(i,j,bi,bj) .NE. 0. _d 0 ) THEN |
172 |
mlosch |
1.1 |
|
173 |
jmc |
1.10 |
C-- air - surface difference of temperature & humidity |
174 |
|
|
c tmpbulk= exf_BulkqSat(Tsf) |
175 |
|
|
c ssq = saltsat*tmpbulk/atmrho |
176 |
|
|
tmpbulk= qsat_fac*EXP(-qsat_exp/Tsf) |
177 |
|
|
ssq = tmpbulk/atmrho |
178 |
|
|
deltap = atemp(i,j,bi,bj) + gamma_blk*ht - Tsf |
179 |
|
|
delq = aqh(i,j,bi,bj) - ssq |
180 |
|
|
|
181 |
|
|
IF ( useStabilityFct_overIce ) THEN |
182 |
|
|
C-- Compute the turbulent surface fluxes (function of stability). |
183 |
|
|
|
184 |
|
|
C-- Set surface parameters : |
185 |
|
|
zwln = LOG(hu/zref) |
186 |
|
|
ztln = LOG(ht/zref) |
187 |
|
|
czol = hu*karman*gravity_mks |
188 |
mlosch |
1.1 |
|
189 |
jmc |
1.3 |
C Initial guess: z/l=0.0; hu=ht=hq=z |
190 |
|
|
C Iterations: converge on z/l and hence the fluxes. |
191 |
mlosch |
1.1 |
|
192 |
|
|
t0 = atemp(i,j,bi,bj)* |
193 |
|
|
& (exf_one + humid_fac*aqh(i,j,bi,bj)) |
194 |
jmc |
1.9 |
stable = exf_half + SIGN(exf_half, deltap) |
195 |
|
|
c tmpbulk= exf_BulkCdn(sh(i,j,bi,bj)) |
196 |
|
|
tmpbulk= cdrag_1/wsm + cdrag_2 + cdrag_3*wsm |
197 |
|
|
rdn = SQRT(tmpbulk) |
198 |
|
|
C-- initial guess for exchange other coefficients: |
199 |
|
|
c rhn = exf_BulkRhn(stable) |
200 |
|
|
rhn = (exf_one-stable)*cstanton_1 + stable*cstanton_2 |
201 |
|
|
ren = cDalton |
202 |
|
|
C-- calculate turbulent scales |
203 |
|
|
ustar = rdn*wsm |
204 |
|
|
tstar = rhn*deltap |
205 |
|
|
qstar = ren*delq |
206 |
mlosch |
1.1 |
|
207 |
jmc |
1.9 |
DO iter = 1,niter_bulk |
208 |
mlosch |
1.1 |
|
209 |
heimbach |
1.6 |
#ifdef ALLOW_AUTODIFF_TAMC |
210 |
|
|
ikey_2 = iter |
211 |
|
|
& + niter_bulk*(i-1) |
212 |
|
|
& + niter_bulk*sNx*(j-1) |
213 |
|
|
& + niter_bulk*sNx*sNy*act1 |
214 |
|
|
& + niter_bulk*sNx*sNy*max1*act2 |
215 |
|
|
& + niter_bulk*sNx*sNy*max1*max2*act3 |
216 |
|
|
& + niter_bulk*sNx*sNy*max1*max2*max3*act4 |
217 |
|
|
|
218 |
|
|
CADJ STORE rdn = comlev1_exf_2, key = ikey_2 |
219 |
|
|
CADJ STORE ustar = comlev1_exf_2, key = ikey_2 |
220 |
|
|
CADJ STORE qstar = comlev1_exf_2, key = ikey_2 |
221 |
|
|
CADJ STORE tstar = comlev1_exf_2, key = ikey_2 |
222 |
|
|
CADJ STORE sh(i,j,bi,bj) = comlev1_exf_2, key = ikey_2 |
223 |
|
|
#endif |
224 |
|
|
|
225 |
jmc |
1.9 |
huol = (tstar/t0 + |
226 |
|
|
& qstar/(exf_one/humid_fac+aqh(i,j,bi,bj)) |
227 |
|
|
& )*czol/(ustar*ustar) |
228 |
|
|
C- Large&Pond_1981 code (zolmin default = -100): |
229 |
|
|
c huol = MAX(huol,zolmin) |
230 |
|
|
C- Large&Yeager_2004 code: |
231 |
|
|
huol = MIN( MAX(-10. _d 0,huol), 10. _d 0 ) |
232 |
mlosch |
1.1 |
htol = huol*ht/hu |
233 |
|
|
hqol = huol*hq/hu |
234 |
jmc |
1.9 |
stable = exf_half + SIGN(exf_half, huol) |
235 |
jmc |
1.3 |
|
236 |
|
|
C Evaluate all stability functions assuming hq = ht. |
237 |
jmc |
1.9 |
C- Large&Pond_1981 code: |
238 |
|
|
c xsq = MAX(SQRT(ABS(exf_one - huol*16. _d 0)),exf_one) |
239 |
|
|
C- Large&Yeager_2004 code: |
240 |
|
|
xsq = SQRT( ABS(exf_one - huol*16. _d 0) ) |
241 |
|
|
x = SQRT(xsq) |
242 |
|
|
psimh = -psim_fac*huol*stable |
243 |
|
|
& + (exf_one-stable) |
244 |
|
|
& *( LOG( (exf_one + exf_two*x + xsq) |
245 |
|
|
& *(exf_one+xsq)*0.125 _d 0 ) |
246 |
|
|
& -exf_two*ATAN(x) + exf_half*pi ) |
247 |
|
|
C- Large&Pond_1981 code: |
248 |
|
|
c xsq = MAX(SQRT(ABS(exf_one - htol*16. _d 0)),exf_one) |
249 |
|
|
C- Large&Yeager_2004 code: |
250 |
|
|
xsq = SQRT( ABS(exf_one - htol*16. _d 0) ) |
251 |
|
|
psixh = -psim_fac*htol*stable |
252 |
|
|
& + (exf_one-stable) |
253 |
|
|
& *exf_two*LOG( exf_half*(exf_one+xsq) ) |
254 |
jmc |
1.3 |
|
255 |
|
|
C Shift wind speed using old coefficient |
256 |
jmc |
1.9 |
usn = ws/( exf_one + rdn*(zwln-psimh)/karman ) |
257 |
|
|
usm = MAX(usn, umin) |
258 |
|
|
|
259 |
|
|
C- Update the 10m, neutral stability transfer coefficients |
260 |
|
|
c tmpbulk= exf_BulkCdn(usm) |
261 |
|
|
tmpbulk= cdrag_1/usm + cdrag_2 + cdrag_3*usm |
262 |
|
|
rdn = SQRT(tmpbulk) |
263 |
|
|
c rhn = exf_BulkRhn(stable) |
264 |
|
|
rhn = (exf_one-stable)*cstanton_1 + stable*cstanton_2 |
265 |
|
|
|
266 |
|
|
C Shift all coefficients to the measurement height and stability. |
267 |
|
|
rd = rdn/( exf_one + rdn*(zwln-psimh)/karman ) |
268 |
|
|
rh = rhn/( exf_one + rhn*(ztln-psixh)/karman ) |
269 |
|
|
re = ren/( exf_one + ren*(ztln-psixh)/karman ) |
270 |
|
|
|
271 |
|
|
C Update ustar, tstar, qstar using updated, shifted coefficients. |
272 |
|
|
ustar = rd*wsm |
273 |
jmc |
1.3 |
qstar = re*delq |
274 |
mlosch |
1.1 |
tstar = rh*deltap |
275 |
jmc |
1.9 |
ENDDO |
276 |
mlosch |
1.1 |
|
277 |
jmc |
1.9 |
tau = atmrho*rd*ws |
278 |
mlosch |
1.1 |
|
279 |
jmc |
1.9 |
evapLoc = -tau*qstar |
280 |
jmc |
1.4 |
hlLocal = -lath*evapLoc |
281 |
jmc |
1.9 |
hsLocal = atmcp*tau*tstar |
282 |
|
|
c ustress = tau*rd*UwindSpeed |
283 |
|
|
c vstress = tau*rd*VwindSpeed |
284 |
mlosch |
1.1 |
|
285 |
|
|
C--- surf.Temp derivative of turbulent Fluxes |
286 |
jmc |
1.9 |
dEvdT = (tau*re)*ssq*qsat_exp/Ts2 |
287 |
mlosch |
1.1 |
dflhdT = -lath*dEvdT |
288 |
jmc |
1.9 |
dfshdT = -atmcp*tau*rh |
289 |
mlosch |
1.1 |
|
290 |
jmc |
1.10 |
ELSE |
291 |
|
|
C-- Compute the turbulent surface fluxes using fixed transfert Coeffs |
292 |
|
|
C with no stability dependence ( useStabilityFct_overIce = false ) |
293 |
|
|
|
294 |
|
|
evapLoc = -atmrho*exf_iceCe*wsm*delq |
295 |
|
|
hlLocal = -lath*evapLoc |
296 |
|
|
hsLocal = atmcp*atmrho*exf_iceCh*wsm*deltap |
297 |
|
|
C--- surf.Temp derivative of turbulent Fluxes |
298 |
|
|
dEvdT = (atmrho*exf_iceCe*wsm)*(ssq*qsat_exp/Ts2) |
299 |
|
|
dflhdT = -lath*dEvdT |
300 |
|
|
dfshdT = -atmcp*atmrho*exf_iceCh*wsm |
301 |
|
|
|
302 |
|
|
ENDIF |
303 |
mlosch |
1.1 |
C--- Upward long wave radiation |
304 |
jmc |
1.10 |
IF ( iceornot.EQ.0 ) THEN |
305 |
mlosch |
1.1 |
emiss = ocean_emissivity |
306 |
jmc |
1.10 |
ELSEIF (iceornot.EQ.2) THEN |
307 |
mlosch |
1.1 |
emiss = snow_emissivity |
308 |
jmc |
1.10 |
ELSE |
309 |
mlosch |
1.1 |
emiss = ice_emissivity |
310 |
jmc |
1.10 |
ENDIF |
311 |
|
|
flwup = emiss*stefanBoltzmann*Ts2*Ts2 |
312 |
|
|
dflwupdT = emiss*stefanBoltzmann*Ts2*Tsf * 4. _d 0 |
313 |
jmc |
1.3 |
|
314 |
mlosch |
1.1 |
C-- Total derivative with respect to surface temperature |
315 |
jmc |
1.10 |
df0dT = -dflwupdT+dfshdT+dflhdT |
316 |
jmc |
1.3 |
|
317 |
jmc |
1.7 |
#ifdef ALLOW_DOWNWARD_RADIATION |
318 |
jmc |
1.10 |
c flwNet_dwn = lwdown(i,j,bi,bj) - flwup |
319 |
|
|
C- assume long-wave albedo = 1 - emissivity : |
320 |
|
|
flwNet_dwn = emiss*lwdown(i,j,bi,bj) - flwup |
321 |
jmc |
1.7 |
#else |
322 |
|
|
STOP 'ABNORMAL END: S/R THSICE_GET_EXF: DOWNWARD_RADIATION undef' |
323 |
|
|
#endif |
324 |
jmc |
1.10 |
flxExceptSw = flwNet_dwn + hsLocal + hlLocal |
325 |
mlosch |
1.1 |
|
326 |
jmc |
1.10 |
ELSE |
327 |
|
|
flxExceptSw = 0. _d 0 |
328 |
|
|
df0dT = 0. _d 0 |
329 |
|
|
evapLoc = 0. _d 0 |
330 |
|
|
dEvdT = 0. _d 0 |
331 |
|
|
ENDIF |
332 |
mlosch |
1.1 |
|
333 |
|
|
C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----| |
334 |
|
|
|
335 |
jmc |
1.7 |
#else /* ALLOW_ATM_TEMP */ |
336 |
|
|
STOP 'ABNORMAL END: S/R THSICE_GET_EXF: ATM_TEMP undef' |
337 |
|
|
#endif /* ALLOW_ATM_TEMP */ |
338 |
jmc |
1.9 |
#ifdef EXF_READ_EVAP |
339 |
|
|
STOP 'ABNORMAL END: S/R THSICE_GET_EXF: EXF_READ_EVAP defined' |
340 |
|
|
#endif /* EXF_READ_EVAP */ |
341 |
mlosch |
1.1 |
#endif /* ALLOW_EXF */ |
342 |
|
|
|
343 |
|
|
RETURN |
344 |
|
|
END |