forked from NCAR/hrldas-release
-
Notifications
You must be signed in to change notification settings - Fork 1
/
RELEASE_NOTES
353 lines (214 loc) · 11.4 KB
/
RELEASE_NOTES
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
=========================================================================
======================= HRLDAS WRFv4.1 Release Notes =====================
=========================================================================
LSM capabilities/enhancements
----------------------------------
- Consolidate NWM changes into WRF version (#18)
* add unpopulated header required by NOAA
* add BATS parameters to data structure and output band snow albedo
* update MPTABLE for BATS albedo parameters
* add BATS albedo local variables to noahmpdrv
* transfer new BATS table values to parameters data structure in noahmpdrv
* add RSURF_EXP parameter to data structure and update MPTABLE
* change snow water equivalent limit to 5000mm
* assume LAI is stand LAI and doesn't need to be rescaled by FVEG
* conserve snow pack heat when layer melts completely
* change output messages and Fortran open/read unit numbers to WCOSS standard
* include a few missed changes from WRF
LSM bug fixes
----------------------------------
- Define and declare a few variables in physics routines
- Noah-MP bulk urban roughness length set to table values
External modules capabilities/enhancements
-------------------------------------------
- Air conditioning fraction for BEM model
- Improve urban memory by allowing different dimensions for urban variables
Driver capabilities/enhancements
----------------------------------
- None
Driver bug fixes
----------------------------------
- None
=========================================================================
======================= HRLDAS v4.0.1 Release Notes =====================
=========================================================================
LSM capabilities/enhancements
----------------------------------
- None
LSM bug fixes
----------------------------------
- Noah-MP frozen soil initialization- An incorrect sign change was introduced in v4.0, impacting soil moisture and soil temperature initialization.
- Array out of bounds Noah-MP - Fix possible/likely array out of bounds by assuming homogeneous soil with depth.Only applies to opt_run=2.
- Noah-MP snow liquid water movement - prevent excessive gravitational water movement. Fixes unrealistic snow density values during melt season.
- Noah-MP divide by zero - Bug fix in v4.0 introduced a possible divide by zero when LAI is zero.
- Noah-MP leaf aerodynamic resistance - limit leaf aerodynamic resistance to prevent very large canopy exchange coefficients with high wind speed.
Driver capabilities/enhancements
----------------------------------
- Add new single point driver based on Bondville data
Driver bug fixes
----------------------------------
- Missing quotation mark in spatial_filename check print statement
=========================================================================
======================= HRLDAS v4.0 Release Notes =======================
=========================================================================
LSM capabilities/enhancements
----------------------------------
- Add pedotransfer function option for soil propertis
- add optional read for soil composition and multi-layer soil texture from setup/input file
- activated with opt_soil and opt_pedo
- update MPTABLE.TBL with pedotransfer function coefficients
- Add Gecros crop model
- activated with opt_crop=2 (Liu et al. crop now opt_crop=1)
- some modifications for crop initialization
- Groundwater module (opt_run=5) updates
- move init to driver for parallel capability
- remove rivermask/nonriver from input
- EPA modifications to output total stomatal resistance
LSM bug fixes
----------------------------------
- None
Driver capabilities/enhancements
----------------------------------
- Change some predefined defaults in user_build_options.compiler files based on some Cheyenne tests
- Add ISLAKE to the preprocessing and driver to accommodate WRF files that define a distinct lake category
Driver bug fixes
----------------------------------
- Change PGSXY and CROPCAT to be initialized undefined_int
=========================================================================
======================= HRLDAS v3.9 Release Notes =======================
=========================================================================
LSM capabilities/enhancements
----------------------------------
- Crop modifications in v3.9 to read in crop datasets and initialize properly
- Modifications in v3.9 to read in groundwater datasets
- Noah-MP can now run with single-layer and multi-layer urban models
LSM bug fixes
----------------------------------
- Several fixes in Section 1 of SOILPARM.TBL
- Fix strange Noah-MP behavior in soil water in certain conditions
- Fix uninitialized variable in Noah-MP surface exchange option
Driver capabilities/enhancements
----------------------------------
- Add capability to include snow in forcing files
Need to set FORCING_NAME_SN and PCP_PARTITION_OPTION = 4
Snow is assumed to be <= incoming precipitation
- Add capability to define name of forcing variables in namelist.hrldas
- Add spinup option to namelist
controlled by spinup_loops in namelist.hrldas
will run kday/khour spinup_loops times before starting the simulation
- Add capability to exclude the first output file since this file contains only initial states
and no computed fluxes
activated by namelist.hrldas option: SKIP_FIRST_OUTPUT = .true.
- Added README.namelist to describe all the namelist.hrldas options
Driver bug fixes
----------------------------------
- None
=========================================================================
======================= HRLDAS v3.8.1 Release Notes =====================
=========================================================================
LSM capabilities/enhancements
----------------------------------
- None
LSM bug fixes
----------------------------------
- Change C3C4 in MPTABLE to integer
- Set some limits on stability function for OPT_SFC = 2
- Change limit for minimum wood pool in dynamic vegetation
- Fix bug in QSFC calculation
- Prevent divide by zero when soil moisture is zero
- Fix a few bugs in the crop code; make DVEG = 10 activate crop model
Driver capabilities/enhancements
----------------------------------
- Added configure script for generating user_build_options file
Driver bug fixes
----------------------------------
- None
=========================================================================
======================= HRLDAS v3.8 Release Notes =======================
=========================================================================
LSM capabilities/enhancements
----------------------------------
- Added 3 new dveg option for reading LAI from forcing and 1 new dveg option for reading FVEG;
Also added initial commit of crop model; currently runs crop everywhere
dveg = 6 -> dynamic vegetation on (use FVEG = SHDFAC from input)
dveg = 7 -> dynamic vegetation off (use input LAI; use FVEG = SHDFAC from input)
dveg = 8 -> dynamic vegetation off (use input LAI; calculate FVEG)
dveg = 9 -> dynamic vegetation off (use input LAI; use maximum vegetation fraction)
dveg = 10 -> crop model on (use maximum vegetation fraction)
- Added glacier options:
opt_gla = 1 -> original Noah-MP version
opt_gla = 2 -> no ice phase change or sublimation (like Noah glacier)
- Added surface resistance as an option (now four options)
opt_sfc = 1 -> Sakaguchi and Zeng, 2009 (has been Noah-MP default)
opt_sfc = 2 -> Sellers (1992)
opt_sfc = 3 -> adjusted Sellers to decrease RSURF for wet soil
opt_sfc = 4 -> option 1 for non-snow; rsurf = rsurf_snow for snow (set as RSURF_SNOW in MPTABLE)
- Made the specification of urban types more general
(LOW_DENSITY_RESIDENTIAL, HIGH_DENSITY_RESIDENTIAL, HIGH_INTENSITY_INDUSTRIAL),
now set in the MPTABLE dependent on classification scheme (i.e., not limited to 31,32,33);
this is for future coupling with urban models.
LSM bug fixes
----------------------------------
- Fixed two bugs with OPT_STC=3
- Fixed bug in new surface resistance option causing divide by 0
- Write a message if incoming snow water and snow depth are inconsistent
Reduce SWE to 2000mm if input is >2000mm, Noah-MP limits SWE internally to 2000mm
- Recalculate ESTG in glacier code when snow is melting, will decrease sublimation,
but likely increase melting
Driver capabilities/enhancements
----------------------------------
- Added instructions and scripts for extraction of single point forcing and setup files from
2D datasets (e.g., NLDAS)
- Structure for spatially-varying soil properties added to DRV and LSM;
Use of the 2D/3D fields in the driver and DRV commented to be consistent with WRF
Driver bug fixes
----------------------------------
- Zero forcing where not land to prevent overflow with ifort
===========================================================================
======================= HRLDAS v3.7.1 Release Notes =======================
===========================================================================
LSM capabilities/enhancements
----------------------------------
- Added depth dimension to soil parameters.
LSM bug fixes
----------------------------------
- Reorganized parameters to fix problems with OpenMP in WRF simulations.
Driver capabilities/enhancements
----------------------------------
- none
Driver bug fixes
----------------------------------
- Initialized some accumulated fields at 0 (instead of undefined).
=========================================================================
======================= HRLDAS v3.7 Release Notes =======================
=========================================================================
New capabilities:
1. A parallel capability has been added by Wei Yu ([email protected]) to support mpi only.
To compile with parallel version
edit the file 'user_build_options'
uncommment the compiler section with MPI (available for pgf90 and ifort compilers)
To compile with sequential version
edit the file 'user_build_options'
uncommment the compiler section without MPI
2. System setup and execution now requires only a WRF/WPS geo_em file.
Dependence on the wrfinput file has been removed.
3. As part of #2, initialization no longer occurs in the first forcing file,
but in the file listed in the namelist as:
HRLDAS_SETUP_FILE = ""
The initialization fields are:
SNOW,CANWAT,TSK,TSLB,SMOIS
This file also contains the static grid/domain information:
XLAT,XLONG,TMN,HGT,SEAICE,MAPFAC_MX,MAPFAC_MY,SHDMAX,SHDMIN,XLAND,IVGTYP,ISLTYP,DZS,ZS
This file can also contains some optional fields:
LAI
NOTE: a WRF input file can be used as a HRLDAS_SETUP_FILE
4. The timing structure has changed:
- The initial conditions are the states at START time.
- First forcing file used is START time + FORCING_TIMESTEP
- First integration is START time + NOAH_TIMESTEP
- First output file is now START time + OUTPUT_TIMESTEP
- RESTART file states are consistent with OUTPUT file states with the same time stamp
5. Instructions for using GLDAS and NLDAS as forcing has been provided in addition to the NARR instructions (see /docs)
Also, a NCL script has been included for preparing single- or multi-point forcing
6. Initial LAI (if present in the HRLDAS_SETUP_FILE) will be used to initialize the leaf and stem carbon pools
7. Removed dependence on external GRIB tables for forcing creation; now in namelist only