wrf svn trunk commit r4103
[wrffire.git] / wrfv2_fire / phys / module_sf_noahdrv.F
blob6817db48a3c1060995c0811fb104a1e9f5d5a8dd
1 MODULE module_sf_noahdrv
3 !-------------------------------
4   USE module_sf_noahlsm
5   USE module_sf_urban
6   USE module_sf_bep
7   USE module_sf_bep_bem
8 #ifdef WRF_CHEM
9   USE module_data_gocart_dust
10 #endif
11 !-------------------------------
14 CONTAINS
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
27                   myj,frpcpn,                                   &
28                   SH2O,SNOWH,                                   & !H
29                   U_PHY,V_PHY,                                  & !I
30                   SNOALB,SHDMIN,SHDMAX,                         & !I
31                   SNOTIME,                                      & !?
32                   ACSNOM,ACSNOW,                                & !O
33                   SNOPCX,                                       & !O
34                   POTEVP,                                       & !O
35                   XICE_THRESHOLD,                               &
36                   RDLAI2D,USEMONALB,                            &
37                   RIB,                                          & !?
38                   NOAHRES,                                      &
39                   ids,ide, jds,jde, kds,kde,                    &
40                   ims,ime, jms,jme, kms,kme,                    &
41                   its,ite, jts,jte, kts,kte,                    &
42                   sf_urban_physics,                             &
43                   CMR_SFCDIF,CHR_SFCDIF,CMC_SFCDIF,CHC_SFCDIF,  &
44 !Optional Urban
45                   TR_URB2D,TB_URB2D,TG_URB2D,TC_URB2D,QC_URB2D, & !H urban
46                   UC_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 !----------------------------------------------------------------
75     IMPLICIT NONE
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)
91 !-- History variables
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);
105 ! --- soil variables
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)
122 ! --- snow variables
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
133 ! --- LSM output
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)
180 !-- ROVCP       R/CP
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 !----------------------------------------------------------------
204 ! IN only
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, &
216                                                          XLAND, &
217                                                           XICE, &
218                                                         VEGFRA, &
219                                                         SHDMIN, &
220                                                         SHDMAX, &
221                                                         SNOALB, &
222                                                            GSW, &
223                                                         SWDOWN, & !added 10 jan 2007
224                                                            GLW, &
225                                                         RAINBL, &
226                                                         EMBCK,  &
227                                                         SR
229    REAL,    DIMENSION( ims:ime, jms:jme )                     , &
230             INTENT(INOUT)    ::                         ALBBCK, &
231                                                             Z0
232    CHARACTER(LEN=*), INTENT(IN   )    ::                 MMINLU
234    REAL,    DIMENSION( ims:ime, kms:kme, jms:jme )            , &
235             INTENT(IN   )    ::                           QV3D, &
236                                                          p8w3D, &
237                                                           DZ8W, &
238                                                           T3D
239    REAL,     DIMENSION( ims:ime, jms:jme )                    , &
240              INTENT(IN   )               ::               QGH,  &
241                                                           CPM
243    INTEGER, DIMENSION( ims:ime, jms:jme )                     , &
244             INTENT(IN   )    ::                         IVGTYP, &
245                                                         ISLTYP
247    INTEGER, INTENT(IN)       ::     num_soil_layers,ITIMESTEP
249    REAL,     INTENT(IN   )   ::     DT,ROVCP
251    REAL,     DIMENSION(1:num_soil_layers), INTENT(IN)::DZS
253 ! IN and OUT
255    REAL,     DIMENSION( ims:ime , 1:num_soil_layers, jms:jme ), &
256              INTENT(INOUT)   ::                          SMOIS, & ! total soil moisture
257                                                          SH2O,  & ! new soil liquid
258                                                          TSLB     ! TSLB     STEMP
260    REAL,    DIMENSION( ims:ime, jms:jme )                     , &
261             INTENT(INOUT)    ::                            TSK, & !was TGB (temperature)
262                                                            HFX, &
263                                                            QFX, &
264                                                             LH, &
265                                                         GRDFLX, &
266                                                           QSFC,&
267                                                           CQS2,&
268                                                           CHS,   &
269                                                           CHS2,&
270                                                           SNOW, &
271                                                          SNOWC, &
272                                                          SNOWH, & !new
273                                                         CANWAT, &
274                                                         SMSTAV, &
275                                                         SMSTOT, &
276                                                      SFCRUNOFF, &
277                                                       UDRUNOFF, &
278                                                         ACSNOM, &
279                                                         ACSNOW, &
280                                                        SNOTIME, &
281                                                         SNOPCX, &
282                                                         EMISS,  &
283                                                           RIB,  &
284                                                         POTEVP, &
285                                                         ALBEDO, &
286                                                            ZNT
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,  &
305 !                RCS,RCT,RCQ,RCSOIL
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
315       LOGICAL :: IPRINT
317 ! ----------------------------------------------------------------------
318 ! DECLARATIONS - INTEGER
319 ! ----------------------------------------------------------------------
320       INTEGER :: I,J, ICE,NSOIL,SLOPETYP,SOILTYP,VEGTYP
321       INTEGER :: NROOT
322       INTEGER :: KZ ,K
323       INTEGER :: NS
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, &
331                EMBRD,                                                    &
332                Z0K,RUNOFF1,RUNOFF2,RUNOFF3,SHEAT,SOLNET,E2SAT,SFCTSNO,   &
333 ! mek, WRF testing, expanded diagnostics
334                SOLUP,LWUP,RNET,RES,Q1SFC,TAIRV,SATFLG
335 ! MEK MAY 2007
336       REAL ::  FDTLIW
337 ! MEK JUL2007 for pot. evap.
338       REAL :: RIBB
339       REAL ::  FDTW
341       REAL  :: EMISSI
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
348       REAL  :: DUMMY,Z0BRD
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)
357 ! MEK MAY 2007
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]
404      REAL :: TR_URB
405      REAL :: TB_URB
406      REAL :: TG_URB
407      REAL :: TC_URB
408      REAL :: QC_URB
409      REAL :: UC_URB
410      REAL :: XXXR_URB
411      REAL :: XXXB_URB
412      REAL :: XXXG_URB
413      REAL :: XXXC_URB
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                  [-]
474      REAL :: CHS_URB
475      REAL :: CHS2_URB
476      REAL :: UST_URB
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
532    REAL :: r1,r2,r3
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
544 ! MEK MAY 2007
545       FDTLIW=DT/ROWLIW
546 ! MEK JUL2007
547       FDTW=DT/(XLV*RHOWATER)
548 ! debug printout
549          IPRINT=.false.
551 !      SLOPETYP=2
552       SLOPETYP=1
553 !      SHDMIN=0.00
556       NSOIL=num_soil_layers
558      DO NS=1,NSOIL
559      SLDPTH(NS)=DZS(NS)
560      ENDDO
562    DO J=jts,jte
564       IF(ITIMESTEP.EQ.1)THEN
565         DO 50 I=its,ite
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
569 !                  DO NS=1,NSOIL
570 !                      SMOIS(I,NS,J)=0.10
571 !                      SH2O(I,NS,J)=0.10
572 !                  enddo
573 !             endif
574 !         ENDIF
576 !*** SET ZERO-VALUE FOR SOME OUTPUT DIAGNOSTIC ARRAYS
577           IF((XLAND(I,J)-1.5).GE.0.)THEN
578 ! check sea-ice point
579 #if 0
580             IF( XICE(I,J).GE. XICE_THRESHOLD .and. IPRINT ) PRINT*, ' sea-ice at water point, I=',I,'J=',J
581 #endif
582 !***   Open Water Case
583             SMSTAV(I,J)=1.0
584             SMSTOT(I,J)=1.0
585             DO NS=1,NSOIL
586               SMOIS(I,NS,J)=1.0
587               TSLB(I,NS,J)=273.16                                          !STEMP
588             ENDDO
589           ELSE
590             IF ( XICE(I,J) .GE. XICE_THRESHOLD ) THEN
591 !***        SEA-ICE CASE
592               SMSTAV(I,J)=1.0
593               SMSTOT(I,J)=1.0
594               DO NS=1,NSOIL
595                 SMOIS(I,NS,J)=1.0
596               ENDDO
597             ENDIF
598           ENDIF
600    50   CONTINUE
601       ENDIF                                                               ! end of initialization over ocean
603 !-----------------------------------------------------------------------
604       DO 100 I=its,ite
605 ! surface pressure
606         PSFC=P8w3D(i,1,j)
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))
612 !         Q2SAT=QGH(I,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
617           SATFLG=0.
618           CHKLOWQ(I,J)=0.
619         ELSE
620           SATFLG=1.0
621           CHKLOWQ(I,J)=1.
622         ENDIF
624         SFCTMP=T3D(i,1,j)
625         ZLVL=0.5*DZ8W(i,1,j)
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
631          SFCTH2=SFCTMP*APELM
632          TH2=SFCTH2/APES
634          EMISSI = EMISS(I,J)
635          LWDN=GLW(I,J)*EMISSI
636 ! SOLDN is total incoming solar
637         SOLDN=SWDOWN(I,J)
638 ! GSW is net downward solar
639 !        SOLNET=GSW(I,J)
640 ! use mid-day albedo to determine net downward solar (no solar zenith angle correction)
641         SOLNET=SOLDN*(1.-ALBEDO(I,J))
642         PRCP=RAINBL(i,j)/DT
643         VEGTYP=IVGTYP(I,J)
644         SOILTYP=ISLTYP(I,J)
645         SHDFAC=VEGFRA(I,J)/100.
646         T1=TSK(I,J)
647         CHK=CHS(I,J)
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
653         SNOWHK=SNOWH(I,J)
654         SNCOVR=SNOWC(I,J)
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
659        IF(FRPCPN) THEN
660           FFROZP=SR(I,J)
661         ELSE
662           IF (SFCTMP <=  273.15) THEN
663             FFROZP = 1.0
664           ELSE
665             FFROZP = 0.0
666           ENDIF
667         ENDIF
668 !***
669         IF((XLAND(I,J)-1.5).GE.0.)THEN                                  ! begining of land/sea if block
670 ! Open water points
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)
677         ELSE
678 ! Land or sea-ice case
680           IF (XICE(I,J) >= XICE_THRESHOLD) THEN
681              ! Sea-ice point
682              ICE = 1
683           ELSE IF ( VEGTYP == ISICE ) THEN
684              ! Land-ice point
685              ICE = -1
686           ELSE
687              ! Neither sea ice or land ice.
688              ICE=0
689           ENDIF
690           DQSDT2=Q2SAT*A23M4/(SFCTMP-A4)**2
692           IF(SNOW(I,J).GT.0.0)THEN
693 ! snow on surface (use ice saturation properties)
694             SFCTSNO=SFCTMP
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)
702             ELSE
703 ! cold ground temps, use ice saturation only
704               Q2SAT=Q2SATI
705               DQSDT2=Q2SATI*6174./(SFCTSNO**2)
706             ENDIF
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))
709           ENDIF
711           IF(ICE.EQ.1)THEN
712              ! Sea-ice point has deep-level temperature of -2 C
713              TBOT=271.16
714           ELSE
715              ! Land-ice or land points have the usual deep-soil temperature.
716              TBOT=TMN(I,J)
717           ENDIF
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
722 #if 0
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'
725 #endif
726             SOILTYP=7
727           ENDIF
728           SNOALB1 = SNOALB(I,J)
729           CMC=CANWAT(I,J)
731 !-------------------------------------------
732 !*** convert snow depth from mm to meter
734 !          IF(RDMAXALB) THEN
735 !           SNOALB=ALBMAX(I,J)*0.01
736 !         ELSE
737 !           SNOALB=MAXALB(IVGTPK)*0.01
738 !         ENDIF
740 !        SNOALB1=0.80
741 !        SHMIN=0.00
742         ALBBRD=ALBBCK(I,J)
743         Z0BRD=Z0(I,J)
744         EMBRD=EMBCK(I,J)
745         SNOTIME1 = SNOTIME(I,J)
746         RIBB=RIB(I,J)
747 !FEI: temporaray arrays above need to be changed later by using SI
749           DO 70 NS=1,NSOIL
750             SMC(NS)=SMOIS(I,NS,J)
751             STC(NS)=TSLB(I,NS,J)                                          !STEMP
752             SWC(NS)=SH2O(I,NS,J)
753    70     CONTINUE
755           if ( (SNEQV.ne.0..AND.SNOWHK.eq.0.).or.(SNOWHK.le.SNEQV) )THEN
756             SNOWHK= 5.*SNEQV
757           endif
760 !Fei: urban. for urban surface, if calling UCM, redefine the natural surface in cities as
761 ! the "NATURAL" category in the VEGPARM.TBL
762         
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
766                  VEGTYP = NATURAL
767                  SHDFAC = SHDTBL(NATURAL)
768                  ALBEDOK =0.2         !  0.2
769                  ALBBRD  =0.2         !0.2
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
775                 r1= (tsk(i,j)**4.)
776                 r2= frc_urb2d(i,j)*(ts_urb2d(i,j)**4.)
777                 r3= (1.-frc_urb2d(i,j))
778                 t1= ((r1-r2)/r3)**.25
779                    endif
780                  ELSE
781                  T1 = TSK(I,J)
782                  ENDIF
783                 ENDIF
784            ELSE
785                  IF( IVGTYP(I,J) == ISURBAN .or. IVGTYP(I,J) == 31 .or. &
786                   IVGTYP(I,J) == 32 .or. IVGTYP(I,J) == 33) THEN
787                   VEGTYP = ISURBAN
788                  ENDIF
789            ENDIF
791 #if 0
792           IF(IPRINT) 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
814            endif
815 #endif
818           IF (rdlai2d) THEN
819              xlai = lai(i,j)
820           endif
822        CALL SFLX (FFROZP, ICE, ISURBAN, DT,ZLVL,NSOIL,SLDPTH,     &    !C
823                  LOCAL,                                           &    !L
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
833                  BETA,ETP,SSOIL,                                  &    !O
834                  FLX1,FLX2,FLX3,                                  &    !O
835                  SNOMLT,SNCOVR,                                   &    !O
836                  RUNOFF1,RUNOFF2,RUNOFF3,                         &    !O
837                  RC,PC,RSMIN,XLAI,RCS,RCT,RCQ,RCSOIL,             &    !O
838                  SOILW,SOILM,Q1,                                  &    !D
839                  RDLAI2D,USEMONALB,                               &
840                  SNOTIME1,                                        &
841                  RIBB,                                            &
842                  SMCWLT,SMCDRY,SMCREF,SMCMAX,NROOT)
845        lai(i,j) = xlai
847 #if 0
848           IF(IPRINT) THEN
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
870            endif
871 #endif
873 !***  UPDATE STATE VARIABLES
874           CANWAT(I,J)=CMC
875           SNOW(I,J)=SNEQV*1000.
876 !          SNOWH(I,J)=SNOWHK*1000.
877           SNOWH(I,J)=SNOWHK                   ! SNOWHK in meters
878           ALBEDO(I,J)=ALBEDOK
879           ALB_RURAL(I,J)=ALBEDOK
880           ALBBCK(I,J)=ALBBRD
881           Z0(I,J)=Z0BRD
882           EMISS(I,J) = EMISSI
883           EMISS_RURAL(I,J) = EMISSI
884 ! MEK Nov2006 turn off
885 !          ZNT(I,J)=Z0K
886           TSK(I,J)=T1
887           TSK_RURAL(I,J)=T1
888           HFX(I,J)=SHEAT
889           HFX_RURAL(I,J)=SHEAT
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
894           LH(I,J)=ETA
895           LH_RURAL(I,J)=ETA
896           GRDFLX(I,J)=SSOIL
897           GRDFLX_RURAL(I,J)=SSOIL
898           SNOWC(I,J)=SNCOVR
899           CHS2(I,J)=CQS2(I,J)
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
905             CQS2(I,J) = CHS(I,J)
906           ENDIF
907 !          QSFC(I,J)=Q1
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)
914           DO 80 NS=1,NSOIL
915            SMOIS(I,NS,J)=SMC(NS)
916            TSLB(I,NS,J)=STC(NS)                                        !  STEMP
917            SH2O(I,NS,J)=SWC(NS)
918    80     CONTINUE
919 !       ENDIF
921      !
922      ! Residual of surface energy balance equation terms
923      !
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
937 ! Call urban
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]
954             ZA_URB    = ZLVL             ! [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)   !
959             ZNT_URB   = ZNT(I,J)
961             LSOLAR_URB = .FALSE.
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)
972             END DO
973             DO K = 1,num_wall_layers
974               TBL_URB(K) = TBL_URB3D(I,K,J)
975             END DO
976             DO K = 1,num_road_layers
977               TGL_URB(K) = TGL_URB3D(I,K,J)
978             END DO
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
988                CHS(I,J)  = 1.0E-02
989             endif
990             if (CHS2(I,J) < 1.0E-02) then
991                CHS2(I,J)  = 1.0E-02
992             endif
993             if (CQS2(I,J) < 1.0E-02) then
994                CQS2(I,J)  = 1.0E-02
995             endif
997             CHS_URB  = CHS(I,J)
998             CHS2_URB = CHS2(I,J)
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)
1004             ENDIF
1006 ! Call urban
1008             CALL urban(LSOLAR_URB,                                      & ! I
1009                        num_roof_layers,num_wall_layers,num_road_layers, & ! C
1010                        DZR,DZB,DZG,                                     & ! 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
1021                        GZ1OZ0_URB,                                      & !O
1022                        CMR_URB, CHR_URB, CMC_URB, CHC_URB,              &
1023                        U10_URB, V10_URB, TH2_URB, Q2_URB,               & ! O
1024                        UST_URB)                                           !O
1026 #if 0
1027           IF(IPRINT) THEN
1029        print*, 'AFTER CALL URBAN'
1030        print*,'num_roof_layers',num_roof_layers, 'num_wall_layers',  &
1031         num_wall_layers,                                             &
1032        'DZR',DZR,'DZB',DZB,'DZG',DZG,'UTYPE_URB',UTYPE_URB,'TA_URB', &
1033         TA_URB,                                                      &
1034         'QA_URB',QA_URB,'UA_URB',UA_URB,'U1_URB',U1_URB,'V1_URB',    &
1035          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
1050            endif
1051 #endif
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            ![-]
1064 #if 0
1065     IF(IPRINT)THEN
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)
1077      endif
1078 #endif
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)
1093             END DO
1094             DO K = 1,num_wall_layers
1095               TBL_URB3D(I,K,J) = TBL_URB(K)
1096             END DO
1097             DO K = 1,num_road_layers
1098               TGL_URB3D(I,K,J) = TGL_URB(K)
1099             END DO
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
1123             ENDIF
1124           END IF
1126          ENDIF                                   ! end of UCM CALL if block
1127 !--------------------------------------
1128 ! Urban Part End - urban
1129 !--------------------------------------
1131 !***  DIAGNOSTICS
1132           SMSTAV(I,J)=SOILW
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
1140           ENDIF
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
1145           ENDIF
1147         ENDIF                                                           ! endif of land-sea test
1149   100 CONTINUE                                                          ! of I loop
1151    ENDDO                                                                ! of J loop
1153       IF (SF_URBAN_PHYSICS == 2) THEN
1156          do j=jts,jte
1157          do i=its,ite
1158             EMISS_URB(i,j)=0.
1159             RL_UP_URB(i,j)=0.
1160             RS_ABS_URB(i,j)=0.
1161             GRDFLX_URB(i,j)=0.
1162          end do
1163          end do
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, &
1167                 num_urban_layers,                                      &
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 )
1179        ENDIF
1181        
1182        IF (SF_URBAN_PHYSICS == 3) THEN
1185          do j=jts,jte
1186          do i=its,ite
1187             EMISS_URB(i,j)=0.
1188             RL_UP_URB(i,j)=0.
1189             RS_ABS_URB(i,j)=0.
1190             GRDFLX_URB(i,j)=0.
1191          end do
1192          end do
1193           
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, &
1197                 num_urban_layers,                                      &
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 )
1213        ENDIF
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
1217          sigma_sb=5.67e-08
1218          do j=jts,jte
1219          do i=its,ite
1220             UMOM_URB(I,J)=0.
1221             VMOM_URB(I,J)=0.
1222             HFX_URB(I,J)=0.
1223             QFX_URB(I,J)=0.
1224          do k=kts,kte
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)
1228             a_q_bep(i,k,j)=0.        
1229             a_e_bep(i,k,j)=0.
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)
1245          end do
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+ &
1251                             b_t_bep(i,1,j)
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)
1257             sf_bep(i,1,j)=1.
1258            
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)
1273           else
1274            albedo(i,j)=alb_rural(i,j)
1275           endif
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)
1304 !                endif
1305             else
1306               SH_URB2D(I,J)    = 0.
1307               LH_URB2D(I,J)    = 0.
1308               G_URB2D(I,J)     = 0.
1309               RN_URB2D(I,J)    = 0.
1310             endif
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)
1319 !          endif
1320         enddo
1321         enddo
1324        endif                                                           !Bep end
1326 !------------------------------------------------------
1327    END SUBROUTINE lsm
1328 !------------------------------------------------------
1330   SUBROUTINE LSMINIT(VEGFRA,SNOW,SNOWC,SNOWH,CANWAT,SMSTAV,    &
1331                      SMSTOT, SFCRUNOFF,UDRUNOFF,ACSNOW,        &
1332                      ACSNOM,IVGTYP,ISLTYP,TSLB,SMOIS,SH2O,ZS,DZS, &
1333                      MMINLU,                                   &
1334                      SNOALB, FNDSOILW, FNDSNOWH, RDMAXALB,     &
1335                      num_soil_layers, restart,                 &
1336                      allowed_to_read ,                         &
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
1354                                                          TSLB      !STEMP
1356    REAL,    DIMENSION( ims:ime, jms:jme )                     , &
1357             INTENT(INOUT)    ::                           SNOW, &
1358                                                          SNOWH, &
1359                                                          SNOWC, &
1360                                                         SNOALB, &
1361                                                         CANWAT, &
1362                                                         SMSTAV, &
1363                                                         SMSTOT, &
1364                                                      SFCRUNOFF, &
1365                                                       UDRUNOFF, &
1366                                                         ACSNOW, &
1367                                                         VEGFRA, &
1368                                                         ACSNOM
1370    INTEGER, DIMENSION( ims:ime, jms:jme )                     , &
1371             INTENT(IN)       ::                         IVGTYP, &
1372                                                         ISLTYP
1373    CHARACTER(LEN=*),  INTENT(IN)      ::                MMINLU
1375    LOGICAL, INTENT(IN)       ::                      FNDSOILW , &
1376                                                      FNDSNOWH
1377    LOGICAL, INTENT(IN)       ::                      RDMAXALB
1380    INTEGER                   :: L
1381    REAL                      :: BX, SMCMAX, PSISAT, FREE
1382    REAL, PARAMETER           :: BLIM = 5.5, HLICE = 3.335E5,    &
1383                                 GRAV = 9.81, T0 = 273.15
1384    INTEGER                   :: errflag
1386    character*256 :: MMINSL
1387         MMINSL='STAS'
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 )
1394    ENDIF
1396    IF(.not.restart)THEN
1398    itf=min0(ite,ide-1)
1399    jtf=min0(jte,jde-1)
1401    errflag = 0
1402    DO j = jts,jtf
1403      DO i = its,itf
1404        IF ( ISLTYP( i,j ) .LT. 1 ) THEN
1405          errflag = 1
1406          WRITE(err_message,*)"module_sf_noahlsm.F: lsminit: out of range ISLTYP ",i,j,ISLTYP( i,j )
1407          CALL wrf_message(err_message)
1408        ENDIF
1409        IF(.not.RDMAXALB) THEN
1410           SNOALB(i,j)=MAXALB(IVGTYP(i,j))*0.01
1411        ENDIF
1412      ENDDO
1413    ENDDO
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?" )
1417    ENDIF
1418 #ifdef WRF_CHEM
1420 ! need this parameter for dust parameterization in wrf/chem
1422    do I=1,NSLTYPE
1423       porosity(i)=maxsmc(i)
1424    enddo
1425 #endif
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'
1433         DO J = jts,jtf
1434         DO I = its,itf
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
1458 ! first guess.
1459               CALL FRH2O (FREE,TSLB(I,NS,J),SMOIS(I,NS,J),SH2O(I,NS,J),    &
1460                  SMCMAX,BX,PSISAT)
1461               SH2O(I,NS,J) = FREE
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)
1472           END DO
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' )
1483           DO J = jts,jtf
1484           DO I = its,itf
1485             SNOWH(I,J)=SNOW(I,J)*0.005               ! SNOW in mm and SNOWH in m
1486           ENDDO
1487           ENDDO
1488         ENDIF
1490 ! initialize canopy water to ZERO
1492 !          GO TO 110
1493 !         print*,'Note that canopy water content (CANWAT) is set to ZERO in LSMINIT'
1494           DO J = jts,jtf
1495           DO I = its,itf
1496             CANWAT(I,J)=0.0
1497           ENDDO
1498           ENDDO
1499  110      CONTINUE
1501    ENDIF
1502 !------------------------------------------------------------------------------
1503   END SUBROUTINE lsminit
1504 !------------------------------------------------------------------------------
1508 !-----------------------------------------------------------------
1509         SUBROUTINE SOIL_VEG_GEN_PARM( MMINLU, MMINSL)
1510 !-----------------------------------------------------------------
1512         USE module_wrf_error
1513         IMPLICIT NONE
1515         CHARACTER(LEN=*), INTENT(IN) :: MMINLU, MMINSL
1516         integer :: LUMATCH, IINDEX, LC, NUM_SLOPE
1517         integer :: ierr
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 )
1555         END IF
1558         LUMATCH=0
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 )
1568               LUMATCH=1
1569            ELSE
1570               call wrf_message ( "Skipping over LUTYPE = " // TRIM ( LUTYPE ) )
1571               DO LC = 1, LUCATS+12
1572                  read(19,*)
1573               ENDDO
1574            ENDIF
1575         ENDDO FIND_LUTYPE
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')
1593         ENDIF
1595         IF(LUTYPE.EQ.MMINLU)THEN
1596           DO LC=1,LUCATS
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)
1603           ENDDO
1605           READ (19,*)
1606           READ (19,*)TOPT_DATA
1607           READ (19,*)
1608           READ (19,*)CMCMAX_DATA
1609           READ (19,*)
1610           READ (19,*)CFACTR_DATA
1611           READ (19,*)
1612           READ (19,*)RSMAX_DATA
1613           READ (19,*)
1614           READ (19,*)BARE
1615           READ (19,*)
1616           READ (19,*)NATURAL
1617         ENDIF
1619  2002   CONTINUE
1621         CLOSE (19)
1622         IF (LUMATCH == 0) then
1623            CALL wrf_error_fatal ("Land Use Dataset '"//MMINLU//"' not found in VEGPARM.TBL.")
1624         ENDIF
1625       ENDIF
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 )
1662         END IF
1664         WRITE(mess,*) 'INPUT SOIL TEXTURE CLASSIFICAION = ', TRIM ( MMINSL )
1665         CALL wrf_message( mess )
1667         LUMATCH=0
1669         READ (19,*)
1670         READ (19,2000,END=2003)SLTYPE
1671  2000   FORMAT (A4)
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 )
1677           LUMATCH=1
1678         ENDIF
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')
1691         ENDIF
1692         IF(SLTYPE.EQ.MMINSL)THEN
1693           DO LC=1,SLCATS
1694               READ (19,*) IINDEX,BB(LC),DRYSMC(LC),F11(LC),MAXSMC(LC),&
1695                         REFSMC(LC),SATPSI(LC),SATDK(LC), SATDW(LC),   &
1696                         WLTSMC(LC), QTZ(LC)
1697           ENDDO
1698         ENDIF
1700  2003   CONTINUE
1702         CLOSE (19)
1703       ENDIF
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' )
1725       ENDIF
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 )
1736         END IF
1738         READ (19,*)
1739         READ (19,*)
1740         READ (19,*) NUM_SLOPE
1742           SLPCATS=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')
1746           ENDIF
1748           DO LC=1,SLPCATS
1749               READ (19,*)SLOPE_DATA(LC)
1750           ENDDO
1752           READ (19,*)
1753           READ (19,*)SBETA_DATA
1754           READ (19,*)
1755           READ (19,*)FXEXP_DATA
1756           READ (19,*)
1757           READ (19,*)CSOIL_DATA
1758           READ (19,*)
1759           READ (19,*)SALP_DATA
1760           READ (19,*)
1761           READ (19,*)REFDK_DATA
1762           READ (19,*)
1763           READ (19,*)REFKDT_DATA
1764           READ (19,*)
1765           READ (19,*)FRZK_DATA
1766           READ (19,*)
1767           READ (19,*)ZBOT_DATA
1768           READ (19,*)
1769           READ (19,*)CZIL_DATA
1770           READ (19,*)
1771           READ (19,*)SMLOW_DATA
1772           READ (19,*)
1773           READ (19,*)SMHIGH_DATA
1774           READ (19,*)
1775           READ (19,*)LVCOEF_DATA
1776         CLOSE (19)
1777       ENDIF
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