ESCOMP
Implement GaoOneill raw urban datasets and OlesonFeddema urban properties into mksurfdata_esmf.
Description of changes
Implementation of GaoOneill raw urban datasets and OlesonFeddema urban properties into mksurfdata_esmf.
Specific notes
1a. Incorporate new raw urban surface datasets for 1850, present day (2000, 2005), historical, and five SSPs (SSP1, SSP2, SSP3, SSP4, SSP5) developed primarily by @keerzhang1 from Gao and O'Neill (2021) and Gao and Pesaresi (2022). The urban properties (morphological, radiative, and thermal) in these datasets are described in Oleson and Feddema (2020). These datasets have PCT_URBAN calculated with respect to the total area of the gridcell (as discussed in #1716 ). Note that the SSP1 datasets have been assigned to SSP1-1.9 and SSP1-2.6 and SSP4 datasets have been assigned to SSP4-3.4 and SSP4-6.0.
1b. A new building temperature stream file is implemented. The values of maximum interior building temperature in this file are documented in Oleson and Feddema (2020).
1c. Code changes in CTSM and mksurfdata_esmf to read in nlevurb from the surface dataset instead of being hardcoded in clm_varpar.F90. This will ensure backward compatibility with older urban datasets (which have nlevurb=5 as opposed to the new datasets which have nlevurb=10).
Note that the paths to these files have been hard-coded to my directories because I don't have inputdata permissions.
Contributors other than yourself, if any: @keerzhang1 (Keer Zhang), @fang-bowen (Bowen Fang), @Face2sea (Lei Zhao), @billsacks (Bill Sacks)
CTSM Issues Fixed (include github issue #): #1445 #591
Are answers expected to change (and if so in what way)? Yes, urban quantities will change due to changes in urban fraction and urban properties and thus grid cell averages will be different for grid cells that have non-zero urban fraction.
Any User Interface Changes (namelist or namelist defaults changes)? Yes, changes to namelist_defaults_ctsm.xml (new building temperature stream file), namelist_defaults_ctsm_tools.xml (new year 2000 raw urban dataset), gen_mksurfdata_namelist.xml (new raw urban datasets).
Testing performed, if any: Created 0.9x1.25 surface datasets and landuse timeseries for 1850, 1850-2015, 2000, 2005, 2015-2100 (SSP1-1.9, SSP1-2.6, SSP2-4.5, SSP3-7.0, SSP4-3.4, SSP4-6.0, SSP5-8.5) using mksurfdata_esmf.
@ekluzek I will go over Keith's PR with you in a quick meeting next week, before I merge with the ctsm5.2.mksurfdata branch.
@slevisconsulting can you make the meeting later in the week I'm out Monday
