{"id":13408808,"url":"https://github.com/uDALES/u-dales","last_synced_at":"2025-03-14T13:32:01.041Z","repository":{"id":43463910,"uuid":"194829003","full_name":"uDALES/u-dales","owner":"uDALES","description":"uDALES: large-eddy-simulation software for urban flow, dispersion and microclimate modelling","archived":false,"fork":false,"pushed_at":"2025-02-26T18:44:39.000Z","size":119008,"stargazers_count":64,"open_issues_count":26,"forks_count":19,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-08T11:14:07.224Z","etag":null,"topics":["cfd","computational-fluid-dynamics","large-eddy-simulation","urban-climate"],"latest_commit_sha":null,"homepage":"https://udales.github.io/u-dales","language":"Fortran","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/uDALES.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-07-02T09:09:13.000Z","updated_at":"2025-02-28T12:20:55.000Z","dependencies_parsed_at":"2023-12-18T15:55:25.387Z","dependency_job_id":"930fe3bc-fa03-4a49-a4d0-2e6a56602ed2","html_url":"https://github.com/uDALES/u-dales","commit_stats":{"total_commits":978,"total_committers":22,"mean_commits":44.45454545454545,"dds":0.6114519427402862,"last_synced_commit":"4ee74f03d9d89e5063cba99f7bd1fe5c83514b9c"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uDALES%2Fu-dales","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uDALES%2Fu-dales/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uDALES%2Fu-dales/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uDALES%2Fu-dales/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/uDALES","download_url":"https://codeload.github.com/uDALES/u-dales/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243584446,"owners_count":20314763,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cfd","computational-fluid-dynamics","large-eddy-simulation","urban-climate"],"created_at":"2024-07-30T20:00:55.401Z","updated_at":"2025-03-14T13:32:01.005Z","avatar_url":"https://github.com/uDALES.png","language":"Fortran","funding_links":[],"categories":["Climate Change","Computational Fluid Dynamics"],"sub_categories":["Earth and Climate Modeling","Building Energy and Urban Environments"],"readme":"# uDALES [![CI](https://github.com/uDALES/u-dales/workflows/CI/badge.svg)](https://github.com/uDALES/u-dales/actions)\n\nThis is the development repository for the uDALES (urban Dutch Atmospheric Large Eddy Simulation) model. It contains the uDALES software source-code, tests, documentation, and examples with tools to pre- and post-process inputs and outputs.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"docs/assets/images/fielddump_slice_2D.102.png\" alt=\"uDALES\" height=\"256\"\u003e\n\u003cimg src=\"docs/assets/images/fielddump_slice_3D.102.png\" alt=\"uDALES\" height=\"256\"\u003e \n\u003c/div\u003e\n\n---\n\n- [Overview](#overview)\n- [Publications and validation](#publications-and-validation)\n- [Documentation](#documentation)\n- [How to cite](#how-to-cite)\n- [Contributing](#contributing)\n- [Copyright and license](#copyright-and-license)\n- [Acknowledgements](#acknowledgements)\n- [References](#references)\n\n## Overview\n\nWith continuing urbanization, challenges associated with the urban environment such as air quality, heat islands, pedestrian thermal comfort, and wind loads on tall buildings, are increasingly relevant. Our ability to realistically capture processes such as the transport of heat, moisture, momentum and pollutants, and those of radiative transfer in urban environments is key to understanding and facing these challenges (Oke et al., 2017).\n\nThe turbulent nature of the urban flow field and the inherent heterogeneity and wide range of scales associated with the urban environment result in a complex modelling problem. uDALES is a large-eddy simulation (LES) model for urban environments. LES is an approach to turbulence modelling used in computational fluid dynamics to simulate turbulent flows over a wide range of spatial and temporal scales. LES is one of the most promising tools to model the interactions typical of urban areas due to its ability to resolve the urban flow field at resolutions of _O_(1 m, 0.1 s), over spatial domains of _O_(100 m), and time periods of _O_(10 h). Although there are many scalable LES models for atmospheric flows, to our knowledge, only few are capable of explicitly representing buildings and of modelling the full range of urban processes (e.g. PALM-4U; Resler et al. 2017; Maronga et al. 2020; or OpenFoam; Weller et al. 1998).\n\nuDALES is capable of modelling urban environments at the microclimate scale including wet thermodynamics, idealized and complex morphologies, three-dimensional urban surface energy balance and urban air quality (emission, dispersion and reaction).\n\n## Publications and validation\n\nTo-date, uDALES has been used to study a number of research questions:\n\n| Research application                                         | Reference                                                                       |\n| ------------------------------------------------------------ | ------------------------------------------------------------------------------- |\n| Urban boundary layers/ boundary-layer meteorology            | Grylls et al. (2019); Sützl et al. (2021); Sützl (2021)                                      |\n| Urban climate (radiation, green roofs and walls, trees etc.) | Suter (2018); Suter et al. (2021); Grylls \u0026 van Reeuwijk (2021)                 |\n| Pollution dispersion/ urban air quality                      | Grylls et al. (2019);  Grylls (2020)                                            |\n| Buoyancy/ convective and stable conditions                   | Suter (2018); Grylls et al. (2020); Grylls (2020); Grylls \u0026 van Reeuwijk (2021) |\n\nuDALES has been validated against both field and experimental studies and evaluated against other numerical models. The dynamic core, [DALES](https://github.com/dalesteam/dales), has been used to study atmospheric processes for over 30 years, being validated extensively in the process and used in several atmospheric intercomparison studies (Heus et al. 2010). The immersed boundary method, which is used to model obstacles in the fluid domain, was implemented into DALES and validated by Pourquie et al. (2009) and Tomas et al. (2015). The wall functions and three-dimensional surface energy balance model was validated by Suter (2018). The ability to model pollutuon dispersion in both idealised and realistic morphologies was been validated by Grylls et al. (2019) and Grylls (2020).\n\nSee the corresponding Journal of Open Source Software paper here:\n\n[![DOI](https://joss.theoj.org/papers/10.21105/joss.03055/status.svg)](https://doi.org/10.21105/joss.03055)\n\n## Documentation\n\n**If you are new to uDALES, please follow our [getting started guide](https://udales.github.io/u-dales/udales-getting-started).** For User's guides and general reference documentation, please see the [uDALES website](https://udales.github.io/u-dales/).\n\nIf you are a developer, please also refer to the [development notes](DEVELOP.md).\n\n## How to cite\n\nWhen using the uDALES please cite as:\n\n\u003e Grylls, T., Suter, I., Sützl, B., Owens, S., Meyer, D., \u0026 van Reeuwijk, M. (2021). uDALES: large-eddy-simulation software for urban flow, dispersion, and microclimate modelling. Journal of Open Source Software, 6(63), 3055, https://doi.org/10.21105/joss.03055\n\n\n```bibtex\n@article{Grylls2021,\n  doi = {10.21105/joss.03055},\n  url = {https://doi.org/10.21105/joss.03055},\n  year = {2021},\n  publisher = {The Open Journal},\n  volume = {6},\n  number = {63},\n  pages = {3055},\n  author = {Tom Grylls and Ivo Suter and Birgit S. Sützl and Sam Owens and David Meyer and Maarten van Reeuwijk},\n  title = {uDALES: large-eddy-simulation software for urban flow, dispersion, and microclimate modelling},\n  journal = {Journal of Open Source Software}\n}\n```\n\nIf you are looking to also cite a specific version of the software, you can find correposding version-specific DOIs on [Zenodo](https://doi.org/10.5281/zenodo.5111496).\n\n## Contributing\n\nIf you are looking to contribute, please read our [Contributors' guide](CONTRIBUTING.md) for details.\n\n## Copyright and license\n\nGeneral DALES copyright applies for any files part of the original DALES distribution and are marked as such at the beginning of each file.\n\nAdditional files provided in uDALES are copyrighted \"the uDALES Team\" and are marked as such at the beginning of each file.\n\nAll files are licensed under the GNU General Public License. See [LICENSE.txt](LICENSE.txt).\n\n## Acknowledgements\n\nThe dynamic core of uDALES derives from the Dutch Atmospheric Large-Eddy Simulation ([DALES](https://github.com/dalesteam/dales)) model. We would like to acknowledge the work of the contributors to DALES over the years (Heus et al. 2010) and specifically the work of J. Tomas, M. Pourquie and H. Jonker in implementing the immersed boundary method into DALES.\n\n## References\n\nHeus, T., van Heerwaarden, C. C., Jonker, H. J. J., Siebesma, A. P., Axelsen, S., van den Dries, K., Geoffroy, O., Moene, A. F., Pino, D., Roode, S. R. de, \u0026 de Arellano, J. V.-G. (2010). Formulation of the dutch atmospheric large-eddy simulation (DALES) and overview of its applications. Geoscientific Model Development, 3(2), 415–444. https://doi.org/10.5194/gmd-3-415-2010\n\nGrylls, T., Cornec, C. M. A. L., Salizzoni, P., Soulhac, L., Stettler, M. E. J., \u0026 van Reeuwijk, M. (2019). Evaluation of an operational air quality model using large-eddy simulation. Atmospheric Environment: X, 3, 100041. https://doi.org/10.1016/j.aeaoa.2019.100041\n\nGrylls, T. (2020). Simulating air pollution in the urban microclimate, Imperial College London, PhD thesis.\n\nGrylls, T., Suter, I., \u0026 van Reeuwijk, M. (2020). Steady-state large-eddy simulations of convective and stable urban boundary layers. Boundary-Layer Meteorology, 175(3), 309-341. https://doi.org/10.1007/s10546-020-00508-x\n\nGrylls, T., \u0026 van Reeuwijk, M. (2021). Tree model with drag, transpiration, shading and deposition: Identification of cooling regimes and large-eddy simulation. Agricultural and Forest Meteorology, 298-299, 108288. https://doi.org/https://doi.org/10.1016/j.agrformet.2020.108288\n\nMaronga, B., Banzhaf, S., Burmeister, C., Esch, T., Forkel, R., Fröhlich, D., Fuka, V., Gehrke, K. F., Geletič, J., Giersch, S., Gronemeier, T., Groß, G., Heldens, W., Hellsten, A., Hoffmann, F., Inagaki, A., Kadasch, E., Kanani-Sühring, F., Ketelsen, K., Raasch, S. (2020). Overview of the PALM model system 6.0. Geoscientific Model Development, 13(3), 1335–1372. https://doi.org/10.5194/gmd-13-1335-2020\n\nOke, T. R., Mills, G., Christen, A., \u0026 Voogt, J. A. (2017). Urban climates. Cambridge University Press. https://doi.org/10.1017/9781139016476\n\nPourquie, M. B. J. M., Breugem, W. P., \u0026 Boersma, B. J. (2009). Some issues related to the use of immersed boundary methods to represent square obstacles. International Journal for Multiscale Computational Engineering, 7(6). https://doi.org/10.1615/IntJMultCompEng.v7.i6.30\n\nResler, J., Krč, P., Belda, M., Juruš, P., Benešová, N., Lopata, J., Vlček, O., Damašková, D., Eben, K., Derbek, P., Maronga, B., \u0026 Kanani-Sühring, F. (2017). PALM-USM v1.0: A new urban surface model integrated into the PALM large120 eddy simulation model. Geoscientific Model Development, 10(10), 3635–3659. https://doi.org/10.5194/gmd-10-3635-2017\n\nSuter, I. (2018). Simulating the impact of blue-green infrastructure on the microclimate of urban areas. Imperial College London, PhD thesis. https://doi.org/10.25560/78715\n\nSuter, I., Grylls, T., Sützl, B. S., \u0026 van Reeuwijk, M. (2021). uDALES 1.0.0: A large-eddy simulation model for urban environments. In Geoscientific Model Development. Copernicus GmbH.\n\nSützl, B. S. (2021). Rising from the ground: Distributed drag parameterization of urban environments for numerical weather prediction. Imperial College London, PhD thesis.\n\nSützl, B. S., Rooney, G. G., \u0026 van Reeuwijk, M. (2021). Drag distribution in idealized heterogeneous urban environments. Boundary-Layer Meteorology, 178, 225-248. https://doi.org/10.1007/s10546-020-00567-0\n\nTomas, J. M., Pourquie, M. J. B. M., \u0026 Jonker, H. J. J. (2015). The influence of an obstacle on flow and pollutant dispersion in neutral and stable boundary layers. Atmospheric Environment, 113, 236–246. https://doi.org/10.1016/j.atmosenv.2015.05.016\n\nWeller, H. G., Tabor, G., Jasak, H., \u0026 Fureby, C. (1998). A tensorial approach to computational continuum mechanics using object-oriented techniques. Computers in Physics, 12(6), 620. https://doi.org/10.1063/1.168744\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FuDALES%2Fu-dales","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FuDALES%2Fu-dales","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FuDALES%2Fu-dales/lists"}