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: EPWWeather input files used for clustering and run energyplus. EnergyPlusResultEnergyPlus-derived simulation outputs (Q* and QS) used to fit and parameterise OHM coefficients. ObservationObservational 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). DataProcessed intermediate datasets generated by the scripts, including clustering results, fitted coefficients, and summary tables. FigureFigures produced by the scripts. ScriptPython 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: Run the weather clustering script (weather_clustering.py) using the EPW files in EPW folder. Run the OHM fitting script (EnergyPlus_OHM_fitting.py) using the clustering results and EnergyPlus outputs in EnergyPlusResult folder. Run the coefficient parameterisation script (a1_a2_a3_parameterisation.py) to derive equations for a1, a2 and a3. Run the observational evaluation (Verification.py) script using the observation data in Observation folder. 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.本仓库包含开发dyOHM模型，以及将其应用于SUEWS开展街区尺度建模所需的数据与脚本文件。 本仓库共分为5个主文件夹： EPW文件夹：用于聚类及EnergyPlus运行的气象输入文件。 EnergyPlus结果文件夹：用于拟合与参数化OHM系数的EnergyPlus衍生模拟输出结果（含Q*与QS）。 观测数据文件夹：用于评估参数化后的OHM系数的观测数据集（涵盖能量平衡热通量、风速与气温等），以及储热通量相关数据（例如地表温度）。 数据文件夹：存放脚本生成的预处理中间数据集，包含聚类结果、拟合系数与汇总表格。 图表文件夹：存放脚本生成的可视化图表。 脚本文件夹：包含完整工作流所需的Python脚本，涵盖气象聚类、OHM拟合、系数参数化、观测评估及SUEWS应用等模块。 推荐工作流 所有脚本需在脚本文件夹内按顺序逐步运行。典型工作流如下： 1. 使用EPW文件夹内的EPW文件运行气象聚类脚本（weather_clustering.py）。 2. 基于EnergyPlus结果文件夹内的聚类结果与EnergyPlus输出文件，运行OHM拟合脚本（EnergyPlus_OHM_fitting.py）。 3. 运行系数参数化脚本（a1_a2_a3_parameterisation.py），以推导a1、a2与a3的计算公式。 4. 使用观测数据文件夹内的观测数据集，运行观测评估脚本（Verification.py）。 5. 运行SUEWS评估脚本（Run_SUEWS.py），以执行SUEWS模拟并评估不同建筑材料的影响。 中间输出结果将写入数据文件夹，生成的图表将保存至图表文件夹。