| FazBrowse GitHub Viewer | Trending | | Home |
| Tools: [Download Repo ZIP] [Original HTTPS Page] |
| Name | Name | Last commit date | ||
|---|---|---|---|---|
2025 Gordon Bell Prize Finalist - MFC simulates compressible multi-phase flows at exascale, using Fypp metaprogramming in ~40K lines of Fortran. It conducted the largest known public CFD simulation at 200 trillion grid points and 1 quadrillion degrees of freedom, scaling ideally to >43K AMD APUs on El Capitan and >33K AMD GPUs on Frontier.
If MFC is useful to your work, please ⭐ star the repo and cite it!
| Path | Command |
|---|---|
| Codespaces (fastest) 💨 | Open a Codespace - pre-built, zero install |
| Docker 🐳 | docker run -it --rm --entrypoint bash sbryngelson/mfc:latest-cpu |
| Homebrew (macOS) 🍺 | brew install mflowcode/mfc/mfc |
| From source 💻 | git clone https://github.com/MFlowCode/MFC && cd MFC && ./mfc.sh build -j $(nproc) |
Your first simulation:
./mfc.sh run examples/3D_shockdroplet/case.py -n $(nproc)Visualize the output in examples/3D_shockdroplet/silo_hdf5/ with ParaView, VisIt, or your favorite tool. For detailed build instructions (Linux, macOS, Windows/WSL, HPC clusters), see the Getting Started guide.
MFC is developed by the Computational Physics Group at Georgia Tech and collaborators. Get in touch with Spencer if you have questions! We have an active Slack channel and development team. MFC has high- and low-level documentation, visualizations, and more on its website.
MFC ships with 137+ example cases. Here is a high-Mach flow over an airfoil (see examples/2D_ibm_airfoil/):
And a high-amplitude acoustic wave reflecting and emerging through a circular orifice:
| Command | Description |
|---|---|
| ./mfc.sh build | Build MFC and its dependencies |
| ./mfc.sh run case.py | Run a simulation case (interactive or batch: SLURM/PBS/LSF) |
| ./mfc.sh test | Run the test suite |
| ./mfc.sh validate case.py | Check a case file for errors before running |
| ./mfc.sh new my_case | Create a new case from a template |
| ./mfc.sh clean | Remove build artifacts |
Run ./mfc.sh <command> --help for detailed options, or see the full documentation. Tab completion for bash and zsh is auto-installed after you have run ./mfc.sh generate (or any non-new command) at least once. Play with the examples in examples/ (showcased here).
MFC weak scales to the full machines on El Capitan (MI300A), Frontier (MI250X), and Alps (GH200) with near-ideal efficiency. MFC is an SPEChpc benchmark candidate, part of the JSC JUPITER Early Access Program, and used OLCF Frontier and LLNL El Capitan early access systems.
If you use MFC, consider citing it as below. Ref. 1 includes all modern MFC features, including GPU acceleration and many new physics features. If referencing MFC's (GPU) performance, consider citing ref. 1 and 2, which describe the solver and its design. The original open-source release of MFC is ref. 3, which should be cited for provenance as appropriate.
@article{wilfong26,
Author = {Benjamin Wilfong and Henry {Le Berre} and Anand Radhakrishnan and Ansh Gupta and Daniel J. Vickers and Diego Vaca-Revelo and Dimitrios Adam and Haocheng Yu and Hyeoksu Lee and Jose Rodolfo Chreim and Mirelys {Carcana Barbosa} and Yanjun Zhang and Esteban Cisneros-Garibay and Aswin Gnanaskandan and Mauro {Rodriguez Jr.} and Reuben D. Budiardja and Stephen Abbott and Tim Colonius and Spencer H. Bryngelson},
Title = {{MFC 5.0: A}n exascale many-physics flow solver},
journal = {Computer Physics Communications},
year = {2026},
volume = {322},
pages = {110055},
doi = {10.1016/j.cpc.2026.110055},
}
@article{Radhakrishnan_2024,
title = {Method for portable, scalable, and performant {GPU}-accelerated simulation of multiphase compressible flow},
author = {A. Radhakrishnan and H. {Le Berre} and B. Wilfong and J.-S. Spratt and M. {Rodriguez Jr.} and T. Colonius and S. H. Bryngelson},
journal = {Computer Physics Communications},
year = {2024},
volume = {302},
pages = {109238},
doi = {10.1016/j.cpc.2024.109238}
}
@article{Bryngelson_2021,
title = {{MFC: A}n open-source high-order multi-component, multi-phase, and multi-scale compressible flow solver},
author = {S. H. Bryngelson and K. Schmidmayer and V. Coralic and J. C. Meng and K. Maeda and T. Colonius},
journal = {Computer Physics Communications},
year = {2021},
volume = {266},
pages = {107396},
doi = {10.1016/j.cpc.2020.107396}
}Copyright 2021 Spencer Bryngelson and Tim Colonius. MFC is under the MIT license (see LICENSE for full text).
Federal sponsors have supported MFC development, including the US Department of Defense (DOD), the National Institutes of Health (NIH), the Department of Energy (DOE) and National Nuclear Security Administration (NNSA), and the National Science Foundation (NSF).
MFC computations have been run on many supercomputing systems. A partial list is below
| Back | FazBrowse Home | New Git URL |