Skip to content

uDALES

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. It resolves buildings with a conservative immersed boundary method, includes a full urban surface energy balance with radiation, vegetation, and moisture, and scales to large domains on HPC systems. See the model overview for what uDALES can do.
uDALES Temperature uDALES Momentum uDALES Vertical Velocity

  • Installation

    Build uDALES on Linux, macOS, WSL, or HPC clusters.

    Installation and first run

  • Workflow overview

    The end-to-end simulation workflow: set up, pre-process, run, and post-process.

    Workflow overview

  • Simulation inputs

    Configure your simulation via the namoptions input parameters and generate urban geometries.

    Input parameters

  • Example simulations

    Ready-to-run example cases, from neutral flow over cubes to full urban energy balance setups.

    Example simulations

  • Post-processing tutorials

    Load and analyse uDALES output with the udbase class: fields, statistics, and facet data.

    Tutorials

  • Python package

    The next-generation pre- and post-processing toolchain, currently under active testing.

    Python package

Citing uDALES

When using uDALES or data generated by uDALES, please cite the model papers — see How to cite. A list of publications using uDALES is available in the publication list.

Contributing

uDALES is developed openly on GitHub. See the developer documentation and contribution guide to get involved.