{"id":348416,"name":"MicroHH","description":"A computational fluid dynamics code designed to simulate turbulent flows in the atmosphere using the Direct Numerical Simulation and Large-Eddy Simulation techniques.","url":"https://github.com/microhh/microhh","last_synced_at":"2026-04-29T21:00:52.626Z","repository":{"id":12159741,"uuid":"14754940","full_name":"microhh/microhh","owner":"microhh","description":"Computational fluid dynamics code for simulation of turbulent flows in the atmospheric boundary layer","archived":false,"fork":false,"pushed_at":"2026-04-13T07:34:39.000Z","size":47158,"stargazers_count":156,"open_issues_count":47,"forks_count":68,"subscribers_count":9,"default_branch":"main","last_synced_at":"2026-04-13T13:02:45.761Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"microhh.org","language":"C++","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/microhh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2013-11-27T18:09:25.000Z","updated_at":"2026-04-01T09:34:08.000Z","dependencies_parsed_at":"2023-01-12T15:01:01.293Z","dependency_job_id":"074cedb0-f3ed-46ca-996b-1584764f19a0","html_url":"https://github.com/microhh/microhh","commit_stats":{"total_commits":5272,"total_committers":36,"mean_commits":"146.44444444444446","dds":0.3920713201820941,"last_synced_commit":"ffd9b9f64c673764079dbf7b223cf7ce64bf18ad"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/microhh/microhh","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microhh%2Fmicrohh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microhh%2Fmicrohh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microhh%2Fmicrohh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microhh%2Fmicrohh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microhh","download_url":"https://codeload.github.com/microhh/microhh/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microhh%2Fmicrohh/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31844329,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T13:28:40.153Z","status":"ssl_error","status_checked_at":"2026-04-15T13:28:29.396Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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"}},"owner":{"login":"microhh","name":"MicroHH","uuid":"6048730","kind":"organization","description":null,"email":null,"website":null,"location":null,"twitter":null,"company":null,"icon_url":"https://avatars.githubusercontent.com/u/6048730?v=4","repositories_count":7,"last_synced_at":"2023-08-06T10:39:13.892Z","metadata":{"has_sponsors_listing":false},"html_url":"https://github.com/microhh","funding_links":[],"total_stars":null,"followers":null,"following":null,"created_at":"2022-11-06T15:24:59.399Z","updated_at":"2023-08-06T10:39:13.932Z","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microhh","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microhh/repositories"},"packages":[],"commits":{"id":1439206,"full_name":"microhh/microhh","default_branch":"main","total_commits":5530,"total_committers":37,"total_bot_commits":0,"total_bot_committers":0,"mean_commits":149.45945945945945,"dds":0.41464737793851714,"past_year_total_commits":19,"past_year_total_committers":4,"past_year_total_bot_commits":0,"past_year_total_bot_committers":0,"past_year_mean_commits":4.75,"past_year_dds":0.21052631578947367,"last_synced_at":"2026-04-27T20:06:41.916Z","last_synced_commit":"736a2f5ef422b56c7a77a2a9d2b6e719bce16f37","created_at":"2023-10-26T11:59:24.277Z","updated_at":"2026-04-27T20:01:35.782Z","committers":[{"name":"Chiel van Heerwaarden","email":"chielvanheerwaarden@gmail.com","login":"Chiil","count":3237},{"name":"Bart van Stratum","email":"bart@vanstratum.com","login":"julietbravo","count":1626},{"name":"Thijs Heus","email":"6053388+thijsheus","login":"thijsheus","count":386},{"name":"Mirjam Tijhuis","email":"mirjam.tijhuis@wur.nl","login":"MirjamTijhuis","count":43},{"name":"Thijs Heus","email":"cls0160@owens-rw01.ten.osc.edu","login":null,"count":43},{"name":"stijn","email":"s.heldens@esciencecenter.nl","login":"stijnh","count":41},{"name":"Menno Veerman","email":"mveerman@int3.local.snellius.surf.nl","login":null,"count":18},{"name":"Ubuntu","email":"menno@euw-vm-mv-slocs-o.vshf4n5etsvunkaa3ghannegbh.ax.internal.cloudapp.net","login":null,"count":16},{"name":"Steven van der Linden","email":"s.j.a.vanderlinden@tudelft.nl","login":"StevenvdLinden","count":16},{"name":"Jeremy Gibbs","email":"jeremy.gibbs@utah.edu","login":"jeremygibbs","count":15},{"name":"Menno","email":"menno.veerman@wur.nl","login":"MennoVeerman","count":13},{"name":"Menno Veerman","email":"mveerman@int1.local.snellius.surf.nl","login":null,"count":11},{"name":"elynn","email":"elynn510@gmail.com","login":"elynnwu","count":10},{"name":"JacobHA","email":"jacobhadamczyk@gmail.com","login":"JacobHA","count":9},{"name":"Steven van der Linden","email":"Steven van der Linden","login":null,"count":8},{"name":"wouter","email":"wbmol@wur.nl","login":null,"count":5},{"name":"Bart van Stratum","email":"bart@Barts-MacBook-Pro.local","login":null,"count":4},{"name":"Mirjam Tijhuis","email":"mtijhuis@int4.local.snellius.surf.nl","login":null,"count":4},{"name":"Wouter","email":"wouterbmol@gmail.com","login":"WBMol","count":3},{"name":"Eckhard Dietze","email":"eckhard.dietze@mailbox.org","login":null,"count":3},{"name":"Bart van Stratum","email":"1067637+bartvstratum","login":"bartvstratum","count":2},{"name":"Ivan Bastak Duran","email":"bastakdu@iau.uni-frankfurt.de","login":"ivanbastak","count":2},{"name":"Bart van Stratum","email":"bstratum@gcn29.local.snellius.surf.nl","login":null,"count":1},{"name":"Bart van Stratum","email":"bstratum@int1.local.snellius.surf.nl","login":null,"count":1},{"name":"Bart van Stratum","email":"m300241@mlogin102.hpc.dkrz.de","login":null,"count":1},{"name":"Bart van Stratum","email":"m300241@mlogin103.hpc.dkrz.de","login":null,"count":1},{"name":"Bart van Stratum","email":"stratum2@int1.local.snellius.surf.nl","login":null,"count":1},{"name":"Girish Nigamanth Raghunathan","email":"girish@cumulus.csuohio.edu","login":null,"count":1},{"name":"Menno Veerman","email":"mveerman@gcn23.local.snellius.surf.nl","login":null,"count":1},{"name":"Menno Veerman","email":"mveerman@int2.local.snellius.surf.nl","login":null,"count":1},{"name":"Menno Veerman","email":"mveerman@int4.local.snellius.surf.nl","login":null,"count":1},{"name":"Menno Veerman","email":"mveerman@int5.local.snellius.surf.nl","login":null,"count":1},{"name":"Menno Veerman","email":"mveerman@int6.local.snellius.surf.nl","login":null,"count":1},{"name":"Mirjam Tijhuis","email":"tijhuism@int3.local.snellius.surf.nl","login":null,"count":1},{"name":"Thijs Heus","email":"heust1@cirrus-login2.ccs.ornl.gov","login":null,"count":1},{"name":"Ubuntu","email":"chiel@euw-vm-testvm.vshf4n5etsvunkaa3ghannegbh.ax.internal.cloudapp.net","login":null,"count":1},{"name":"Tris48","email":"Tris48","login":"Tris48","count":1}],"past_year_committers":[{"name":"Bart van Stratum","email":"bart@vanstratum.com","login":"julietbravo","count":15},{"name":"Mirjam Tijhuis","email":"mirjam.tijhuis@wur.nl","login":"MirjamTijhuis","count":2},{"name":"Bart van Stratum","email":"1067637+bartvstratum","login":"bartvstratum","count":1},{"name":"wouter","email":"wbmol@wur.nl","login":null,"count":1}],"commits_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories/microhh%2Fmicrohh/commits","host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-04-29T00:00:10.453Z","repositories_count":6223025,"commits_count":899891968,"contributors_count":34898093,"owners_count":1147504,"icon_url":"https://github.com/github.png","host_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories"}},"issues_stats":{"full_name":"microhh/microhh","html_url":"https://github.com/microhh/microhh","last_synced_at":"2026-04-29T21:00:39.258Z","status":"active","issues_count":48,"pull_requests_count":65,"avg_time_to_close_issue":29229619.95,"avg_time_to_close_pull_request":1069391.465116279,"issues_closed_count":20,"pull_requests_closed_count":43,"pull_request_authors_count":9,"issue_authors_count":8,"avg_comments_per_issue":0.7708333333333334,"avg_comments_per_pull_request":0.6153846153846154,"merged_pull_requests_count":41,"bot_issues_count":0,"bot_pull_requests_count":0,"past_year_issues_count":6,"past_year_pull_requests_count":3,"past_year_avg_time_to_close_issue":2078433.5,"past_year_avg_time_to_close_pull_request":null,"past_year_issues_closed_count":2,"past_year_pull_requests_closed_count":0,"past_year_pull_request_authors_count":2,"past_year_issue_authors_count":2,"past_year_avg_comments_per_issue":1.6666666666666667,"past_year_avg_comments_per_pull_request":0.3333333333333333,"past_year_bot_issues_count":0,"past_year_bot_pull_requests_count":0,"past_year_merged_pull_requests_count":0,"created_at":"2025-08-29T20:24:38.809Z","updated_at":"2026-04-29T21:00:39.258Z","repository_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/microhh%2Fmicrohh","issues_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/microhh%2Fmicrohh/issues","issue_labels_count":{"enhancement":19,"bug":15,"discussion":4},"pull_request_labels_count":{"enhancement":16,"bug":8},"issue_author_associations_count":{"MEMBER":43,"NONE":5},"pull_request_author_associations_count":{"MEMBER":55,"CONTRIBUTOR":8,"OWNER":1,"NONE":1},"issue_authors":{"julietbravo":26,"bartvstratum":13,"Chiil":3,"llsalazar":2,"Kairzhan":1,"SarahWarnau":1,"tzhang-ccs":1,"thijsheus":1},"pull_request_authors":{"julietbravo":19,"bartvstratum":17,"Chiil":12,"thijsheus":7,"MennoVeerman":4,"WBMol":2,"MirjamTijhuis":2,"Tris48":1,"SofienBenKtib":1},"host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-04-29T00:00:10.439Z","repositories_count":14445349,"issues_count":34175535,"pull_requests_count":112225290,"authors_count":11248883,"icon_url":"https://github.com/github.png","host_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories","owners_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/owners","authors_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors"},"past_year_issue_labels_count":{"enhancement":3,"bug":1},"past_year_pull_request_labels_count":{"enhancement":2},"past_year_issue_author_associations_count":{"MEMBER":4,"NONE":2},"past_year_pull_request_author_associations_count":{"MEMBER":2,"CONTRIBUTOR":1},"past_year_issue_authors":{"bartvstratum":4,"llsalazar":2},"past_year_pull_request_authors":{"bartvstratum":2,"MennoVeerman":1},"maintainers":[{"login":"julietbravo","count":45,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/julietbravo"},{"login":"bartvstratum","count":30,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/bartvstratum"},{"login":"Chiil","count":15,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/Chiil"},{"login":"thijsheus","count":8,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/thijsheus"},{"login":"SofienBenKtib","count":1,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/SofienBenKtib"}],"active_maintainers":[{"login":"bartvstratum","count":6,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/bartvstratum"}]},"events":{"total":{"DeleteEvent":2,"PullRequestEvent":54,"ForkEvent":5,"IssuesEvent":43,"WatchEvent":26,"IssueCommentEvent":91,"PushEvent":45,"PullRequestReviewEvent":2,"PullRequestReviewCommentEvent":2,"CreateEvent":6},"last_year":{"DeleteEvent":2,"PullRequestEvent":4,"ForkEvent":3,"IssuesEvent":16,"WatchEvent":14,"IssueCommentEvent":27,"PushEvent":19,"CreateEvent":5}},"keywords":[],"dependencies":[],"score":8.924123891686012,"created_at":"2026-03-14T11:38:30.957Z","updated_at":"2026-04-29T21:00:52.627Z","avatar_url":"https://github.com/microhh.png","language":"C++","category":"Atmosphere","sub_category":"Atmospheric Composition and Dynamics","monthly_downloads":0,"total_dependent_repos":0,"total_dependent_packages":0,"readme":"MicroHH\n-------\n\n[![CI Status](https://github.com/microhh/microhh/actions/workflows/develop.yml/badge.svg)](https://github.com/microhh/microhh/actions/)\n[![Documentation Status](https://readthedocs.org/projects/microhh/badge/?version=latest)](https://microhh.readthedocs.io/en/latest/?badge=latest)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.13923894.svg)](https://doi.org/10.5281/zenodo.13923894)\n\nMicroHH is a computational fluid dynamics code designed to simulate turbulent flows in the atmosphere using the Direct Numerical Simulation (DNS) and Large-Eddy Simulation (LES) techniques. Its can do idealized flows, but also realistic atmospheric boundary layers with all relevant processes, including moist thermodynamics, radiation, land surface processes, and microphysics. MicroHH is written in C++/CUDA and runs on both CPUs and GPUs using single or double precision floating point numbers.\n\nA tutorial and documentation is available at: https://microhh.readthedocs.io/en/latest/.\n\nVisualizations are found in our Vimeo channel: https://vimeo.com/channels/microhh.\n\nMicroHH is described in detail in [Van Heerwaarden et al. (2017)](https://doi.org/10.5194/gmd-10-3145-2017). In case you decide to use MicroHH for your own research, the developers would appreciate to be notified and kindly request to cite their reference paper. The version described in the reference paper has been assigned a DOI via [Zenodo](https://zenodo.org).\n\n\nRequirements\n------------\nIn order to compile MicroHH you need:\n* C++ compiler\n* FFTW3 libraries\n* Boost libraries\n* NetCDF4\n* CMake\n* MPI2/3 implementation (optional for MPI support)\n* CUDA (optional for GPU support)\n* Python + numpy + python-netcdf4 (optional for running example cases)\n* Ipython + python-netcdf4 + matplotlib (optional for plotting results example cases)\n\n\nDownloading the code\n--------------------\nMicroHH includes Git submodules, so it is essential to ensure these are downloaded properly when cloning the code. Check out the code with all submodules included using:\n\n    git clone --recurse-submodules https://github.com/microhh/microhh.git\n\nIf you get compilation errors related to missing RTE+RRTMGP source files, you probably forgot the `--recurse-submodules` flag. You can correct that with:\n\n    git submodule update --init --recursive\n\nCompilation of the code\n-----------------------\nFirst, enter the config directory: \n\n    cd config\n\nHere, you find a potential series of settings with the extension `.cmake` for different systems. Check whether your system is there. If not, you can try the generic configuration (`generic.cmake`), or create a file with the correct compiler settings and the proper location for all libraries on your system. Then, copy your system file to default.cmake, for example:\n\n    cp generic.cmake default.cmake\n\nThen, go back to the main directory and create a subdirectory with an arbitrary name in which you will compile the code. Let us assume this directory is called \"build\":\n\n    cd ..  \n    mkdir build  \n    cd build   \n\nFrom this directory, run cmake with the suffix .. to point to the parent directory where the CMakeLists.txt is found. This builds the model without Message Passing Interface (MPI) and CUDA support, using double precision floating point numbers.\n\n    cmake ..\n\nIn case you prefer to enable either MPI, CUDA, or single precision (4 byte) floating point numbers, run `cmake` with the following flags:\n    \n    cmake .. -DUSEMPI=TRUE\n\nor\n\n    cmake .. -DUSECUDA=TRUE\n\nor \n\n    cmake .. -DUSESP=TRUE\n\nSome combinations are possible, such as:\n\n    cmake .. -DUSEMPI=TRUE -DUSESP=TRUE\n\nHowever, the combination of `-DUSEMPI` with `-DUSECUDA` is not (yet) supported.\n\nNOTE: once the build has been configured and you wish to change the `USECUDA`, `USEMPI`, or `USESP` setting, you must delete the content of the build directory, or create an additional empty directory from which `cmake` is run.)\n\nWith the previous command you have triggered the build system and created the make files, if the `default.cmake` file contains the correct settings. Now, you can start the compilation of the code and create the `microhh` executable with:\n\n    make -j 2\n\nYour directory should contain a file named `microhh` now. This is the main executable.\n\n\nRunning an example case\n-----------------------\nTo start one of the included test cases, go back to the main directory and  open the directory `cases`. Here, a collection of test cases has been included. In this example, we start the `drycblles` case, a simple large-eddy simulation of a dry convective boundary layer.\n\n    cd cases/drycblles\n\nFirst, we have to create the vertical profiles for our prognostic variables:\n\n    python drycblles_input.py\n\nThen, we have to copy or link the `microhh` executable to the current directory. Here we assume the executable is in the build directory that we have created before.\n\n    cp ../../build/microhh .\n\nNow, we can start `microhh` in initialization mode to create the initial fields:\n\n    ./microhh init drycblles\n\nIf everything works out properly, a series of files has been created. The model can be started now following:\n\n    ./microhh run drycblles\n\nThis will take some time. Now, a statistics file called `drycblles.default.0000000.nc` has been created. You can open this file with your favorite plotting tool, or run some example plots using the provided plotting script that uses Python and matplotlib. This is most easily done in interactive python:\n\n    ipython  \n    run drycbllesstats\n\nThis should show you a set of basic plots. Congratulations, you have just completed your first run of MicroHH.\n\nHappy MicroHHing!\n\nContributing\n------------\n\nIf you are planning to contribute code to MicroHH, first of all: thanks! But please consider a few things:\n- For eventual merging of contributions into the main code, we use the [pull request](https://github.com/microhh/microhh/pulls) feature of Github. For this, [you need to make of fork](https://github.com/microhh/microhh/fork) of the MicroHH repository in your own Github account, and commit the changes there, before creating a pull request.\n- If you plan to make major changes to the code or code structure, it might be wise to discuss them with the main MicroHH devs, for example by [opening an issue on Github](https://github.com/microhh/microhh/issues).\n- We like to keep our code structured and clean, so please stick to the [MicroHH coding conventions](https://github.com/microhh/microhh/blob/main/doc/coding_conventions.cxx).\n- Be careful with what you add and commit to Git. Accidentally adding/committing some large binaries or MicroHH executables is an easy mistake, but even if you later remove the files in a new commit, the files will stay in the history of the repository, making the repository unnecessary bloaty.\n \nCurrent and previous contributors to MicroHH can be found [here](CONTRIBUTORS.md)\n","funding_links":[],"readme_doi_urls":["https://doi.org/10.5281/zenodo.13923894","https://doi.org/10.5194/gmd-10-3145-2017"],"works":{},"citation_counts":{},"total_citations":0,"keywords_from_contributors":["radiative-transfer","climate-model"],"project_url":"https://ost.ecosyste.ms/api/v1/projects/348416","html_url":"https://ost.ecosyste.ms/projects/348416"}