This repository is supplementary to the paper "Sun, Y., Fang, B., Oleson, K. W., Zhao, L., Topping, D. O., Schultz, D. M., & Zheng, Z. (2024). Improving Urban Climate Adaptation Modelling in the Community Earth System Model (CESM) Through Transient Urban Surface Albedo Representation. Journal of Advances in Modeling Earth Systems, 16, e2024MS004380. https://doi.org/10.1029/2024MS004380".
The objectives of this project are:
- Modify CESM source code to realize transient urban albedo representation;
- Apply the new scheme for quantifying urban albedo cooling effects;
- Use simulation results for urban climate adaptation.
The standard source code comes from CTSM, with the release tag: clm5.0.30.
-
Create a new F90 file:
-
Apply the new module to:
-
Add new name-list for case run:
-
Add new name-list for case build:
-
Add new name-list for initialization:
The scripts listed below are used for processing simulation output and visualization.
| Num. | Subject | Simulation | Output data process | Visualization |
|---|---|---|---|---|
| 2.1 | Roof albedo impacts on urban heat islands | CNTL, ROOF_0.9, ROOF_DA | Use Export.ipynb to get *.csv from 2015 to 2099 | Figure.ipynb |
| 2.2 | Roof albedo impacts on urban heat stress and indoor temperature | CNTL, ROOF_0.9, ROOF_DA | Use Export.ipynb to get *.csv from 2015 to 2099 | Figure.ipynb |
| 2.3 | Roof albedo impacts on surface energy budget | CNTL, ROOF_0.9, ROOF_DA | Use Export.ipynb to get *.csv from 2015 to 2099 | Figure.ipynb |
| 2.4 | Urban surface heterogeneity in temperature | CNTL, ROOF_DA, IMPROAD_DA, WALL_DA | Use Export.ipynb to get *.csv from 2015 to 2099 | Figure.ipynb |
| 2.5 | Urban landunit heterogeneity in temperature | CNTL, ROOF_DA, IMPROAD_DA, WALL_DA | Use Export.ipynb to get *.csv from 2015 to 2099 | Figure.ipynb |
| 2.6 | Spatial variation | CNTL, ROOF_DA, IMPROAD_DA, WALL_DA | Use the 2040 outputs | Figure.ipynb |
| 2.7 | Building energy in latitude | CNTL, ROOF_DA, IMPROAD_DA, WALL_DA, ROOF_IMPROAD_DA, ROOF_IMPROAD_WALL_DA | Use the 2040 outputs | Figure.ipynb |
| 2.8 | Building energy balance | CNTL, ROOF_DA, IMPROAD_DA, WALL_DA, ROOF_IMPROAD_DA, ROOF_IMPROAD_WALL_DA | Use Export.ipynb to get *.csv from 2015 to 2099 | Figure.ipynb |
The figures listed below are used to illustrate details of the transient urban albedo scheme in CLMU.
| Subject | Visualization |
|---|---|
| Urban representation and parameterization in CLMU | Figure |
| New module functionality | Figure |
| Comparing workflow between the default scheme and the new scheme | Figure |
| Reflectivity over urban surfaces | Figure |
| Reflectivity over urban landunits | Figure |
The scripts listed below are used to show supplementary information such as input data, atmosphere variables, and computational performance.
| Num. | Subject | Analysis | Visualization |
|---|---|---|---|
| 4.1 | Default input parameters in CLMU | Use Calculation.ipynb to calculate urban fraction and roof albedo | Figure.ipynb |
| 4.2 | Actual surface albedo | Compare actual surface albedo | Figure.ipynb |
| 4.3 | Regression | Use Export.ipynb to get the grid-cell level albedo and heat fluxes for Calculation.ipynb | NA |
| 4.4 | Urban surface heterogeneity in energy budget | Use Export.ipynb to get *.csv from 2015 to 2099 | Figure.ipynb |
| 4.5 | Yearly atmosphere variables | Use Export.ipynb to get the annual-mean outputs from 2015 to 2099 | Figure.ipynb |
| 4.6 | Computational performance | Compare timing log | Figure.ipynb |
- This work used the ARCHER2 UK National Supercomputing Service. The authors would like to acknowledge the assistance given by Research IT and the use of the HPC Pool and Computational Shared Facility at The University of Manchester.
- The support of Douglas Lowe and Christopher Grave from Research IT at The University of Manchester is gratefully acknowledged.
- Zhonghua Zheng appreciates the support provided by the academic start-up funds from the Department of Earth and Environmental Sciences at The University of Manchester.
- Yuan Sun is supported by the PhD studentship of Zhonghua Zheng's academic start-up funds.
- Contributions from Keith W Oleson are based upon work supported by the NSF National Center for Atmospheric Research, which is a major facility sponsored by the U.S. National Science Foundation under Cooperative Agreement No. 1852977.
- Lei Zhao acknowledges the support of the U.S. National Science Foundation (CAREER award Grant 2145362).
- The authors declare no conflict of interest.