Novel parameterisation of building storage heat flux for urban climate modelling

This repository contains the data and scripts used to develop dyOHM and its application in neighbourhood-scale modelling by SUEWS.

The repository is organised into five main folders:

• EPW
  Weather input files used for clustering and run energyplus.

• EnergyPlusResult
  EnergyPlus-derived simulation outputs (Q* and QS) used to fit and parameterise OHM coefficients.

• Observation
  Observational data used to evaluate the parameterised OHM coefficients (e.g. energy balance heat fluxes, wind speed and air temperature) and storage heat flux (e.g. surface temperature).

• Data
  Processed intermediate datasets generated by the scripts, including clustering results, fitted coefficients, and summary tables.

• Figure
  Figures produced by the scripts.

• Script
  Python scripts for the full workflow, including weather clustering, OHM fitting, coefficient parameterisation, observational evaluation, and SUEWS application.

Suggested workflow

The scripts are intended to be run step by step in the Script folder.

A typical workflow is:

1. Run the weather clustering script (weather_clustering.py) using the EPW files in EPW folder. 

2. Run the OHM fitting script (EnergyPlus_OHM_fitting.py) using the clustering results and EnergyPlus outputs in EnergyPlusResult folder.

3. Run the coefficient parameterisation script (a1_a2_a3_parameterisation.py) to derive equations for a1, a2 and a3.

4. Run the observational evaluation (Verification.py) script using the observation data in Observation folder.

5. Run the SUEWS evaluation script (Run_SUEWS.py) to run SUEWS and evaluate the impacts of different building materials.

Intermediate outputs are written to the data folder, and figures are written to the Figure folder.