Journal cover Journal topic
Geoscientific Model Development An interactive open-access journal of the European Geosciences Union
Journal topic

Journal metrics

Journal metrics

  • IF value: 4.252 IF 4.252
  • IF 5-year value: 4.890 IF 5-year
    4.890
  • CiteScore value: 4.49 CiteScore
    4.49
  • SNIP value: 1.539 SNIP 1.539
  • SJR value: 2.404 SJR 2.404
  • IPP value: 4.28 IPP 4.28
  • h5-index value: 40 h5-index 40
  • Scimago H <br class='hide-on-tablet hide-on-mobile'>index value: 51 Scimago H
    index 51
Discussion papers
https://doi.org/10.5194/gmd-2019-39
© Author(s) 2019. This work is distributed under
the Creative Commons Attribution 4.0 License.
https://doi.org/10.5194/gmd-2019-39
© Author(s) 2019. This work is distributed under
the Creative Commons Attribution 4.0 License.

Development and technical paper 21 Mar 2019

Development and technical paper | 21 Mar 2019

Review status
This discussion paper is a preprint. It is a manuscript under review for the journal Geoscientific Model Development (GMD).

A Python-enhanced urban land surface model SuPy (SUEWS in Python, v2019.2): development, deployment and demonstration

Ting Sun and Sue Grimmond Ting Sun and Sue Grimmond
  • Department of Meteorology, University of Reading, Reading, RG6 6BB, UK

Abstract. Accurate and agile modelling of the climate of cities is essential for urban climate services. The Surface Urban Energy and Water balance Scheme (SUEWS) is a state-of-the-art, widely used, urban land surface model (ULSM) which simulates urban-atmospheric interactions by quantifying the energy, water and mass fluxes. Using SUEWS as the computation kernel, SuPy (SUEWS in Python), stands on the Python-based data stack to streamline the pre-processing, computation and post-processing that are involved in the common modelling-centred urban climate studies. This paper documents the development of SuPy, which includes the SUEWS interface modification, F2PY (Fortran to Python) configuration and Python frontend implementation. In addition, the deployment of SuPy via PyPI (Python Package Index) is introduced along with the automated workflow for cross-platform compilation. This makes SuPy available for all mainstream operating systems (Windows, Linux, and macOS). Furthermore, three online tutorials in Jupyter notebooks are provided to users of different levels to become familiar with SuPy urban climate modelling. The SuPy package represents a significant enhancement that supports existing and new model applications, reproducibility, and enhanced functionality.

Ting Sun and Sue Grimmond
Interactive discussion
Status: open (until 16 May 2019)
Status: open (until 16 May 2019)
AC: Author comment | RC: Referee comment | SC: Short comment | EC: Editor comment
[Subscribe to comment alert] Printer-friendly Version - Printer-friendly version Supplement - Supplement
Ting Sun and Sue Grimmond
Model code and software

SuPy: 2019.2 Release T. Sun https://doi.org/10.5281/zenodo.2574405

Ting Sun and Sue Grimmond
Viewed  
Total article views: 244 (including HTML, PDF, and XML)
HTML PDF XML Total BibTeX EndNote
172 69 3 244 4 3
  • HTML: 172
  • PDF: 69
  • XML: 3
  • Total: 244
  • BibTeX: 4
  • EndNote: 3
Views and downloads (calculated since 21 Mar 2019)
Cumulative views and downloads (calculated since 21 Mar 2019)
Viewed (geographical distribution)  
Total article views: 155 (including HTML, PDF, and XML) Thereof 155 with geography defined and 0 with unknown origin.
Country # Views %
  • 1
1
 
 
 
 
Cited  
Saved  
No saved metrics found.
Discussed  
No discussed metrics found.
Latest update: 21 Apr 2019
Publications Copernicus
Download
Short summary
A Python-enhanced urban land surface model, SuPy (SUEWS in Python), is presented with its development (the SUEWS interface modification, F2PY configuration and Python frontend implementation), cross-platform deployment (PyPI, Python Package Index) and demonstration (online tutorials in Jupyter notebooks for users of different levels). SuPy represents a significant enhancement that supports existing and new model applications, reproducibility, and enhanced functionality.
A Python-enhanced urban land surface model, SuPy (SUEWS in Python), is presented with its...
Citation