Urban environments are of increasing importance in climate and air quality research due to their central role in the population's health and well-being. Tools to model the local environmental conditions, urban morphology and interaction with the atmospheric boundary layer play an important role for sustainable urban planning and policy making. uDALES is a high-resolution, building-resolving, large-eddy simulation code for urban microclimate and air quality. uDALES solves a surface energy balance for each urban facet and models multi-reflection shortwave radiation, longwave radiation, heat storage and conductance, as well as turbulent latent and sensible heat fluxes. Vegetated surfaces and their effect on outdoor temperatures and energy demand can be studied. Furthermore, a scheme to simulate emissions and transport of passive and reactive gas species is present. The energy balance has been tested against idealised cases and the dispersion against wind tunnel experiments of the Dispersion of Air Pollution and its Penetration into the Local Environment (DAPPLE) field study, yielding satisfying results. uDALES can be used to study the effect of new buildings and other changes to the urban landscape on the local flow and microclimate and to gain fundamental insight into the effect of urban morphology on local climate, ventilation and dispersion. uDALES is available online under the GNU General Public License and remains under active maintenance and development.
UDALES is an open-source multi-physics microscale urban modelling tool, capable of performing large-eddy simulation (LES) of urban airflow, heat transfer, and pollutant dispersion. We present uDALES v2.0, which has two main new features: (1) an improved parallelisation that prepares the codebase for conducting exascale simulations and (2) a conservative immersed boundary method (IBM) suitable for an urban surface that does not need to be aligned with the underlying Cartesian grid. The urban geometry and local topography are incorporated via a triangulated surface with a resolution that is independent of the fluid grid. The IBM developed here includes the use of wall functions to apply surface fluxes, and the exchange of heat and moisture between the surface and the air is conservative by construction. We perform a number of validation simulations, ranging from neutral, coupled internal–external flows and non-neutral cases. We observe close agreement with the relevant literature, both in cases in which the buildings are aligned with the Cartesian grid and when they are at an angle. We introduce a validation case specifically for urban applications, for which we show that supporting non-grid-aligned geometries is crucial when solving surface energy balances, with errors of up to 20 % associated with using a grid-aligned geometry.
UDALES is an open-source multi-physics microscale urban modelling framework, capable of performing large-eddy simulation (LES) of urban airflow, heat transfer, and pollutant dispersion. We present uDALES v2.0, which has two main new features: 1) an improved parallelisation that prepares the codebase for conducting exascale simulations; and 2) a conservative immersed boundary method (IBM) suitable for an urban surface that does not need to be aligned with the underlying Cartesian grid. The urban geometry and local topography are incorporated via a triangulated surface with a resolution that is independent of the fluid grid. The IBM developed here includes the use of wall functions to apply surface fluxes, and the exchange of heat and moisture between the surface and the air is conservative by construction. We perform a number of validation simulations, ranging from neutral, coupled internal-external flows and non-neutral cases. Good agreement is observed, both in cases in which the buildings are aligned with the Cartesian grid and when they are at an angle. We introduce a validation case specifically for urban applications, for which we show that supporting non grid-aligned geometries is crucial when solving surface energy balances, with errors of up to 20 % associated with using a previous version of uDALES.
UDALES is an open-source, multi-physics microclimate modelling framework specifically developed for studying outdoor urban environments. It performs the large-eddy simulation (LES) of airflow while accounting for the heat transfer (sensible and latent), moisture, and pollutant dispersion within the urban atmospheric boundary layer at microscale resolution. The framework employs a novel conservative immersed boundary method (IBM) to resolve complex urban geometries, represented via a triangulated surface with a resolution independent of the Cartesian computational grid. This offers greater flexibility and accuracy in representing realistic urban structures. The interaction between the urban surfaces and the surrounding airflow is incorporated in the IBM using wall functions for surface shear stresses and heat fluxes. The latter are two-way coupled with a surface energy balance model that takes into account net short and long-wave radiation and ground heat conduction, with the capability to accommodate both man-made and vegetative materials. uDALES is also capable of modelling the drag introduced by trees in urban areas and their influence on modifying the local wind flow and pollutant dispersion. Recent advancements in uDALES have enabled two-dimensional domain decomposition via the 2DECOMP&FFT library, facilitating efficient parallelization and optimized use of supercomputing resources such as ARCHER2, thereby preparing for exascale computing. Several validation exercises have been conducted on idealized cases, including neutral flow over staggered urban-like structures, flow over a single tree and over tree arrays, cross-ventilation of an isolated building, and non-neutral flow over a single cube that is misaligned with the computational grid. The results demonstrate strong agreement with experimental and numerical benchmarks, highlighting the code’s accuracy and efficiency. With its enhanced functionality, uDALES (https://github.com/uDALES/u-dales) is a robust tool for high-resolution LES studies of urban environments, supporting advanced research in urban atmospheric and environmental sciences.