1 MODULE module_sf_noahdrv
3 !-------------------------------
9 USE module_data_gocart_dust
11 !-------------------------------
16 !----------------------------------------------------------------
17 ! Urban related variable are added to arguments - urban
18 !----------------------------------------------------------------
19 SUBROUTINE lsm(DZ8W,QV3D,P8W3D,T3D,TSK, &
20 HFX,QFX,LH,GRDFLX, QGH,GSW,SWDOWN,GLW,SMSTAV,SMSTOT, &
21 SFCRUNOFF, UDRUNOFF,IVGTYP,ISLTYP,ISURBAN,ISICE,VEGFRA, &
22 ALBEDO,ALBBCK,ZNT,Z0,TMN,XLAND,XICE,EMISS,EMBCK, &
23 SNOWC,QSFC,RAINBL,MMINLU, &
24 num_soil_layers,DT,DZS,ITIMESTEP, &
25 SMOIS,TSLB,SNOW,CANWAT, &
26 CHS,CHS2,CQS2,CPM,ROVCP,SR,chklowq,lai,qz0, & !H
30 SNOALB,SHDMIN,SHDMAX, & !I
39 ids,ide, jds,jde, kds,kde, &
40 ims,ime, jms,jme, kms,kme, &
41 its,ite, jts,jte, kts,kte, &
43 CMR_SFCDIF,CHR_SFCDIF,CMC_SFCDIF,CHC_SFCDIF, &
45 TR_URB2D,TB_URB2D,TG_URB2D,TC_URB2D,QC_URB2D, & !H urban
47 XXXR_URB2D,XXXB_URB2D,XXXG_URB2D,XXXC_URB2D, & !H urban
48 TRL_URB3D,TBL_URB3D,TGL_URB3D, & !H urban
49 SH_URB2D,LH_URB2D,G_URB2D,RN_URB2D,TS_URB2D, & !H urban
50 PSIM_URB2D,PSIH_URB2D,U10_URB2D,V10_URB2D, & !O urban
51 GZ1OZ0_URB2D, AKMS_URB2D, & !O urban
52 TH2_URB2D,Q2_URB2D, UST_URB2D, & !O urban
53 DECLIN_URB,COSZ_URB2D,OMG_URB2D, & !I urban
54 XLAT_URB2D, & !I urban
55 num_roof_layers, num_wall_layers, & !I urban
56 num_road_layers, DZR, DZB, DZG, & !I urban
57 FRC_URB2D,UTYPE_URB2D, & !O
58 num_urban_layers, & !I multi-layer urban
59 trb_urb4d,tw1_urb4d,tw2_urb4d,tgb_urb4d, & !H multi-layer urban
60 tlev_urb3d,qlev_urb3d, & !H multi-layer urban
61 tw1lev_urb3d,tw2lev_urb3d, & !H multi-layer urban
62 tglev_urb3d,tflev_urb3d, & !H multi-layer urban
63 sf_ac_urb3d,lf_ac_urb3d,cm_ac_urb3d, & !H multi-layer urban
64 sfvent_urb3d,lfvent_urb3d, & !H multi-layer urban
65 sfwin1_urb3d,sfwin2_urb3d, & !H multi-layer urban
66 sfw1_urb3d,sfw2_urb3d,sfr_urb3d,sfg_urb3d, & !H multi-layer urban
67 th_phy,rho,p_phy,ust, & !I multi-layer urban
68 gmt,julday,xlong,xlat, & !I multi-layer urban
69 a_u_bep,a_v_bep,a_t_bep,a_q_bep, & !O multi-layer urban
70 a_e_bep,b_u_bep,b_v_bep, & !O multi-layer urban
71 b_t_bep,b_q_bep,b_e_bep,dlg_bep, & !O multi-layer urban
72 dl_u_bep,sf_bep,vl_bep ) !O multi-layer urban
74 !----------------------------------------------------------------
76 !----------------------------------------------------------------
77 !----------------------------------------------------------------
78 ! --- atmospheric (WRF generic) variables
79 !-- DT time step (seconds)
80 !-- DZ8W thickness of layers (m)
81 !-- T3D temperature (K)
82 !-- QV3D 3D water vapor mixing ratio (Kg/Kg)
83 !-- P3D 3D pressure (Pa)
84 !-- FLHC exchange coefficient for heat (m/s)
85 !-- FLQC exchange coefficient for moisture (m/s)
86 !-- PSFC surface pressure (Pa)
87 !-- XLAND land mask (1 for land, 2 for water)
88 !-- QGH saturated mixing ratio at 2 meter
89 !-- GSW downward short wave flux at ground surface (W/m^2)
90 !-- GLW downward long wave flux at ground surface (W/m^2)
92 !-- CANWAT canopy moisture content (mm)
93 !-- TSK surface temperature (K)
94 !-- TSLB soil temp (k)
95 !-- SMOIS total soil moisture content (volumetric fraction)
96 !-- SH2O unfrozen soil moisture content (volumetric fraction)
97 ! note: frozen soil moisture (i.e., soil ice) = SMOIS - SH2O
98 !-- SNOWH actual snow depth (m)
99 !-- SNOW liquid water-equivalent snow depth (m)
100 !-- ALBEDO time-varying surface albedo including snow effect (unitless fraction)
101 !-- ALBBCK background surface albedo (unitless fraction)
102 !-- CHS surface exchange coefficient for heat and moisture (m s-1);
103 !-- CHS2 2m surface exchange coefficient for heat (m s-1);
104 !-- CQS2 2m surface exchange coefficient for moisture (m s-1);
106 !-- num_soil_layers the number of soil layers
107 !-- ZS depths of centers of soil layers (m)
108 !-- DZS thicknesses of soil layers (m)
109 !-- SLDPTH thickness of each soil layer (m, same as DZS)
110 !-- TMN soil temperature at lower boundary (K)
111 !-- SMCWLT wilting point (volumetric)
112 !-- SMCDRY dry soil moisture threshold where direct evap from
113 ! top soil layer ends (volumetric)
114 !-- SMCREF soil moisture threshold below which transpiration begins to
115 ! stress (volumetric)
116 !-- SMCMAX porosity, i.e. saturated value of soil moisture (volumetric)
117 !-- NROOT number of root layers, a function of veg type, determined
118 ! in subroutine redprm.
119 !-- SMSTAV Soil moisture availability for evapotranspiration (
120 ! fraction between SMCWLT and SMCMXA)
121 !-- SMSTOT Total soil moisture content frozen+unfrozen) in the soil column (mm)
123 !-- SNOWC fraction snow coverage (0-1.0)
124 ! --- vegetation variables
125 !-- SNOALB upper bound on maximum albedo over deep snow
126 !-- SHDMIN minimum areal fractional coverage of annual green vegetation
127 !-- SHDMAX maximum areal fractional coverage of annual green vegetation
128 !-- XLAI leaf area index (dimensionless)
129 !-- Z0BRD Background fixed roughness length (M)
130 !-- Z0 Background vroughness length (M) as function
131 !-- ZNT Time varying roughness length (M) as function
132 !-- ALBD(IVGTPK,ISN) background albedo reading from a table
134 !-- HFX upward heat flux at the surface (W/m^2)
135 !-- QFX upward moisture flux at the surface (kg/m^2/s)
136 !-- LH upward moisture flux at the surface (W m-2)
137 !-- GRDFLX(I,J) ground heat flux (W m-2)
138 !-- FDOWN radiation forcing at the surface (W m-2) = SOLDN*(1-alb)+LWDN
139 !----------------------------------------------------------------------------
140 !-- EC canopy water evaporation ((W m-2)
141 !-- EDIR direct soil evaporation (W m-2)
142 !-- ET plant transpiration from a particular root layer (W m-2)
143 !-- ETT total plant transpiration (W m-2)
144 !-- ESNOW sublimation from (or deposition to if <0) snowpack (W m-2)
145 !-- DRIP through-fall of precip and/or dew in excess of canopy
146 ! water-holding capacity (m)
147 !-- DEW dewfall (or frostfall for t<273.15) (M)
148 ! ----------------------------------------------------------------------
149 !-- BETA ratio of actual/potential evap (dimensionless)
150 !-- ETP potential evaporation (W m-2)
151 ! ----------------------------------------------------------------------
152 !-- FLX1 precip-snow sfc (W m-2)
153 !-- FLX2 freezing rain latent heat flux (W m-2)
154 !-- FLX3 phase-change heat flux from snowmelt (W m-2)
155 ! ----------------------------------------------------------------------
156 !-- ACSNOM snow melt (mm) (water equivalent)
157 !-- ACSNOW accumulated snow fall (mm) (water equivalent)
158 !-- SNOPCX snow phase change heat flux (W/m^2)
159 !-- POTEVP accumulated potential evaporation (W/m^2)
160 !-- RIB Documentation needed!!!
161 ! ----------------------------------------------------------------------
162 !-- RUNOFF1 surface runoff (m s-1), not infiltrating the surface
163 !-- RUNOFF2 subsurface runoff (m s-1), drainage out bottom of last
164 ! soil layer (baseflow)
165 ! important note: here RUNOFF2 is actually the sum of RUNOFF2 and RUNOFF3
166 !-- RUNOFF3 numerical trunctation in excess of porosity (smcmax)
167 ! for a given soil layer at the end of a time step (m s-1).
168 ! ----------------------------------------------------------------------
169 !-- RC canopy resistance (s m-1)
170 !-- PC plant coefficient (unitless fraction, 0-1) where PC*ETP = actual transp
171 !-- RSMIN minimum canopy resistance (s m-1)
172 !-- RCS incoming solar rc factor (dimensionless)
173 !-- RCT air temperature rc factor (dimensionless)
174 !-- RCQ atmos vapor pressure deficit rc factor (dimensionless)
175 !-- RCSOIL soil moisture rc factor (dimensionless)
177 !-- EMISS surface emissivity (between 0 and 1)
178 !-- EMBCK Background surface emissivity (between 0 and 1)
181 ! (R_d/R_v) (dimensionless)
182 !-- ids start index for i in domain
183 !-- ide end index for i in domain
184 !-- jds start index for j in domain
185 !-- jde end index for j in domain
186 !-- kds start index for k in domain
187 !-- kde end index for k in domain
188 !-- ims start index for i in memory
189 !-- ime end index for i in memory
190 !-- jms start index for j in memory
191 !-- jme end index for j in memory
192 !-- kms start index for k in memory
193 !-- kme end index for k in memory
194 !-- its start index for i in tile
195 !-- ite end index for i in tile
196 !-- jts start index for j in tile
197 !-- jte end index for j in tile
198 !-- kts start index for k in tile
199 !-- kte end index for k in tile
201 !-- SR fraction of frozen precip (0.0 to 1.0)
202 !----------------------------------------------------------------
206 INTEGER, INTENT(IN ) :: ids,ide, jds,jde, kds,kde, &
207 ims,ime, jms,jme, kms,kme, &
208 its,ite, jts,jte, kts,kte
210 INTEGER, INTENT(IN ) :: sf_urban_physics !urban
211 INTEGER, INTENT(IN ) :: isurban
212 INTEGER, INTENT(IN ) :: isice
214 REAL, DIMENSION( ims:ime, jms:jme ) , &
215 INTENT(IN ) :: TMN, &
223 SWDOWN, & !added 10 jan 2007
229 REAL, DIMENSION( ims:ime, jms:jme ) , &
230 INTENT(INOUT) :: ALBBCK, &
232 CHARACTER(LEN=*), INTENT(IN ) :: MMINLU
234 REAL, DIMENSION( ims:ime, kms:kme, jms:jme ) , &
235 INTENT(IN ) :: QV3D, &
239 REAL, DIMENSION( ims:ime, jms:jme ) , &
240 INTENT(IN ) :: QGH, &
243 INTEGER, DIMENSION( ims:ime, jms:jme ) , &
244 INTENT(IN ) :: IVGTYP, &
247 INTEGER, INTENT(IN) :: num_soil_layers,ITIMESTEP
249 REAL, INTENT(IN ) :: DT,ROVCP
251 REAL, DIMENSION(1:num_soil_layers), INTENT(IN)::DZS
255 REAL, DIMENSION( ims:ime , 1:num_soil_layers, jms:jme ), &
256 INTENT(INOUT) :: SMOIS, & ! total soil moisture
257 SH2O, & ! new soil liquid
260 REAL, DIMENSION( ims:ime, jms:jme ) , &
261 INTENT(INOUT) :: TSK, & !was TGB (temperature)
287 REAL, DIMENSION( ims:ime, jms:jme ) , &
288 INTENT(OUT) :: NOAHRES
290 REAL, DIMENSION( ims:ime, jms:jme ) , &
291 INTENT(OUT) :: CHKLOWQ
292 REAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: LAI
293 REAL,DIMENSION(IMS:IME,JMS:JME),INTENT(IN) :: QZ0
295 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: CMR_SFCDIF
296 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: CHR_SFCDIF
297 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: CMC_SFCDIF
298 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: CHC_SFCDIF
299 ! Local variables (moved here from driver to make routine thread safe, 20031007 jm)
301 REAL, DIMENSION(1:num_soil_layers) :: ET
303 REAL :: BETA, ETP, SSOIL,EC, EDIR, ESNOW, ETT, &
304 FLX1,FLX2,FLX3, DRIP,DEW,FDOWN,RC,PC,RSMIN,XLAI, &
306 RCS,RCT,RCQ,RCSOIL,FFROZP
308 LOGICAL, INTENT(IN ) :: myj,frpcpn
310 ! DECLARATIONS - LOGICAL
311 ! ----------------------------------------------------------------------
312 LOGICAL, PARAMETER :: LOCAL=.false.
313 LOGICAL :: FRZGRA, SNOWNG
317 ! ----------------------------------------------------------------------
318 ! DECLARATIONS - INTEGER
319 ! ----------------------------------------------------------------------
320 INTEGER :: I,J, ICE,NSOIL,SLOPETYP,SOILTYP,VEGTYP
324 ! ----------------------------------------------------------------------
325 ! DECLARATIONS - REAL
326 ! ----------------------------------------------------------------------
328 REAL :: SHMIN,SHMAX,DQSDT2,LWDN,PRCP,PRCPRAIN, &
329 Q2SAT,Q2SATI,SFCPRS,SFCSPD,SFCTMP,SHDFAC,SNOALB1, &
330 SOLDN,TBOT,ZLVL, Q2K,ALBBRD, ALBEDOK, ETA, ETA_KINEMATIC, &
332 Z0K,RUNOFF1,RUNOFF2,RUNOFF3,SHEAT,SOLNET,E2SAT,SFCTSNO, &
333 ! mek, WRF testing, expanded diagnostics
334 SOLUP,LWUP,RNET,RES,Q1SFC,TAIRV,SATFLG
337 ! MEK JUL2007 for pot. evap.
343 REAL :: SNCOVR,SNEQV,SNOWHK,CMC, CHK,TH2
345 REAL :: SMCDRY,SMCMAX,SMCREF,SMCWLT,SNOMLT,SOILM,SOILW,Q1,T1
346 REAL :: SNOTIME1 ! LSTSNW1 INITIAL NUMBER OF TIMESTEPS SINCE LAST SNOWFALL
350 REAL :: COSZ, SOLARDIRECT
352 REAL, DIMENSION(1:num_soil_layers):: SLDPTH, STC,SMC,SWC
354 REAL, DIMENSION(1:num_soil_layers) :: ZSOIL, RTDIS
355 REAL, PARAMETER :: TRESH=.95E0, A2=17.67,A3=273.15,A4=29.65, &
356 T0=273.16E0, ELWV=2.50E6, A23M4=A2*(A3-A4)
358 REAL, PARAMETER :: ROW=1.E3,ELIW=XLF,ROWLIW=ROW*ELIW
360 ! ----------------------------------------------------------------------
361 ! DECLARATIONS START - urban
362 ! ----------------------------------------------------------------------
364 ! input variables surface_driver --> lsm
365 INTEGER, INTENT(IN) :: num_roof_layers
366 INTEGER, INTENT(IN) :: num_wall_layers
367 INTEGER, INTENT(IN) :: num_road_layers
368 REAL, OPTIONAL, DIMENSION(1:num_roof_layers), INTENT(IN) :: DZR
369 REAL, OPTIONAL, DIMENSION(1:num_wall_layers), INTENT(IN) :: DZB
370 REAL, OPTIONAL, DIMENSION(1:num_road_layers), INTENT(IN) :: DZG
371 REAL, OPTIONAL, INTENT(IN) :: DECLIN_URB
372 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(IN) :: COSZ_URB2D
373 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(IN) :: OMG_URB2D
374 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(IN) :: XLAT_URB2D
375 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(IN) :: U_PHY
376 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(IN) :: V_PHY
377 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(IN) :: TH_PHY
378 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(IN) :: P_PHY
379 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(IN) :: RHO
380 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: UST
382 LOGICAL, intent(in) :: rdlai2d
383 LOGICAL, intent(in) :: USEMONALB
385 ! input variables lsm --> urban
386 INTEGER :: UTYPE_URB ! urban type [urban=1, suburban=2, rural=3]
387 REAL :: TA_URB ! potential temp at 1st atmospheric level [K]
388 REAL :: QA_URB ! mixing ratio at 1st atmospheric level [kg/kg]
389 REAL :: UA_URB ! wind speed at 1st atmospheric level [m/s]
390 REAL :: U1_URB ! u at 1st atmospheric level [m/s]
391 REAL :: V1_URB ! v at 1st atmospheric level [m/s]
392 REAL :: SSG_URB ! downward total short wave radiation [W/m/m]
393 REAL :: LLG_URB ! downward long wave radiation [W/m/m]
394 REAL :: RAIN_URB ! precipitation [mm/h]
395 REAL :: RHOO_URB ! air density [kg/m^3]
396 REAL :: ZA_URB ! first atmospheric level [m]
397 REAL :: DELT_URB ! time step [s]
398 REAL :: SSGD_URB ! downward direct short wave radiation [W/m/m]
399 REAL :: SSGQ_URB ! downward diffuse short wave radiation [W/m/m]
400 REAL :: XLAT_URB ! latitude [deg]
401 REAL :: COSZ_URB ! cosz
402 REAL :: OMG_URB ! hour angle
403 REAL :: ZNT_URB ! roughness length [m]
414 REAL, DIMENSION(1:num_roof_layers) :: TRL_URB ! roof layer temp [K]
415 REAL, DIMENSION(1:num_wall_layers) :: TBL_URB ! wall layer temp [K]
416 REAL, DIMENSION(1:num_road_layers) :: TGL_URB ! road layer temp [K]
417 LOGICAL :: LSOLAR_URB
418 ! state variable surface_driver <--> lsm <--> urban
419 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: TR_URB2D
420 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: TB_URB2D
421 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: TG_URB2D
422 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: TC_URB2D
423 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: QC_URB2D
424 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: UC_URB2D
425 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: XXXR_URB2D
426 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: XXXB_URB2D
427 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: XXXG_URB2D
428 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: XXXC_URB2D
429 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: SH_URB2D
430 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: LH_URB2D
431 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: G_URB2D
432 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: RN_URB2D
434 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: TS_URB2D
436 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_roof_layers, jms:jme ), INTENT(INOUT) :: TRL_URB3D
437 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_wall_layers, jms:jme ), INTENT(INOUT) :: TBL_URB3D
438 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_road_layers, jms:jme ), INTENT(INOUT) :: TGL_URB3D
440 ! output variable lsm --> surface_driver
441 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(OUT) :: PSIM_URB2D
442 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(OUT) :: PSIH_URB2D
443 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(OUT) :: GZ1OZ0_URB2D
444 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(OUT) :: U10_URB2D
445 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(OUT) :: V10_URB2D
446 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(OUT) :: TH2_URB2D
447 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(OUT) :: Q2_URB2D
449 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(OUT) :: AKMS_URB2D
451 REAL, DIMENSION( ims:ime, jms:jme ), INTENT(OUT) :: UST_URB2D
452 REAL, DIMENSION( ims:ime, jms:jme ), INTENT(IN) :: FRC_URB2D
453 INTEGER, DIMENSION( ims:ime, jms:jme ), INTENT(IN) :: UTYPE_URB2D
456 ! output variables urban --> lsm
457 REAL :: TS_URB ! surface radiative temperature [K]
458 REAL :: QS_URB ! surface humidity [-]
459 REAL :: SH_URB ! sensible heat flux [W/m/m]
460 REAL :: LH_URB ! latent heat flux [W/m/m]
461 REAL :: LH_KINEMATIC_URB ! latent heat flux, kinetic [kg/m/m/s]
462 REAL :: SW_URB ! upward short wave radiation flux [W/m/m]
463 REAL :: ALB_URB ! time-varying albedo [fraction]
464 REAL :: LW_URB ! upward long wave radiation flux [W/m/m]
465 REAL :: G_URB ! heat flux into the ground [W/m/m]
466 REAL :: RN_URB ! net radiation [W/m/m]
467 REAL :: PSIM_URB ! shear f for momentum [-]
468 REAL :: PSIH_URB ! shear f for heat [-]
469 REAL :: GZ1OZ0_URB ! shear f for heat [-]
470 REAL :: U10_URB ! wind u component at 10 m [m/s]
471 REAL :: V10_URB ! wind v component at 10 m [m/s]
472 REAL :: TH2_URB ! potential temperature at 2 m [K]
473 REAL :: Q2_URB ! humidity at 2 m [-]
477 ! Variables for multi-layer UCM (Martilli et al. 2002)
478 REAL, OPTIONAL, INTENT(IN ) :: GMT
479 INTEGER, OPTIONAL, INTENT(IN ) :: JULDAY
480 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(IN ) ::XLAT, XLONG
481 INTEGER, INTENT(IN ) :: NUM_URBAN_LAYERS
482 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: trb_urb4d
483 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: tw1_urb4d
484 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: tw2_urb4d
485 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: tgb_urb4d
486 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: tlev_urb3d
487 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: qlev_urb3d
488 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: tw1lev_urb3d
489 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: tw2lev_urb3d
490 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: tglev_urb3d
491 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: tflev_urb3d
492 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: lf_ac_urb3d
493 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: sf_ac_urb3d
494 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: cm_ac_urb3d
495 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: sfvent_urb3d
496 REAL, OPTIONAL, DIMENSION( ims:ime, jms:jme ), INTENT(INOUT) :: lfvent_urb3d
497 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: sfwin1_urb3d
498 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: sfwin2_urb3d
499 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: sfw1_urb3d
500 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: sfw2_urb3d
501 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: sfr_urb3d
502 REAL, OPTIONAL, DIMENSION( ims:ime, 1:num_urban_layers, jms:jme ), INTENT(INOUT) :: sfg_urb3d
503 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(INOUT) ::a_u_bep !Implicit momemtum component X-direction
504 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(INOUT) ::a_v_bep !Implicit momemtum component Y-direction
505 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(INOUT) ::a_t_bep !Implicit component pot. temperature
506 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(INOUT) ::a_q_bep !Implicit momemtum component X-direction
507 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(INOUT) ::a_e_bep !Implicit component TKE
508 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(INOUT) ::b_u_bep !Explicit momentum component X-direction
509 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(INOUT) ::b_v_bep !Explicit momentum component Y-direction
510 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(INOUT) ::b_t_bep !Explicit component pot. temperature
511 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(INOUT) ::b_q_bep !Implicit momemtum component Y-direction
512 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(INOUT) ::b_e_bep !Explicit component TKE
513 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(INOUT) ::vl_bep !Fraction air volume in grid cell
514 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(INOUT) ::dlg_bep !Height above ground
515 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(INOUT) ::sf_bep !Fraction air at the face of grid cell
516 REAL, OPTIONAL, DIMENSION( ims:ime, kms:kme, jms:jme ), INTENT(INOUT) ::dl_u_bep !Length scale
518 ! Local variables for multi-layer UCM (Martilli et al. 2002)
519 REAL, DIMENSION( ims:ime, jms:jme ) :: HFX_RURAL,LH_RURAL,GRDFLX_RURAL,RN_RURAL
520 REAL, DIMENSION( ims:ime, jms:jme ) :: QFX_RURAL,QSFC_RURAL,UMOM_RURAL,VMOM_RURAL
521 REAL, DIMENSION( ims:ime, jms:jme ) :: ALB_RURAL,EMISS_RURAL,UST_RURAL,TSK_RURAL
522 ! REAL, DIMENSION( ims:ime, jms:jme ) :: GRDFLX_URB
523 ! REAL, DIMENSION( ims:ime, jms:jme ) :: QFX_URB,QSFC_URB,UMOM_URB,VMOM_URB
524 REAL, DIMENSION( ims:ime, jms:jme ) :: HFX_URB,UMOM_URB,VMOM_URB
525 REAL, DIMENSION( ims:ime, jms:jme ) :: QFX_URB
526 ! REAL, DIMENSION( ims:ime, jms:jme ) :: ALBEDO_URB,EMISS_URB,UMOM,VMOM,UST
527 REAL, DIMENSION(ims:ime,jms:jme) ::EMISS_URB
528 REAL, DIMENSION(ims:ime,jms:jme) :: RL_UP_URB
529 REAL, DIMENSION(ims:ime,jms:jme) ::RS_ABS_URB
530 REAL, DIMENSION(ims:ime,jms:jme) ::GRDFLX_URB
531 REAL :: SIGMA_SB,RL_UP_RURAL,RL_UP_TOT,RS_ABS_TOT,UMOM,VMOM
533 REAL :: CMR_URB, CHR_URB, CMC_URB, CHC_URB
534 ! ----------------------------------------------------------------------
535 ! DECLARATIONS END - urban
536 ! ----------------------------------------------------------------------
538 REAL, PARAMETER :: CAPA=R_D/CP
539 REAL :: APELM,APES,SFCTH2,PSFC
541 real, intent(in) :: xice_threshold
542 character(len=80) :: message_text
547 FDTW=DT/(XLV*RHOWATER)
556 NSOIL=num_soil_layers
564 IF(ITIMESTEP.EQ.1)THEN
566 !*** initialize soil conditions for IHOP 31 May case
567 ! IF((XLAND(I,J)-1.5) < 0.)THEN
568 ! if (I==108.and.j==85) then
576 !*** SET ZERO-VALUE FOR SOME OUTPUT DIAGNOSTIC ARRAYS
577 IF((XLAND(I,J)-1.5).GE.0.)THEN
578 ! check sea-ice point
580 IF( XICE(I,J).GE. XICE_THRESHOLD .and. IPRINT ) PRINT*, ' sea-ice at water point, I=',I,'J=',J
587 TSLB(I,NS,J)=273.16 !STEMP
590 IF ( XICE(I,J) .GE. XICE_THRESHOLD ) THEN
601 ENDIF ! end of initialization over ocean
603 !-----------------------------------------------------------------------
607 ! pressure in middle of lowest layer
608 SFCPRS=(P8W3D(I,KTS+1,j)+P8W3D(i,KTS,j))*0.5
609 ! convert from mixing ratio to specific humidity
610 Q2K=QV3D(i,1,j)/(1.0+QV3D(i,1,j))
613 Q2SAT=QGH(I,J)/(1.0+QGH(I,J)) ! Q2SAT is sp humidity
614 ! add check on myj=.true.
615 ! IF((Q2K.GE.Q2SAT*TRESH).AND.Q2K.LT.QZ0(I,J))THEN
616 IF((myj).AND.(Q2K.GE.Q2SAT*TRESH).AND.Q2K.LT.QZ0(I,J))THEN
627 ! TH2=SFCTMP+(0.0097545*ZLVL)
628 ! calculate SFCTH2 via Exner function vs lapse-rate (above)
629 APES=(1.E5/PSFC)**CAPA
630 APELM=(1.E5/SFCPRS)**CAPA
636 ! SOLDN is total incoming solar
638 ! GSW is net downward solar
640 ! use mid-day albedo to determine net downward solar (no solar zenith angle correction)
641 SOLNET=SOLDN*(1.-ALBEDO(I,J))
645 SHDFAC=VEGFRA(I,J)/100.
648 SHMIN=SHDMIN(I,J)/100. !NEW
649 SHMAX=SHDMAX(I,J)/100. !NEW
650 ! convert snow water equivalent from mm to meter
651 SNEQV=SNOW(I,J)*0.001
652 ! snow depth in meters
656 ! if "SR" present, set frac of frozen precip ("FFROZP") = snow-ratio ("SR", range:0-1)
657 ! SR from e.g. Ferrier microphysics
658 ! otherwise define from 1st atmos level temperature
662 IF (SFCTMP <= 273.15) THEN
669 IF((XLAND(I,J)-1.5).GE.0.)THEN ! begining of land/sea if block
671 TSK_RURAL(I,J)=TSK(I,J)
672 HFX_RURAL(I,J)=HFX(I,J)
673 QFX_RURAL(I,J)=QFX(I,J)
674 LH_RURAL(I,J)=LH(I,J)
675 EMISS_RURAL(I,J)=EMISS(I,J)
676 GRDFLX_RURAL(I,J)=GRDFLX(I,J)
678 ! Land or sea-ice case
680 IF (XICE(I,J) >= XICE_THRESHOLD) THEN
683 ELSE IF ( VEGTYP == ISICE ) THEN
687 ! Neither sea ice or land ice.
690 DQSDT2=Q2SAT*A23M4/(SFCTMP-A4)**2
692 IF(SNOW(I,J).GT.0.0)THEN
693 ! snow on surface (use ice saturation properties)
695 E2SAT=611.2*EXP(6174.*(1./273.15 - 1./SFCTSNO))
696 Q2SATI=0.622*E2SAT/(SFCPRS-E2SAT)
697 Q2SATI=Q2SATI/(1.0+Q2SATI) ! spec. hum.
698 IF (T1 .GT. 273.14) THEN
699 ! warm ground temps, weight the saturation between ice and water according to SNOWC
700 Q2SAT=Q2SAT*(1.-SNOWC(I,J)) + Q2SATI*SNOWC(I,J)
701 DQSDT2=DQSDT2*(1.-SNOWC(I,J)) + Q2SATI*6174./(SFCTSNO**2)*SNOWC(I,J)
703 ! cold ground temps, use ice saturation only
705 DQSDT2=Q2SATI*6174./(SFCTSNO**2)
707 ! for snow cover fraction at 0 C, ground temp will not change, so DQSDT2 effectively zero
708 IF(T1 .GT. 273. .AND. SNOWC(I,J) .GT. 0.)DQSDT2=DQSDT2*(1.-SNOWC(I,J))
712 ! Sea-ice point has deep-level temperature of -2 C
715 ! Land-ice or land points have the usual deep-soil temperature.
718 IF(VEGTYP.EQ.25) SHDFAC=0.0000
719 IF(VEGTYP.EQ.26) SHDFAC=0.0000
720 IF(VEGTYP.EQ.27) SHDFAC=0.0000
721 IF(SOILTYP.EQ.14.AND.XICE(I,J).EQ.0.)THEN
723 IF(IPRINT)PRINT*,' SOIL TYPE FOUND TO BE WATER AT A LAND-POINT'
724 IF(IPRINT)PRINT*,i,j,'RESET SOIL in surfce.F'
728 SNOALB1 = SNOALB(I,J)
731 !-------------------------------------------
732 !*** convert snow depth from mm to meter
735 ! SNOALB=ALBMAX(I,J)*0.01
737 ! SNOALB=MAXALB(IVGTPK)*0.01
745 SNOTIME1 = SNOTIME(I,J)
747 !FEI: temporaray arrays above need to be changed later by using SI
750 SMC(NS)=SMOIS(I,NS,J)
751 STC(NS)=TSLB(I,NS,J) !STEMP
755 if ( (SNEQV.ne.0..AND.SNOWHK.eq.0.).or.(SNOWHK.le.SNEQV) )THEN
760 !Fei: urban. for urban surface, if calling UCM, redefine the natural surface in cities as
761 ! the "NATURAL" category in the VEGPARM.TBL
763 IF(SF_URBAN_PHYSICS == 1.OR. SF_URBAN_PHYSICS==2.OR.SF_URBAN_PHYSICS==3 ) THEN
764 IF( IVGTYP(I,J) == ISURBAN .or. IVGTYP(I,J) == 31 .or. &
765 IVGTYP(I,J) == 32 .or. IVGTYP(I,J) == 33) THEN
767 SHDFAC = SHDTBL(NATURAL)
770 EMISSI = 0.98 !for VEGTYP=5
771 IF ( FRC_URB2D(I,J) < 0.99 ) THEN
772 if(sf_urban_physics.eq.1)then
773 T1= ( TSK(I,J) -FRC_URB2D(I,J) * TS_URB2D (I,J) )/ (1-FRC_URB2D(I,J))
774 elseif((sf_urban_physics.eq.2).OR.(sf_urban_physics.eq.3))then
776 r2= frc_urb2d(i,j)*(ts_urb2d(i,j)**4.)
777 r3= (1.-frc_urb2d(i,j))
778 t1= ((r1-r2)/r3)**.25
785 IF( IVGTYP(I,J) == ISURBAN .or. IVGTYP(I,J) == 31 .or. &
786 IVGTYP(I,J) == 32 .or. IVGTYP(I,J) == 33) THEN
794 print*, 'BEFORE SFLX, in Noahlsm_driver'
795 print*, 'ICE', ICE, 'DT',DT, 'ZLVL',ZLVL, 'NSOIL', NSOIL, &
796 'SLDPTH', SLDPTH, 'LOCAL',LOCAL, 'LUTYPE',&
797 LUTYPE, 'SLTYPE',SLTYPE, 'LWDN',LWDN, 'SOLDN',SOLDN, &
798 'SFCPRS',SFCPRS, 'PRCP',PRCP,'SFCTMP',SFCTMP,'Q2K',Q2K, &
799 'TH2',TH2,'Q2SAT',Q2SAT,'DQSDT2',DQSDT2,'VEGTYP', VEGTYP,&
800 'SOILTYP',SOILTYP, 'SLOPETYP',SLOPETYP, 'SHDFAC',SHDFAC,&
801 'SHMIN',SHMIN, 'ALBBRD',ALBBRD,'SNOALB1',SNOALB1,'TBOT',&
802 TBOT, 'Z0BRD',Z0BRD, 'Z0K',Z0K, 'CMC',CMC, 'T1',T1,'STC',&
803 STC, 'SMC',SMC, 'SWC',SWC,'SNOWHK',SNOWHK,'SNEQV',SNEQV,&
804 'ALBEDOK',ALBEDOK,'CHK',CHK,'ETA',ETA,'SHEAT',SHEAT, &
805 'ETA_KINEMATIC',ETA_KINEMATIC, 'FDOWN',FDOWN,'EC',EC, &
806 'EDIR',EDIR,'ET',ET,'ETT',ETT,'ESNOW',ESNOW,'DRIP',DRIP,&
807 'DEW',DEW,'BETA',BETA,'ETP',ETP,'SSOIL',SSOIL,'FLX1',FLX1,&
808 'FLX2',FLX2,'FLX3',FLX3,'SNOMLT',SNOMLT,'SNCOVR',SNCOVR,&
809 'RUNOFF1',RUNOFF1,'RUNOFF2',RUNOFF2,'RUNOFF3',RUNOFF3, &
810 'RC',RC, 'PC',PC,'RSMIN',RSMIN,'XLAI',XLAI,'RCS',RCS, &
811 'RCT',RCT,'RCQ',RCQ,'RCSOIL',RCSOIL,'SOILW',SOILW, &
812 'SOILM',SOILM,'Q1',Q1,'SMCWLT',SMCWLT,'SMCDRY',SMCDRY,&
813 'SMCREF',SMCREF,'SMCMAX',SMCMAX,'NROOT',NROOT
822 CALL SFLX (FFROZP, ICE, ISURBAN, DT,ZLVL,NSOIL,SLDPTH, & !C
824 LUTYPE, SLTYPE, & !CL
825 LWDN,SOLDN,SOLNET,SFCPRS,PRCP,SFCTMP,Q2K,DUMMY, & !F
826 DUMMY,DUMMY, DUMMY, & !F PRCPRAIN not used
827 TH2,Q2SAT,DQSDT2, & !I
828 VEGTYP,SOILTYP,SLOPETYP,SHDFAC,SHMIN,SHMAX, & !I
829 ALBBRD, SNOALB1,TBOT, Z0BRD, Z0K, EMISSI, EMBRD, & !S
830 CMC,T1,STC,SMC,SWC,SNOWHK,SNEQV,ALBEDOK,CHK,dummy,& !H
831 ETA,SHEAT, ETA_KINEMATIC,FDOWN, & !O
832 EC,EDIR,ET,ETT,ESNOW,DRIP,DEW, & !O
836 RUNOFF1,RUNOFF2,RUNOFF3, & !O
837 RC,PC,RSMIN,XLAI,RCS,RCT,RCQ,RCSOIL, & !O
842 SMCWLT,SMCDRY,SMCREF,SMCMAX,NROOT)
850 print*, 'AFTER SFLX, in Noahlsm_driver'
851 print*, 'ICE', ICE, 'DT',DT, 'ZLVL',ZLVL, 'NSOIL', NSOIL, &
852 'SLDPTH', SLDPTH, 'LOCAL',LOCAL, 'LUTYPE',&
853 LUTYPE, 'SLTYPE',SLTYPE, 'LWDN',LWDN, 'SOLDN',SOLDN, &
854 'SFCPRS',SFCPRS, 'PRCP',PRCP,'SFCTMP',SFCTMP,'Q2K',Q2K, &
855 'TH2',TH2,'Q2SAT',Q2SAT,'DQSDT2',DQSDT2,'VEGTYP', VEGTYP,&
856 'SOILTYP',SOILTYP, 'SLOPETYP',SLOPETYP, 'SHDFAC',SHDFAC,&
857 'SHDMIN',SHMIN, 'ALBBRD',ALBBRD,'SNOALB',SNOALB1,'TBOT',&
858 TBOT, 'Z0BRD',Z0BRD, 'Z0K',Z0K, 'CMC',CMC, 'T1',T1,'STC',&
859 STC, 'SMC',SMC, 'SWc',SWC,'SNOWHK',SNOWHK,'SNEQV',SNEQV,&
860 'ALBEDOK',ALBEDOK,'CHK',CHK,'ETA',ETA,'SHEAT',SHEAT, &
861 'ETA_KINEMATIC',ETA_KINEMATIC, 'FDOWN',FDOWN,'EC',EC, &
862 'EDIR',EDIR,'ET',ET,'ETT',ETT,'ESNOW',ESNOW,'DRIP',DRIP,&
863 'DEW',DEW,'BETA',BETA,'ETP',ETP,'SSOIL',SSOIL,'FLX1',FLX1,&
864 'FLX2',FLX2,'FLX3',FLX3,'SNOMLT',SNOMLT,'SNCOVR',SNCOVR,&
865 'RUNOFF1',RUNOFF1,'RUNOFF2',RUNOFF2,'RUNOFF3',RUNOFF3, &
866 'RC',RC, 'PC',PC,'RSMIN',RSMIN,'XLAI',XLAI,'RCS',RCS, &
867 'RCT',RCT,'RCQ',RCQ,'RCSOIL',RCSOIL,'SOILW',SOILW, &
868 'SOILM',SOILM,'Q1',Q1,'SMCWLT',SMCWLT,'SMCDRY',SMCDRY,&
869 'SMCREF',SMCREF,'SMCMAX',SMCMAX,'NROOT',NROOT
873 !*** UPDATE STATE VARIABLES
875 SNOW(I,J)=SNEQV*1000.
876 ! SNOWH(I,J)=SNOWHK*1000.
877 SNOWH(I,J)=SNOWHK ! SNOWHK in meters
879 ALB_RURAL(I,J)=ALBEDOK
883 EMISS_RURAL(I,J) = EMISSI
884 ! MEK Nov2006 turn off
890 ! MEk Jul07 add potential evap accum
891 POTEVP(I,J)=POTEVP(I,J)+ETP*FDTW
892 QFX(I,J)=ETA_KINEMATIC
893 QFX_RURAL(I,J)=ETA_KINEMATIC
897 GRDFLX_RURAL(I,J)=SSOIL
900 SNOTIME(I,J) = SNOTIME1
901 ! prevent diagnostic ground q (q1) from being greater than qsat(tsk)
902 ! as happens over snow cover where the cqs2 value also becomes irrelevant
903 ! by setting cqs2=chs in this situation the 2m q should become just qv(k=1)
904 IF (Q1 .GT. QSFC(I,J)) THEN
908 ! Convert QSFC back to mixing ratio
909 QSFC(I,J)= Q1/(1.0-Q1)
911 QSFC_RURAL(I,J)= Q1/(1.0-Q1)
912 ! Calculate momentum flux from rural surface for use with multi-layer UCM (Martilli et al. 2002)
915 SMOIS(I,NS,J)=SMC(NS)
916 TSLB(I,NS,J)=STC(NS) ! STEMP
922 ! Residual of surface energy balance equation terms
924 noahres(i,j) = ( solnet + lwdn ) - sheat + ssoil - eta - ( emissi * STBOLT * (t1**4) ) - flx1 - flx2 - flx3
927 IF (SF_URBAN_PHYSICS == 1 ) THEN ! Beginning of UCM CALL if block
928 !--------------------------------------
929 ! URBAN CANOPY MODEL START - urban
930 !--------------------------------------
931 ! Input variables lsm --> urban
934 IF( IVGTYP(I,J) == ISURBAN .or. IVGTYP(I,J) == 31 .or. &
935 IVGTYP(I,J) == 32 .or. IVGTYP(I,J) == 33 ) THEN
940 UTYPE_URB = UTYPE_URB2D(I,J) !urban type (low, high or industrial)
942 TA_URB = SFCTMP ! [K]
943 QA_URB = Q2K ! [kg/kg]
944 UA_URB = SQRT(U_PHY(I,1,J)**2.+V_PHY(I,1,J)**2.)
945 U1_URB = U_PHY(I,1,J)
946 V1_URB = V_PHY(I,1,J)
947 IF(UA_URB < 1.) UA_URB=1. ! [m/s]
948 SSG_URB = SOLDN ! [W/m/m]
949 SSGD_URB = 0.8*SOLDN ! [W/m/m]
950 SSGQ_URB = SSG_URB-SSGD_URB ! [W/m/m]
951 LLG_URB = GLW(I,J) ! [W/m/m]
952 RAIN_URB = RAINBL(I,J) ! [mm]
953 RHOO_URB = SFCPRS / (287.04 * SFCTMP * (1.0+ 0.61 * Q2K)) ![kg/m/m/m]
955 DELT_URB = DT ! [sec]
956 XLAT_URB = XLAT_URB2D(I,J) ! [deg]
957 COSZ_URB = COSZ_URB2D(I,J) !
958 OMG_URB = OMG_URB2D(I,J) !
963 TR_URB = TR_URB2D(I,J)
964 TB_URB = TB_URB2D(I,J)
965 TG_URB = TG_URB2D(I,J)
966 TC_URB = TC_URB2D(I,J)
967 QC_URB = QC_URB2D(I,J)
968 UC_URB = UC_URB2D(I,J)
970 DO K = 1,num_roof_layers
971 TRL_URB(K) = TRL_URB3D(I,K,J)
973 DO K = 1,num_wall_layers
974 TBL_URB(K) = TBL_URB3D(I,K,J)
976 DO K = 1,num_road_layers
977 TGL_URB(K) = TGL_URB3D(I,K,J)
980 XXXR_URB = XXXR_URB2D(I,J)
981 XXXB_URB = XXXB_URB2D(I,J)
982 XXXG_URB = XXXG_URB2D(I,J)
983 XXXC_URB = XXXC_URB2D(I,J)
986 ! Limits to avoid dividing by small number
987 if (CHS(I,J) < 1.0E-02) then
990 if (CHS2(I,J) < 1.0E-02) then
993 if (CQS2(I,J) < 1.0E-02) then
999 IF (PRESENT(CMR_SFCDIF)) THEN
1000 CMR_URB = CMR_SFCDIF(I,J)
1001 CHR_URB = CHR_SFCDIF(I,J)
1002 CMC_URB = CMC_SFCDIF(I,J)
1003 CHC_URB = CHC_SFCDIF(I,J)
1008 CALL urban(LSOLAR_URB, & ! I
1009 num_roof_layers,num_wall_layers,num_road_layers, & ! C
1011 UTYPE_URB,TA_URB,QA_URB,UA_URB,U1_URB,V1_URB,SSG_URB, & ! I
1012 SSGD_URB,SSGQ_URB,LLG_URB,RAIN_URB,RHOO_URB, & ! I
1013 ZA_URB,DECLIN_URB,COSZ_URB,OMG_URB, & ! I
1014 XLAT_URB,DELT_URB,ZNT_URB, & ! I
1015 CHS_URB, CHS2_URB, & ! I
1016 TR_URB, TB_URB, TG_URB, TC_URB, QC_URB,UC_URB, & ! H
1017 TRL_URB,TBL_URB,TGL_URB, & ! H
1018 XXXR_URB, XXXB_URB, XXXG_URB, XXXC_URB, & ! H
1019 TS_URB,QS_URB,SH_URB,LH_URB,LH_KINEMATIC_URB, & ! O
1020 SW_URB,ALB_URB,LW_URB,G_URB,RN_URB,PSIM_URB,PSIH_URB, & ! O
1022 CMR_URB, CHR_URB, CMC_URB, CHC_URB, &
1023 U10_URB, V10_URB, TH2_URB, Q2_URB, & ! O
1029 print*, 'AFTER CALL URBAN'
1030 print*,'num_roof_layers',num_roof_layers, 'num_wall_layers', &
1032 'DZR',DZR,'DZB',DZB,'DZG',DZG,'UTYPE_URB',UTYPE_URB,'TA_URB', &
1034 'QA_URB',QA_URB,'UA_URB',UA_URB,'U1_URB',U1_URB,'V1_URB', &
1036 'SSG_URB',SSG_URB,'SSGD_URB',SSGD_URB,'SSGQ_URB',SSGQ_URB, &
1037 'LLG_URB',LLG_URB,'RAIN_URB',RAIN_URB,'RHOO_URB',RHOO_URB, &
1038 'ZA_URB',ZA_URB, 'DECLIN_URB',DECLIN_URB,'COSZ_URB',COSZ_URB,&
1039 'OMG_URB',OMG_URB,'XLAT_URB',XLAT_URB,'DELT_URB',DELT_URB, &
1040 'ZNT_URB',ZNT_URB,'TR_URB',TR_URB, 'TB_URB',TB_URB,'TG_URB',&
1041 TG_URB,'TC_URB',TC_URB,'QC_URB',QC_URB,'TRL_URB',TRL_URB, &
1042 'TBL_URB',TBL_URB,'TGL_URB',TGL_URB,'XXXR_URB',XXXR_URB, &
1043 'XXXB_URB',XXXB_URB,'XXXG_URB',XXXG_URB,'XXXC_URB',XXXC_URB,&
1044 'TS_URB',TS_URB,'QS_URB',QS_URB,'SH_URB',SH_URB,'LH_URB', &
1045 LH_URB, 'LH_KINEMATIC_URB',LH_KINEMATIC_URB,'SW_URB',SW_URB,&
1046 'ALB_URB',ALB_URB,'LW_URB',LW_URB,'G_URB',G_URB,'RN_URB', &
1047 RN_URB, 'PSIM_URB',PSIM_URB,'PSIH_URB',PSIH_URB, &
1048 'U10_URB',U10_URB,'V10_URB',V10_URB,'TH2_URB',TH2_URB, &
1049 'Q2_URB',Q2_URB,'CHS_URB',CHS_URB,'CHS2_URB',CHS2_URB
1053 TS_URB2D(I,J) = TS_URB
1055 ALBEDO(I,J) = FRC_URB2D(I,J)*ALB_URB+(1-FRC_URB2D(I,J))*ALBEDOK ![-]
1056 HFX(I,J) = FRC_URB2D(I,J)*SH_URB+(1-FRC_URB2D(I,J))*SHEAT ![W/m/m]
1057 QFX(I,J) = FRC_URB2D(I,J)*LH_KINEMATIC_URB &
1058 + (1-FRC_URB2D(I,J))*ETA_KINEMATIC ![kg/m/m/s]
1059 LH(I,J) = FRC_URB2D(I,J)*LH_URB+(1-FRC_URB2D(I,J))*ETA ![W/m/m]
1060 GRDFLX(I,J) = FRC_URB2D(I,J)*G_URB+(1-FRC_URB2D(I,J))*SSOIL ![W/m/m]
1061 TSK(I,J) = FRC_URB2D(I,J)*TS_URB+(1-FRC_URB2D(I,J))*T1 ![K]
1062 QSFC(I,J)= FRC_URB2D(I,J)*QS_URB+(1-FRC_URB2D(I,J))*Q1 ![-]
1067 print*, ' FRC_URB2D', FRC_URB2D, &
1068 'ALB_URB',ALB_URB, 'ALBEDOK',ALBEDOK, &
1069 'ALBEDO(I,J)', ALBEDO(I,J), &
1070 'SH_URB',SH_URB,'SHEAT',SHEAT, 'HFX(I,J)',HFX(I,J), &
1071 'LH_KINEMATIC_URB',LH_KINEMATIC_URB,'ETA_KINEMATIC', &
1072 ETA_KINEMATIC, 'QFX(I,J)',QFX(I,J), &
1073 'LH_URB',LH_URB, 'ETA',ETA, 'LH(I,J)',LH(I,J), &
1074 'G_URB',G_URB,'SSOIL',SSOIL,'GRDFLX(I,J)', GRDFLX(I,J),&
1075 'TS_URB',TS_URB,'T1',T1,'TSK(I,J)',TSK(I,J), &
1076 'QS_URB',QS_URB,'Q1',Q1,'QSFC(I,J)',QSFC(I,J)
1082 ! Renew Urban State Varialbes
1084 TR_URB2D(I,J) = TR_URB
1085 TB_URB2D(I,J) = TB_URB
1086 TG_URB2D(I,J) = TG_URB
1087 TC_URB2D(I,J) = TC_URB
1088 QC_URB2D(I,J) = QC_URB
1089 UC_URB2D(I,J) = UC_URB
1091 DO K = 1,num_roof_layers
1092 TRL_URB3D(I,K,J) = TRL_URB(K)
1094 DO K = 1,num_wall_layers
1095 TBL_URB3D(I,K,J) = TBL_URB(K)
1097 DO K = 1,num_road_layers
1098 TGL_URB3D(I,K,J) = TGL_URB(K)
1100 XXXR_URB2D(I,J) = XXXR_URB
1101 XXXB_URB2D(I,J) = XXXB_URB
1102 XXXG_URB2D(I,J) = XXXG_URB
1103 XXXC_URB2D(I,J) = XXXC_URB
1105 SH_URB2D(I,J) = SH_URB
1106 LH_URB2D(I,J) = LH_URB
1107 G_URB2D(I,J) = G_URB
1108 RN_URB2D(I,J) = RN_URB
1109 PSIM_URB2D(I,J) = PSIM_URB
1110 PSIH_URB2D(I,J) = PSIH_URB
1111 GZ1OZ0_URB2D(I,J)= GZ1OZ0_URB
1112 U10_URB2D(I,J) = U10_URB
1113 V10_URB2D(I,J) = V10_URB
1114 TH2_URB2D(I,J) = TH2_URB
1115 Q2_URB2D(I,J) = Q2_URB
1116 UST_URB2D(I,J) = UST_URB
1117 AKMS_URB2D(I,J) = KARMAN * UST_URB2D(I,J)/(GZ1OZ0_URB2D(I,J)-PSIM_URB2D(I,J))
1118 IF (PRESENT(CMR_SFCDIF)) THEN
1119 CMR_SFCDIF(I,J) = CMR_URB
1120 CHR_SFCDIF(I,J) = CHR_URB
1121 CMC_SFCDIF(I,J) = CMC_URB
1122 CHC_SFCDIF(I,J) = CHC_URB
1126 ENDIF ! end of UCM CALL if block
1127 !--------------------------------------
1128 ! Urban Part End - urban
1129 !--------------------------------------
1133 SMSTOT(I,J)=SOILM*1000.
1134 ! Convert the water unit into mm
1135 SFCRUNOFF(I,J)=SFCRUNOFF(I,J)+RUNOFF1*DT*1000.0
1136 UDRUNOFF(I,J)=UDRUNOFF(I,J)+(RUNOFF2+RUNOFF3)*DT*1000.0
1137 ! snow defined when fraction of frozen precip (FFROZP) > 0.5,
1138 IF(FFROZP.GT.0.5)THEN
1139 ACSNOW(I,J)=ACSNOW(I,J)+PRCP*DT
1141 IF(SNOW(I,J).GT.0.)THEN
1142 ACSNOM(I,J)=ACSNOM(I,J)+SNOMLT*1000.
1143 ! accumulated snow-melt energy
1144 SNOPCX(I,J)=SNOPCX(I,J)-SNOMLT/FDTLIW
1147 ENDIF ! endif of land-sea test
1149 100 CONTINUE ! of I loop
1153 IF (SF_URBAN_PHYSICS == 2) THEN
1164 CALL BEP(frc_urb2d,utype_urb2d,itimestep,dz8w,dt,u_phy,v_phy, &
1165 th_phy,rho,p_phy,swdown,glw, &
1166 gmt,julday,xlong,xlat,declin_urb,cosz_urb2d,omg_urb2d, &
1168 trb_urb4d,tw1_urb4d,tw2_urb4d,tgb_urb4d, &
1169 sfw1_urb3d,sfw2_urb3d,sfr_urb3d,sfg_urb3d, &
1170 a_u_bep,a_v_bep,a_t_bep, &
1171 a_e_bep,b_u_bep,b_v_bep, &
1172 b_t_bep,b_e_bep,dlg_bep, &
1173 dl_u_bep,sf_bep,vl_bep, &
1174 rl_up_urb,rs_abs_urb,emiss_urb,grdflx_urb, &
1175 ids,ide, jds,jde, kds,kde, &
1176 ims,ime, jms,jme, kms,kme, &
1177 its,ite, jts,jte, kts,kte )
1182 IF (SF_URBAN_PHYSICS == 3) THEN
1194 CALL BEP_BEM(frc_urb2d,utype_urb2d,itimestep,dz8w,dt,u_phy,v_phy, &
1195 th_phy,rho,p_phy,swdown,glw, &
1196 gmt,julday,xlong,xlat,declin_urb,cosz_urb2d,omg_urb2d, &
1198 trb_urb4d,tw1_urb4d,tw2_urb4d,tgb_urb4d, &
1199 tlev_urb3d,qlev_urb3d,tw1lev_urb3d,tw2lev_urb3d, &
1200 tglev_urb3d,tflev_urb3d,sf_ac_urb3d,lf_ac_urb3d, &
1201 cm_ac_urb3d,sfvent_urb3d,lfvent_urb3d, &
1202 sfwin1_urb3d,sfwin2_urb3d, &
1203 sfw1_urb3d,sfw2_urb3d,sfr_urb3d,sfg_urb3d, &
1204 a_u_bep,a_v_bep,a_t_bep, &
1205 a_e_bep,b_u_bep,b_v_bep, &
1206 b_t_bep,b_e_bep,b_q_bep,dlg_bep, &
1207 dl_u_bep,sf_bep,vl_bep, &
1208 rl_up_urb,rs_abs_urb,emiss_urb,grdflx_urb,qv3d, &
1209 ids,ide, jds,jde, kds,kde, &
1210 ims,ime, jms,jme, kms,kme, &
1211 its,ite, jts,jte, kts,kte )
1215 if((sf_urban_physics.eq.2).OR.(sf_urban_physics.eq.3))then !Bep begin
1216 ! fix the value of the Stefan-Boltzmann constant
1225 a_u_bep(i,k,j)=a_u_bep(i,k,j)*frc_urb2d(i,j)
1226 a_v_bep(i,k,j)=a_v_bep(i,k,j)*frc_urb2d(i,j)
1227 a_t_bep(i,k,j)=a_t_bep(i,k,j)*frc_urb2d(i,j)
1230 b_u_bep(i,k,j)=b_u_bep(i,k,j)*frc_urb2d(i,j)
1231 b_v_bep(i,k,j)=b_v_bep(i,k,j)*frc_urb2d(i,j)
1232 b_t_bep(i,k,j)=b_t_bep(i,k,j)*frc_urb2d(i,j)
1233 b_q_bep(i,k,j)=b_q_bep(i,k,j)*frc_urb2d(i,j)
1234 b_e_bep(i,k,j)=b_e_bep(i,k,j)*frc_urb2d(i,j)
1235 HFX_URB(I,J)=HFX_URB(I,J)+B_T_BEP(I,K,J)*RHO(I,K,J)*CP* &
1236 DZ8W(I,K,J)*VL_BEP(I,K,J)
1237 QFX_URB(I,J)=QFX_URB(I,J)+B_Q_BEP(I,K,J)* &
1238 DZ8W(I,K,J)*VL_BEP(I,K,J)
1239 UMOM_URB(I,J)=UMOM_URB(I,J)+ (A_U_BEP(I,K,J)*U_PHY(I,K,J)+ &
1240 B_U_BEP(I,K,J))*DZ8W(I,K,J)*VL_BEP(I,K,J)
1241 VMOM_URB(I,J)=VMOM_URB(I,J)+ (A_V_BEP(I,K,J)*V_PHY(I,K,J)+ &
1242 B_V_BEP(I,K,J))*DZ8W(I,K,J)*VL_BEP(I,K,J)
1243 vl_bep(i,k,j)=(1.-frc_urb2d(i,j))+vl_bep(i,k,j)*frc_urb2d(i,j)
1244 sf_bep(i,k,j)=(1.-frc_urb2d(i,j))+sf_bep(i,k,j)*frc_urb2d(i,j)
1246 a_u_bep(i,1,j)=(1.-frc_urb2d(i,j))*(-ust(I,J)*ust(I,J))/dz8w(i,1,j)/ &
1247 ((u_phy(i,1,j)**2+v_phy(i,1,j)**2.)**.5)+a_u_bep(i,1,j)
1248 a_v_bep(i,1,j)=(1.-frc_urb2d(i,j))*(-ust(I,J)*ust(I,J))/dz8w(i,1,j)/ &
1249 ((u_phy(i,1,j)**2+v_phy(i,1,j)**2.)**.5)+a_v_bep(i,1,j)
1250 b_t_bep(i,1,j)=(1.-frc_urb2d(i,j))*hfx_rural(i,j)/dz8w(i,1,j)/rho(i,1,j)/CP+ &
1252 b_q_bep(i,1,j)=(1.-frc_urb2d(i,j))*qfx_rural(i,j)/dz8w(i,1,j)/rho(i,1,j)+b_q_bep(i,1,j)
1253 umom=(1.-frc_urb2d(i,j))*ust(i,j)*ust(i,j)*u_phy(i,1,j)/ &
1254 ((u_phy(i,1,j)**2+v_phy(i,1,j)**2.)**.5)+umom_urb(i,j)
1255 vmom=(1.-frc_urb2d(i,j))*ust(i,j)*ust(i,j)*v_phy(i,1,j)/ &
1256 ((u_phy(i,1,j)**2+v_phy(i,1,j)**2.)**.5)+vmom_urb(i,j)
1259 ! compute upward longwave radiation from the rural part and total
1260 ! rl_up_rural=-emiss_rural(i,j)*sigma_sb*(tsk_rural(i,j)**4.)-(1.-emiss_rural(i,j))*glw(i,j)
1261 ! rl_up_tot=(1.-frc_urb2d(i,j))*rl_up_rural+frc_urb2d(i,j)*rl_up_urb(i,j)
1262 ! emiss(i,j)=(1.-frc_urb2d(i,j))*emiss_rural(i,j)+frc_urb2d(i,j)*emiss_urb(i,j)
1263 ! using the emissivity and the total longwave upward radiation estimate the averaged skin temperature
1264 IF (FRC_URB2D(I,J).GT.0.) THEN
1265 rl_up_rural=-emiss_rural(i,j)*sigma_sb*(tsk_rural(i,j)**4.)-(1.-emiss_rural(i,j))*glw(i,j)
1266 rl_up_tot=(1.-frc_urb2d(i,j))*rl_up_rural+frc_urb2d(i,j)*rl_up_urb(i,j)
1267 emiss(i,j)=(1.-frc_urb2d(i,j))*emiss_rural(i,j)+frc_urb2d(i,j)*emiss_urb(i,j)
1268 ts_urb2d(i,j)=((-rl_up_urb(i,j)-(1.-emiss_urb(i,j))*glw(i,j))/emiss_urb(i,j)/sigma_sb)**0.25
1269 tsk(i,j)=( (-1.*rl_up_tot-(1.-emiss(i,j))*glw(i,j) )/emiss(i,j)/sigma_sb)**.25
1270 rs_abs_tot=(1.-frc_urb2d(i,j))*swdown(i,j)*(1.-albedo(i,j))+frc_urb2d(i,j)*rs_abs_urb(i,j)
1271 if(swdown(i,j).gt.0.)then
1272 albedo(i,j)=1.-rs_abs_tot/swdown(i,j)
1274 albedo(i,j)=alb_rural(i,j)
1276 ! rename *_urb to sh_urb2d,lh_urb2d,g_urb2d,rn_urb2d
1277 grdflx(i,j)= (1.-frc_urb2d(i,j))*grdflx_rural(i,j)+frc_urb2d(i,j)*grdflx_urb(i,j)
1278 qfx(i,j)=(1.-frc_urb2d(i,j))*qfx_rural(i,j)+qfx_urb(i,j)
1279 ! lh(i,j)=(1.-frc_urb2d(i,j))*qfx_rural(i,j)*xlv
1280 lh(i,j)=qfx(i,j)*xlv
1281 HFX(I,J) = HFX_URB(I,J)+(1-FRC_URB2D(I,J))*HFX_RURAL(I,J) ![W/m/m]
1282 SH_URB2D(I,J) = HFX_URB(I,J)/FRC_URB2D(I,J)
1283 LH_URB2D(I,J) = qfx_urb(i,j)*xlv
1284 G_URB2D(I,J) = grdflx_urb(i,j)
1285 RN_URB2D(I,J) = rs_abs_urb(i,j)+emiss_urb(i,j)*glw(i,j)-rl_up_urb(i,j)
1286 ust(i,j)=(umom**2.+vmom**2.)**.25
1287 ! if(tsk(i,j).gt.350)write(*,*)'tsk too big!',i,j,tsk(i,j)
1288 ! if(tsk(i,j).lt.260)write(*,*)'tsk too small!',i,j,tsk(i,j),rl_up_tot,rl_up_urb(i,j),rl_up_rural
1289 ! print*,'ivgtyp,i,j,sigma_sb',ivgtyp(i,j),i,j,sigma_sb
1290 ! print*,'hfx,lh,qfx,grdflx,ts_urb2d',hfx(i,j),lh(i,j),qfx(i,j),grdflx(i,j),ts_urb2d(i,j)
1291 ! print*,'tsk,albedo,emiss',tsk(i,j),albedo(i,j),emiss(i,j)
1292 ! if(i.eq.56.and.j.eq.29)then
1293 ! print*,'ivgtyp, qfx, hfx',ivgtyp(i,j),hfx_rural(i,j),qfx_rural(i,j)
1294 ! print*,'emiss_rural,emiss_urb',emiss_rural(i,j),emiss_urb(i,j)
1295 ! print*,'rl_up_rural,rl_up_urb(i,j)',rl_up_rural,rl_up_urb(i,j)
1296 ! print*,'tsk_rural,ts_urb2d(i,j),tsk',tsk_rural(i,j),ts_urb2d(i,j),tsk(i,j)
1297 ! print*,'reconstruction fei',((emiss(i,j)*tsk(i,j)**4.-frc_urb2d(i,j)*emiss_urb(i,j)*ts_urb2d(i,j)**4.)/(emiss_rural(i,j)*(1.-frc_urb2d(i,j))))**.25
1298 ! print*,'ivgtyp,hfx,hfx_urb,hfx_rural',hfx(i,j),hfx_urb(i,j),hfx_rural(i,j)
1299 ! print*,'lh,lh_rural',lh(i,j),lh_rural(i,j)
1300 ! print*,'qfx',qfx(i,j)
1301 ! print*,'ts_urb2d',ts_urb2d(i,j)
1302 ! print*,'ust',ust(i,j)
1303 ! print*,'swdown,glw',swdown(i,j),glw(i,j)
1311 ! IF( IVGTYP(I,J) == 1 .or. IVGTYP(I,J) == 31 .or. &
1312 ! IVGTYP(I,J) == 32 .or. IVGTYP(I,J) == 33) THEN
1313 ! print*,'ivgtyp, qfx, hfx',ivgtyp(i,j),hfx_rural(i,j),qfx_rural(i,j)
1314 ! print*,'ivgtyp,hfx,hfx_urb,hfx_rural',hfx(i,j),hfx_urb(i,j),hfx_rural(i,j)
1315 ! print*,'lh,lh_rural',lh(i,j),lh_rural(i,j)
1316 ! print*,'qfx',qfx(i,j)
1317 ! print*,'ts_urb2d',ts_urb2d(i,j)
1318 ! print*,'ust',ust(i,j)
1326 !------------------------------------------------------
1328 !------------------------------------------------------
1330 SUBROUTINE LSMINIT(VEGFRA,SNOW,SNOWC,SNOWH,CANWAT,SMSTAV, &
1331 SMSTOT, SFCRUNOFF,UDRUNOFF,ACSNOW, &
1332 ACSNOM,IVGTYP,ISLTYP,TSLB,SMOIS,SH2O,ZS,DZS, &
1334 SNOALB, FNDSOILW, FNDSNOWH, RDMAXALB, &
1335 num_soil_layers, restart, &
1337 ids,ide, jds,jde, kds,kde, &
1338 ims,ime, jms,jme, kms,kme, &
1339 its,ite, jts,jte, kts,kte )
1341 INTEGER, INTENT(IN ) :: ids,ide, jds,jde, kds,kde, &
1342 ims,ime, jms,jme, kms,kme, &
1343 its,ite, jts,jte, kts,kte
1345 INTEGER, INTENT(IN) :: num_soil_layers
1347 LOGICAL , INTENT(IN) :: restart , allowed_to_read
1349 REAL, DIMENSION( num_soil_layers), INTENT(INOUT) :: ZS, DZS
1351 REAL, DIMENSION( ims:ime, num_soil_layers, jms:jme ) , &
1352 INTENT(INOUT) :: SMOIS, & !Total soil moisture
1353 SH2O, & !liquid soil moisture
1356 REAL, DIMENSION( ims:ime, jms:jme ) , &
1357 INTENT(INOUT) :: SNOW, &
1370 INTEGER, DIMENSION( ims:ime, jms:jme ) , &
1371 INTENT(IN) :: IVGTYP, &
1373 CHARACTER(LEN=*), INTENT(IN) :: MMINLU
1375 LOGICAL, INTENT(IN) :: FNDSOILW , &
1377 LOGICAL, INTENT(IN) :: RDMAXALB
1381 REAL :: BX, SMCMAX, PSISAT, FREE
1382 REAL, PARAMETER :: BLIM = 5.5, HLICE = 3.335E5, &
1383 GRAV = 9.81, T0 = 273.15
1386 character*256 :: MMINSL
1390 ! initialize three Noah LSM related tables
1391 IF ( allowed_to_read ) THEN
1392 CALL wrf_message( 'INITIALIZE THREE Noah LSM RELATED TABLES' )
1393 CALL SOIL_VEG_GEN_PARM( MMINLU, MMINSL )
1396 IF(.not.restart)THEN
1404 IF ( ISLTYP( i,j ) .LT. 1 ) THEN
1406 WRITE(err_message,*)"module_sf_noahlsm.F: lsminit: out of range ISLTYP ",i,j,ISLTYP( i,j )
1407 CALL wrf_message(err_message)
1409 IF(.not.RDMAXALB) THEN
1410 SNOALB(i,j)=MAXALB(IVGTYP(i,j))*0.01
1414 IF ( errflag .EQ. 1 ) THEN
1415 CALL wrf_error_fatal( "module_sf_noahlsm.F: lsminit: out of range value "// &
1416 "of ISLTYP. Is this field in the input?" )
1420 ! need this parameter for dust parameterization in wrf/chem
1423 porosity(i)=maxsmc(i)
1427 ! initialize soil liquid water content SH2O
1429 ! IF(.NOT.FNDSOILW) THEN
1431 ! If no SWC, do the following
1432 ! PRINT *,'SOIL WATER NOT FOUND - VALUE SET IN LSMINIT'
1435 BX = BB(ISLTYP(I,J))
1436 SMCMAX = MAXSMC(ISLTYP(I,J))
1437 PSISAT = SATPSI(ISLTYP(I,J))
1438 if ((bx > 0.0).and.(smcmax > 0.0).and.(psisat > 0.0)) then
1439 DO NS=1, num_soil_layers
1440 ! ----------------------------------------------------------------------
1441 !SH2O <= SMOIS for T < 273.149K (-0.001C)
1442 IF (TSLB(I,NS,J) < 273.149) THEN
1443 ! ----------------------------------------------------------------------
1444 ! first guess following explicit solution for Flerchinger Eqn from Koren
1445 ! et al, JGR, 1999, Eqn 17 (KCOUNT=0 in FUNCTION FRH2O).
1446 ! ISLTPK is soil type
1447 BX = BB(ISLTYP(I,J))
1448 SMCMAX = MAXSMC(ISLTYP(I,J))
1449 PSISAT = SATPSI(ISLTYP(I,J))
1450 IF ( BX > BLIM ) BX = BLIM
1451 FK=(( (HLICE/(GRAV*(-PSISAT))) * &
1452 ((TSLB(I,NS,J)-T0)/TSLB(I,NS,J)) )**(-1/BX) )*SMCMAX
1453 IF (FK < 0.02) FK = 0.02
1454 SH2O(I,NS,J) = MIN( FK, SMOIS(I,NS,J) )
1455 ! ----------------------------------------------------------------------
1456 ! now use iterative solution for liquid soil water content using
1457 ! FUNCTION FRH2O with the initial guess for SH2O from above explicit
1459 CALL FRH2O (FREE,TSLB(I,NS,J),SMOIS(I,NS,J),SH2O(I,NS,J), &
1462 ELSE ! of IF (TSLB(I,NS,J)
1463 ! ----------------------------------------------------------------------
1464 ! SH2O = SMOIS ( for T => 273.149K (-0.001C)
1465 SH2O(I,NS,J)=SMOIS(I,NS,J)
1466 ! ----------------------------------------------------------------------
1467 ENDIF ! of IF (TSLB(I,NS,J)
1468 END DO ! of DO NS=1, num_soil_layers
1469 else ! of if ((bx > 0.0)
1470 DO NS=1, num_soil_layers
1471 SH2O(I,NS,J)=SMOIS(I,NS,J)
1473 endif ! of if ((bx > 0.0)
1474 ENDDO ! DO I = its,itf
1475 ENDDO ! DO J = jts,jtf
1476 ! ENDIF ! of IF(.NOT.FNDSOILW)THEN
1478 ! initialize physical snow height SNOWH
1480 IF(.NOT.FNDSNOWH)THEN
1481 ! If no SNOWH do the following
1482 CALL wrf_message( 'SNOW HEIGHT NOT FOUND - VALUE DEFINED IN LSMINIT' )
1485 SNOWH(I,J)=SNOW(I,J)*0.005 ! SNOW in mm and SNOWH in m
1490 ! initialize canopy water to ZERO
1493 ! print*,'Note that canopy water content (CANWAT) is set to ZERO in LSMINIT'
1502 !------------------------------------------------------------------------------
1503 END SUBROUTINE lsminit
1504 !------------------------------------------------------------------------------
1508 !-----------------------------------------------------------------
1509 SUBROUTINE SOIL_VEG_GEN_PARM( MMINLU, MMINSL)
1510 !-----------------------------------------------------------------
1512 USE module_wrf_error
1515 CHARACTER(LEN=*), INTENT(IN) :: MMINLU, MMINSL
1516 integer :: LUMATCH, IINDEX, LC, NUM_SLOPE
1518 INTEGER , PARAMETER :: OPEN_OK = 0
1520 character*128 :: mess , message
1521 logical, external :: wrf_dm_on_monitor
1524 !-----SPECIFY VEGETATION RELATED CHARACTERISTICS :
1525 ! ALBBCK: SFC albedo (in percentage)
1526 ! Z0: Roughness length (m)
1527 ! SHDFAC: Green vegetation fraction (in percentage)
1528 ! Note: The ALBEDO, Z0, and SHDFAC values read from the following table
1529 ! ALBEDO, amd Z0 are specified in LAND-USE TABLE; and SHDFAC is
1530 ! the monthly green vegetation data
1531 ! CMXTBL: MAX CNPY Capacity (m)
1532 ! NROTBL: Rooting depth (layer)
1533 ! RSMIN: Mimimum stomatal resistance (s m-1)
1534 ! RSMAX: Max. stomatal resistance (s m-1)
1535 ! RGL: Parameters used in radiation stress function
1536 ! HS: Parameter used in vapor pressure deficit functio
1537 ! TOPT: Optimum transpiration air temperature. (K)
1538 ! CMCMAX: Maximum canopy water capacity
1539 ! CFACTR: Parameter used in the canopy inteception calculati
1540 ! SNUP: Threshold snow depth (in water equivalent m) that
1541 ! implies 100% snow cover
1542 ! LAI: Leaf area index (dimensionless)
1543 ! MAXALB: Upper bound on maximum albedo over deep snow
1545 !-----READ IN VEGETAION PROPERTIES FROM VEGPARM.TBL
1548 IF ( wrf_dm_on_monitor() ) THEN
1550 OPEN(19, FILE='VEGPARM.TBL',FORM='FORMATTED',STATUS='OLD',IOSTAT=ierr)
1551 IF(ierr .NE. OPEN_OK ) THEN
1552 WRITE(message,FMT='(A)') &
1553 'module_sf_noahlsm.F: soil_veg_gen_parm: failure opening VEGPARM.TBL'
1554 CALL wrf_error_fatal ( message )
1560 FIND_LUTYPE : DO WHILE (LUMATCH == 0)
1561 READ (19,*,END=2002)
1562 READ (19,*,END=2002)LUTYPE
1563 READ (19,*)LUCATS,IINDEX
1565 IF(LUTYPE.EQ.MMINLU)THEN
1566 WRITE( mess , * ) 'LANDUSE TYPE = ' // TRIM ( LUTYPE ) // ' FOUND', LUCATS,' CATEGORIES'
1567 CALL wrf_message( mess )
1570 call wrf_message ( "Skipping over LUTYPE = " // TRIM ( LUTYPE ) )
1571 DO LC = 1, LUCATS+12
1576 ! prevent possible array overwrite, Bill Bovermann, IBM, May 6, 2008
1577 IF ( SIZE(SHDTBL) < LUCATS .OR. &
1578 SIZE(NROTBL) < LUCATS .OR. &
1579 SIZE(RSTBL) < LUCATS .OR. &
1580 SIZE(RGLTBL) < LUCATS .OR. &
1581 SIZE(HSTBL) < LUCATS .OR. &
1582 SIZE(SNUPTBL) < LUCATS .OR. &
1583 SIZE(MAXALB) < LUCATS .OR. &
1584 SIZE(LAIMINTBL) < LUCATS .OR. &
1585 SIZE(LAIMAXTBL) < LUCATS .OR. &
1586 SIZE(Z0MINTBL) < LUCATS .OR. &
1587 SIZE(Z0MAXTBL) < LUCATS .OR. &
1588 SIZE(ALBEDOMINTBL) < LUCATS .OR. &
1589 SIZE(ALBEDOMAXTBL) < LUCATS .OR. &
1590 SIZE(EMISSMINTBL ) < LUCATS .OR. &
1591 SIZE(EMISSMAXTBL ) < LUCATS ) THEN
1592 CALL wrf_error_fatal('Table sizes too small for value of LUCATS in module_sf_noahdrv.F')
1595 IF(LUTYPE.EQ.MMINLU)THEN
1597 READ (19,*)IINDEX,SHDTBL(LC), &
1598 NROTBL(LC),RSTBL(LC),RGLTBL(LC),HSTBL(LC), &
1599 SNUPTBL(LC),MAXALB(LC), LAIMINTBL(LC), &
1600 LAIMAXTBL(LC),EMISSMINTBL(LC), &
1601 EMISSMAXTBL(LC), ALBEDOMINTBL(LC), &
1602 ALBEDOMAXTBL(LC), Z0MINTBL(LC), Z0MAXTBL(LC)
1606 READ (19,*)TOPT_DATA
1608 READ (19,*)CMCMAX_DATA
1610 READ (19,*)CFACTR_DATA
1612 READ (19,*)RSMAX_DATA
1622 IF (LUMATCH == 0) then
1623 CALL wrf_error_fatal ("Land Use Dataset '"//MMINLU//"' not found in VEGPARM.TBL.")
1627 CALL wrf_dm_bcast_string ( LUTYPE , 4 )
1628 CALL wrf_dm_bcast_integer ( LUCATS , 1 )
1629 CALL wrf_dm_bcast_integer ( IINDEX , 1 )
1630 CALL wrf_dm_bcast_integer ( LUMATCH , 1 )
1631 CALL wrf_dm_bcast_real ( SHDTBL , NLUS )
1632 CALL wrf_dm_bcast_real ( NROTBL , NLUS )
1633 CALL wrf_dm_bcast_real ( RSTBL , NLUS )
1634 CALL wrf_dm_bcast_real ( RGLTBL , NLUS )
1635 CALL wrf_dm_bcast_real ( HSTBL , NLUS )
1636 CALL wrf_dm_bcast_real ( SNUPTBL , NLUS )
1637 CALL wrf_dm_bcast_real ( LAIMINTBL , NLUS )
1638 CALL wrf_dm_bcast_real ( LAIMAXTBL , NLUS )
1639 CALL wrf_dm_bcast_real ( Z0MINTBL , NLUS )
1640 CALL wrf_dm_bcast_real ( Z0MAXTBL , NLUS )
1641 CALL wrf_dm_bcast_real ( EMISSMINTBL , NLUS )
1642 CALL wrf_dm_bcast_real ( EMISSMAXTBL , NLUS )
1643 CALL wrf_dm_bcast_real ( ALBEDOMINTBL , NLUS )
1644 CALL wrf_dm_bcast_real ( ALBEDOMAXTBL , NLUS )
1645 CALL wrf_dm_bcast_real ( MAXALB , NLUS )
1646 CALL wrf_dm_bcast_real ( TOPT_DATA , 1 )
1647 CALL wrf_dm_bcast_real ( CMCMAX_DATA , 1 )
1648 CALL wrf_dm_bcast_real ( CFACTR_DATA , 1 )
1649 CALL wrf_dm_bcast_real ( RSMAX_DATA , 1 )
1650 CALL wrf_dm_bcast_integer ( BARE , 1 )
1651 CALL wrf_dm_bcast_integer ( NATURAL , 1 )
1654 !-----READ IN SOIL PROPERTIES FROM SOILPARM.TBL
1656 IF ( wrf_dm_on_monitor() ) THEN
1657 OPEN(19, FILE='SOILPARM.TBL',FORM='FORMATTED',STATUS='OLD',IOSTAT=ierr)
1658 IF(ierr .NE. OPEN_OK ) THEN
1659 WRITE(message,FMT='(A)') &
1660 'module_sf_noahlsm.F: soil_veg_gen_parm: failure opening SOILPARM.TBL'
1661 CALL wrf_error_fatal ( message )
1664 WRITE(mess,*) 'INPUT SOIL TEXTURE CLASSIFICAION = ', TRIM ( MMINSL )
1665 CALL wrf_message( mess )
1670 READ (19,2000,END=2003)SLTYPE
1672 READ (19,*)SLCATS,IINDEX
1673 IF(SLTYPE.EQ.MMINSL)THEN
1674 WRITE( mess , * ) 'SOIL TEXTURE CLASSIFICATION = ', TRIM ( SLTYPE ) , ' FOUND', &
1675 SLCATS,' CATEGORIES'
1676 CALL wrf_message ( mess )
1679 ! prevent possible array overwrite, Bill Bovermann, IBM, May 6, 2008
1680 IF ( SIZE(BB ) < SLCATS .OR. &
1681 SIZE(DRYSMC) < SLCATS .OR. &
1682 SIZE(F11 ) < SLCATS .OR. &
1683 SIZE(MAXSMC) < SLCATS .OR. &
1684 SIZE(REFSMC) < SLCATS .OR. &
1685 SIZE(SATPSI) < SLCATS .OR. &
1686 SIZE(SATDK ) < SLCATS .OR. &
1687 SIZE(SATDW ) < SLCATS .OR. &
1688 SIZE(WLTSMC) < SLCATS .OR. &
1689 SIZE(QTZ ) < SLCATS ) THEN
1690 CALL wrf_error_fatal('Table sizes too small for value of SLCATS in module_sf_noahdrv.F')
1692 IF(SLTYPE.EQ.MMINSL)THEN
1694 READ (19,*) IINDEX,BB(LC),DRYSMC(LC),F11(LC),MAXSMC(LC),&
1695 REFSMC(LC),SATPSI(LC),SATDK(LC), SATDW(LC), &
1705 CALL wrf_dm_bcast_integer ( LUMATCH , 1 )
1706 CALL wrf_dm_bcast_string ( SLTYPE , 4 )
1707 CALL wrf_dm_bcast_string ( MMINSL , 4 ) ! since this is reset above, see oct2 ^
1708 CALL wrf_dm_bcast_integer ( SLCATS , 1 )
1709 CALL wrf_dm_bcast_integer ( IINDEX , 1 )
1710 CALL wrf_dm_bcast_real ( BB , NSLTYPE )
1711 CALL wrf_dm_bcast_real ( DRYSMC , NSLTYPE )
1712 CALL wrf_dm_bcast_real ( F11 , NSLTYPE )
1713 CALL wrf_dm_bcast_real ( MAXSMC , NSLTYPE )
1714 CALL wrf_dm_bcast_real ( REFSMC , NSLTYPE )
1715 CALL wrf_dm_bcast_real ( SATPSI , NSLTYPE )
1716 CALL wrf_dm_bcast_real ( SATDK , NSLTYPE )
1717 CALL wrf_dm_bcast_real ( SATDW , NSLTYPE )
1718 CALL wrf_dm_bcast_real ( WLTSMC , NSLTYPE )
1719 CALL wrf_dm_bcast_real ( QTZ , NSLTYPE )
1721 IF(LUMATCH.EQ.0)THEN
1722 CALL wrf_message( 'SOIl TEXTURE IN INPUT FILE DOES NOT ' )
1723 CALL wrf_message( 'MATCH SOILPARM TABLE' )
1724 CALL wrf_error_fatal ( 'INCONSISTENT OR MISSING SOILPARM FILE' )
1728 !-----READ IN GENERAL PARAMETERS FROM GENPARM.TBL
1730 IF ( wrf_dm_on_monitor() ) THEN
1731 OPEN(19, FILE='GENPARM.TBL',FORM='FORMATTED',STATUS='OLD',IOSTAT=ierr)
1732 IF(ierr .NE. OPEN_OK ) THEN
1733 WRITE(message,FMT='(A)') &
1734 'module_sf_noahlsm.F: soil_veg_gen_parm: failure opening GENPARM.TBL'
1735 CALL wrf_error_fatal ( message )
1740 READ (19,*) NUM_SLOPE
1743 ! prevent possible array overwrite, Bill Bovermann, IBM, May 6, 2008
1744 IF ( SIZE(slope_data) < NUM_SLOPE ) THEN
1745 CALL wrf_error_fatal('NUM_SLOPE too large for slope_data array in module_sf_noahdrv')
1749 READ (19,*)SLOPE_DATA(LC)
1753 READ (19,*)SBETA_DATA
1755 READ (19,*)FXEXP_DATA
1757 READ (19,*)CSOIL_DATA
1759 READ (19,*)SALP_DATA
1761 READ (19,*)REFDK_DATA
1763 READ (19,*)REFKDT_DATA
1765 READ (19,*)FRZK_DATA
1767 READ (19,*)ZBOT_DATA
1769 READ (19,*)CZIL_DATA
1771 READ (19,*)SMLOW_DATA
1773 READ (19,*)SMHIGH_DATA
1775 READ (19,*)LVCOEF_DATA
1779 CALL wrf_dm_bcast_integer ( NUM_SLOPE , 1 )
1780 CALL wrf_dm_bcast_integer ( SLPCATS , 1 )
1781 CALL wrf_dm_bcast_real ( SLOPE_DATA , NSLOPE )
1782 CALL wrf_dm_bcast_real ( SBETA_DATA , 1 )
1783 CALL wrf_dm_bcast_real ( FXEXP_DATA , 1 )
1784 CALL wrf_dm_bcast_real ( CSOIL_DATA , 1 )
1785 CALL wrf_dm_bcast_real ( SALP_DATA , 1 )
1786 CALL wrf_dm_bcast_real ( REFDK_DATA , 1 )
1787 CALL wrf_dm_bcast_real ( REFKDT_DATA , 1 )
1788 CALL wrf_dm_bcast_real ( FRZK_DATA , 1 )
1789 CALL wrf_dm_bcast_real ( ZBOT_DATA , 1 )
1790 CALL wrf_dm_bcast_real ( CZIL_DATA , 1 )
1791 CALL wrf_dm_bcast_real ( SMLOW_DATA , 1 )
1792 CALL wrf_dm_bcast_real ( SMHIGH_DATA , 1 )
1793 CALL wrf_dm_bcast_real ( LVCOEF_DATA , 1 )
1796 !-----------------------------------------------------------------
1797 END SUBROUTINE SOIL_VEG_GEN_PARM
1798 !-----------------------------------------------------------------
1800 END MODULE module_sf_noahdrv