diff --git a/paper/paper.bib b/paper/paper.bib index 124d3f7638..532cb2c6cf 100644 --- a/paper/paper.bib +++ b/paper/paper.bib @@ -5,13 +5,8 @@ @article{allen2020impacts volume={133}, pages={110030}, year={2020}, - publisher={Elsevier} -} -@misc{united20182018, - title={2018 revision of world urbanization prospects}, - author={United Nations}, - year={2018}, - publisher={United Nations New York} + publisher={Elsevier}, + url={https://doi.org/10.1016/j.rser.2020.110030} } @article{ching2009national, title={National urban database and access portal tool}, @@ -21,7 +16,8 @@ @article{ching2009national number={8}, pages={1157--1168}, year={2009}, - publisher={American Meteorological Society} + publisher={American Meteorological Society}, + url={https://doi.org/10.1175/2009BAMS2675.1} } @inproceedings{mills2015introduction, title={An Introduction to the WUDAPT project}, @@ -31,13 +27,14 @@ @inproceedings{mills2015introduction year={2015} } @article{ching2018wudapt, - title={{WUDAPT}: An urban weather, climate, and environmental modeling infrastructure for the anthropocene}, + title={WUDAPT: An urban weather, climate, and environmental modeling infrastructure for the anthropocene}, author={Ching, Jason and Mills, G and Bechtel, Benjamin and See, L and Feddema, J and Wang, X and Ren, C and Brousse, O and Martilli, A and Neophytou, M and others}, journal={Bulletin of the American Meteorological Society}, volume={99}, number={9}, pages={1907--1924}, - year={2018} + year={2018}, + url={https://doi.org/10.1175/BAMS-D-16-0236.1} } @article{bocher2021geoclimate, @@ -47,7 +44,8 @@ @article{bocher2021geoclimate volume={6}, number={65}, pages={3541}, - year={2021} + year={2021}, + url={https://doi.org/10.21105/joss.03541} } @inproceedings{DBLP:conf/vldb/KrawczykI22, diff --git a/paper/paper.md b/paper/paper.md index 4e582ca6d3..9941dda4d3 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -28,17 +28,17 @@ bibliography: paper.bib --- # Summary -The Neighborhood Adaptive Tissues for Urban Resilience Futures tool (NATURF) is a Python workflow that generates files readable by the Weather Research and Forecasting (WRF) model. NATURF uses *geopandas*[@kelsey_jordahl_2020_3946761} and *hamilton*[@DBLP:conf/vldb/KrawczykI22] to calculate 132 building parameters from shapefiles with building footprint and height information. These parameters can be collected and used in many formats, and the primary output is a binary file configured for input to WRF. This workflow is a flexible adaptation of the National/World Urban Database and Access Portal Tool (NUDAPT/WUDAPT)[@ching2009national][@mills2015introduction] that can be used with any study area at any spatial resolution. The climate modeling community and urban planners can identify the effects of building/neighborhood morphology on the microclimate using the urban parameters and WRF-readable files produced by NATURF. The source code for NATURF can be found on [Github](https://github.com/IMMM-SFA/naturf/tree/main), and more information on the urban parameters calculated can be found in the [documentation](https://immm-sfa.github.io/naturf/). +The Neighborhood Adaptive Tissues for Urban Resilience Futures tool (NATURF) is a Python workflow that generates files readable by the Weather Research and Forecasting (WRF) model. NATURF uses *geopandas* [@kelsey_jordahl_2020_3946761] and *hamilton* [@DBLP:conf/vldb/KrawczykI22] to calculate 132 building parameters from shapefiles with building footprint and height information. These parameters can be collected and used in many formats, and the primary output is a binary file configured for input to WRF. This workflow is a flexible adaptation of the National/World Urban Database and Access Portal Tool (NUDAPT/WUDAPT)[@ching2009national; @mills2015introduction] that can be used with any study area at any spatial resolution. The climate modeling community and urban planners can identify the effects of building/neighborhood morphology on the microclimate using the urban parameters and WRF-readable files produced by NATURF. The source code for NATURF can be found on [GitHub](https://github.com/IMMM-SFA/naturf/tree/main), and more information on the urban parameters calculated can be found in the [documentation](https://immm-sfa.github.io/naturf/). # Statement of Need -NATURF serves many audiences: (i) urban climate modelers wanting to understand building effects on the urban microclimate at a fine scale, (ii) urban planners creating new developments, (iii) sociologists aiming to understand weather-based inequalities and stresses. Allen-Dumas et al.[@allen2020impacts] used NATURF to demonstrate that simulated new developments in the Chicago Loop neighborhood affect temperature and energy use both in the new developments and the preexisting neighborhoods. Their findings show that building effects on the microclimate can be modeled at 90m resolution, and they quantify how different configurations of urban developments affect not only the developments themselves but also neighborhoods that already exist. Urban planners will be able to use NATURF in the same way as urban areas continue to grow. Likewise, NATURF will give climate modelers the tools to understand how urbanization will contribute to microclimate and broader global climate change, and sociologists could see how urban developments affect weather-related stresses. +NATURF serves many audiences: (i) urban climate modelers wanting to understand building effects on the urban microclimate at a fine scale, (ii) urban planners creating new developments, (iii) sociologists aiming to understand weather-based inequalities and stresses. NATURF was used to demonstrate that simulated new developments in the Chicago Loop neighborhood affect temperature and energy use both in the new developments and the preexisting neighborhoods [@allen2020impacts]. Their findings show that building effects on the microclimate can be modeled at 90m resolution, and they quantify how different configurations of urban developments affect not only the developments themselves but also neighborhoods that already exist. Urban planners will be able to use NATURF in the same way as urban areas continue to grow. Likewise, NATURF will give climate modelers the tools to understand how urbanization will contribute to microclimate and broader global climate change, and sociologists could see how urban developments affect weather-related stresses. -In relation to existing software, NATURF utilizes the same urban parameters and WRF pathways as NUDAPT and WUDAPT, but it does so at a higher spatial resolution for more detailed predictions. WUDAPT in particular seeks to gather consistent data on a worldwide scale[@ching2018wudapt] while NATURF works at a city- or neighborhood-scale. Put simply, NATURF allows the user to conduct studies at a high resolution at any location where building footprint and height data exist. +In relation to existing software, NATURF utilizes the same urban parameters and WRF pathways as NUDAPT and WUDAPT, but it does so at a higher spatial resolution for more detailed predictions. WUDAPT in particular seeks to gather consistent data on a worldwide scale [@ching2018wudapt] while NATURF works at a city- or neighborhood-scale. Put simply, NATURF allows the user to conduct studies at a high resolution at any location where building footprint and height data exist. -Similar to NATURF, the open-source toolbox GeoClimate[@bocher2021geoclimate] aims to quantify the effect of urban features for climate models. Both tools provide outputs similar to the three levels of data associated with WUDAPT: level 0 data (local climate zones), level 1 data (sampling data with finer resolution), and level 2 data (precise urban parameter data)[@ching2018wudapt]. GeoClimate produces level 0 and level 1 data, while NATURF provides level 2 data. Where NATURF uses building height and footprint data to calculate urban parameters, GeoClimate uses OpenStreetMap data. GeoClimate also calculate different parameters from NATURF and considers the influences of vegetation and roads on the microclimate. NATURF and GeoClimate measure the effect of urban features on microclimate, but they use different source data and output different data products to do so. +Similar to NATURF, the open-source toolbox GeoClimate [@bocher2021geoclimate] aims to quantify the effect of urban features for climate models. Both tools provide outputs similar to the three levels of data associated with WUDAPT: level 0 data (local climate zones), level 1 data (sampling data with finer resolution), and level 2 data (precise urban parameter data) [@ching2018wudapt]. GeoClimate produces level 0 and level 1 data, while NATURF provides level 2 data. Where NATURF uses building height and footprint data to calculate urban parameters, GeoClimate uses OpenStreetMap data. GeoClimate also calculate different parameters from NATURF and considers the influences of vegetation and roads on the microclimate. NATURF and GeoClimate measure the effect of urban features on microclimate, but they use different source data and output different data products to do so. # Design and Functionality -NATURF uses *hamilton* for organization and visualization of its workflow. Function names become inputs to other functions, allowing for a delineation of dependencies for every function. This code format allows for easier troubleshooting and visualization of the workflow. The calculation of parameters itself is done through *geopandas*. The input shapefile is loaded in as a GeoDataFrame that can handle calculation of parameters for each building in one process as opposed to using long "for" or "while" loops. Likewise, the geospatial features of *geopandas* are conducive to calculating the urban parameters for NATURF which are based on the geometry of each building and its neighbors. Figure 1 shows one of these parameters, mean building height at 100 meter resolution over Los Angeles County. +NATURF uses *hamilton* for organization and visualization of its workflow. Function names become inputs to other functions, allowing for a delineation of dependencies for every function. This code format allows for easier troubleshooting and visualization of the workflow. The calculation of parameters itself is done through *geopandas*. The input shapefile is loaded in as a GeoDataFrame that can handle calculation of parameters for each building in one process as opposed to using long "for" or "while" loops. Likewise, the geospatial features of *geopandas* are conducive to calculating the urban parameters for NATURF which are based on the geometry of each building and its neighbors. [Figure 1] shows one of these parameters, mean building height at 100 meter resolution over Los Angeles County. ![Average building height at 100 meter resolution for Los Angeles.](figure_1.png) @@ -47,4 +47,5 @@ This research was supported by the U.S. Department of Energy, Office of Science, Sponsored by the DOE Office of Science as a part of the research in Multi-Sector Dynamics within the Earth and Environmental System Modeling Program as part of the Integrated Multiscale Multisector Modeling (IM3) Scientific Focus Area. + # References