Merge branch 'master' into gpu-optimizations

Author: danieljvickers

.github/workflows/homebrew-release.yml

@@ -109,13 +109,14 @@ jobs:
 
           echo "Updating formula to v${VERSION}..."
 
-          # Update URL
-          sed -i "s|url \"https://github.com/MFlowCode/MFC/archive/refs/tags/v[^\"]*\.tar\.gz\"|url \"https://github.com/MFlowCode/MFC/archive/refs/tags/v${VERSION}.tar.gz\"|" "$FORMULA"
+          # Update URL (match any GitHub archive URL, not just MFlowCode/MFC,
+          # in case the formula temporarily points at a fork during testing)
+          sed -i "s|url \"https://github.com/[^\"]*/archive/[^\"]*\.tar\.gz\"|url \"https://github.com/MFlowCode/MFC/archive/refs/tags/v${VERSION}.tar.gz\"|" "$FORMULA"
 
           # Update SHA256 (the one right after url, not bottle SHAs)
           # This uses awk to only update the first sha256 after the url line
           awk -v newsha="$SHA256" '
-            /^  url "https:\/\/github.com\/MFlowCode\/MFC/ { found_url=1 }
+            /^  url "https:\/\/github.com\// { found_url=1 }
             found_url && /^  sha256 "/ && !updated {
               sub(/sha256 "[^"]*"/, "sha256 \"" newsha "\"")
               updated=1
@@ -157,13 +158,16 @@ jobs:
           git config user.email "github-actions[bot]@users.noreply.github.com"
 
           git add Formula/mfc.rb
-          git commit -m "Update MFC to v${VERSION}"
 
-          echo "Pushing to homebrew-mfc..."
-          git push origin main
-
-          echo "Successfully pushed formula update!"
-          echo "The bottle.yml workflow in homebrew-mfc will now build bottles automatically."
+          if git diff --cached --quiet; then
+            echo "::notice::Formula already up to date for v${VERSION} — nothing to push."
+          else
+            git commit -m "Update MFC to v${VERSION}"
+            echo "Pushing to homebrew-mfc..."
+            git push origin main
+            echo "Successfully pushed formula update!"
+            echo "The bottle.yml workflow in homebrew-mfc will now build bottles automatically."
+          fi
 
       - name: Dry run summary
         if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.dry_run == 'true' }}

README.md

@@ -47,7 +47,7 @@ PROJECT_NUMBER         =
 # for a project that appears at the top of each page and should give viewer a
 # quick idea about the purpose of the project. Keep the description short.
 
-PROJECT_BRIEF          = "High-fidelity multiphase flow simulation"
+PROJECT_BRIEF          = "Exascale flow solver"
 
 # With the PROJECT_LOGO tag one can specify a logo or an icon that is included
 # in the documentation. The maximum height of the logo should not exceed 55

docs/Doxyfile.in

@@ -3,6 +3,16 @@
  * Overrides for doxygen-awesome theme
  */
 
+/* Narrower left navigation panel */
+html {
+    --side-nav-fixed-width: 210px;
+}
+
+/* Hide tree sync button */
+#nav-sync {
+    display: none;
+}
+
 /* Seamless split <code> tags for Fortran % struct accessors.
  * Doxygen consumes %<word> even inside code spans, so we split around %
  * into adjacent <code> elements and remove internal borders/padding. */

docs/custom.css

@@ -165,22 +165,24 @@ __All grind times are in nanoseconds (ns) per grid point (gp) per equation (eq)
 
 Weak scaling results are obtained by increasing the problem size with the number of processes so that work per process remains constant.
 
-### AMD MI250X GPU
+### GPU weak scaling
 
-MFC weask scales to (at least) 65,536 AMD MI250X GPUs on OLCF Frontier with 96% efficiency.
-This corresponds to 87% of the entire machine.
+MFC weak scales on multiple exascale GPU platforms with high efficiency:
+- **LLNL El Capitan**: AMD MI300A APUs
+- **OLCF Frontier**: AMD MI250X GPUs (65,536 GCDs, 87% of the machine, 96% efficiency)
+- **CSCS Alps**: NVIDIA GH200 GPUs
 
-<img src="../res/weakScaling/frontier.svg" style="height: 50%; width:50%; border-radius: 10pt"/>
+<img src="../res/weakScaling/weakscaling-dark.png" style="width:60%; border-radius: 10pt"/>
 
-### NVIDIA V100 GPU
+### NVIDIA V100 GPU (historical)
 
-MFC weak scales to (at least) 13,824 V100 NVIDIA V100 GPUs on OLCF Summit with 97% efficiency.
+MFC weak scales to (at least) 13,824 NVIDIA V100 GPUs on OLCF Summit with 97% efficiency.
 This corresponds to 50% of the entire machine.
 
 <img src="../res/weakScaling/summit.svg" style="height: 50%; width:50%; border-radius: 10pt"/>
 
-### IBM Power9 CPU
-MFC Weak scales to 13,824 Power9 CPU cores on OLCF Summit to within 1% of ideal scaling.
+### IBM Power9 CPU (historical)
+MFC weak scales to 13,824 Power9 CPU cores on OLCF Summit to within 1% of ideal scaling.
 
 <img src="../res/weakScaling/cpuScaling.svg" style="height: 50%; width:50%; border-radius: 10pt"/>
 

docs/documentation/expectedPerformance.md

@@ -1,17 +1,8 @@
 <!-- HTML footer for doxygen 1.9.1-->
 <!-- start footer part -->
 <!--BEGIN GENERATE_TREEVIEW-->
-<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
-  <ul>
-    $navpath
-    <li class="footer">$generatedby <a href="https://www.doxygen.org/index.html"><img class="footer" src="$relpath^doxygen.svg" width="104" height="31" alt="doxygen"/></a> $doxygenversion </li>
-  </ul>
-</div>
 <!--END GENERATE_TREEVIEW-->
 <!--BEGIN !GENERATE_TREEVIEW-->
-<hr class="footer"/><address class="footer"><small>
-$generatedby&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="$relpath^doxygen.svg" width="104" height="31" alt="doxygen"/></a> $doxygenversion
-</small></address>
 <!--END !GENERATE_TREEVIEW-->
 </body>
 </html>

docs/footer.html

@@ -14,28 +14,33 @@
     <meta charset="UTF-8">
     <meta http-equiv="X-UA-Compatible" content="IE=edge">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>MFC | Home</title>
-    <meta name="description" content="MFC is an exascale multiphysics CFD solver maintained by the research groups of Profs. Bryngelson and Colonius." />
-    <meta name=”keywords” content="exascale, fluid dynamics, cfd, computational fluid dynamics, compressible, hpc, bryngelson, colonius, subgrid, multiphase, frontier, summit, el capitan, aurora, amd gpu, gpu, nvidia"/>
+    <title>MFC | Exascale Multiphase Flow Solver</title>
+    <meta name="description" content="MFC is an open-source exascale multiphase flow solver and 2025 Gordon Bell Prize Finalist. Scales to 200+ trillion grid points on 43,000+ GPUs." />
+    <meta name="keywords" content="exascale, fluid dynamics, cfd, computational fluid dynamics, compressible, hpc, bryngelson, colonius, subgrid, multiphase, frontier, summit, el capitan, aurora, amd gpu, gpu, nvidia, gordon bell"/>
+    <meta property="og:title" content="MFC - Exascale Multiphase Flow Solver" />
+    <meta property="og:description" content="Open-source exascale multiphase flow solver. 2025 Gordon Bell Prize Finalist. Scales to 200+ trillion grid points on 43,000+ GPUs." />
+    <meta property="og:image" content="https://mflowcode.github.io/res/banner.png" />
+    <meta property="og:url" content="https://mflowcode.github.io" />
+    <meta property="og:type" content="website" />
+    <meta name="twitter:card" content="summary_large_image" />
     <script src="https://cdn.tailwindcss.com"></script>
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
     <link rel="icon" type="image/x-icon" href="res/icon.ico">
     <script>
         const sims = [
-            { name: "Viscous Taylor-Green vortex",       image: "res/simulations/h.png", computer: "Delta",   accelerators: "128 A100s", walltime: "17h",     source: "https://vimeo.com/1019922003?share=copy" },
-            { name: "Shedding water droplet",            image: "res/simulations/a.png", computer: "Summit",  accelerators: "960 V100s", walltime: "4h",      source: "https://player.vimeo.com/video/905208069" },
-            { name: "Flow over an airfoil (vorticity)",  image: "res/simulations/g.png", computer: "Delta",   accelerators: "128 A100s", walltime: "19h",     source: "https://vimeo.com/917305340/c05fd414c8?share=copy" },
+            { name: "Viscous Taylor-Green vortex",       image: "res/simulations/h.png", computer: "Delta",   accelerators: "128 A100s", walltime: "17h",     source: "https://www.youtube.com/watch?v=7i2h08dlDQw" },
+            { name: "Shedding water droplet",            image: "res/simulations/a.png", computer: "Summit",  accelerators: "960 V100s", walltime: "4h",      source: "https://www.youtube.com/watch?v=Gjj-qZkXcrg" },
+            { name: "Flow over an airfoil (vorticity)",  image: "res/simulations/g.png", computer: "Delta",   accelerators: "128 A100s", walltime: "19h",     source: "https://www.youtube.com/watch?v=FvAgnBW59cY" },
             { name: "Cavitation fragments kidney stone", image: "res/simulations/d.png", computer: "Summit",  accelerators: "576 V100s", walltime: "30 min",  source: "https://doi.org/10.48550/arXiv.2305.09163" },
-            { name: "Breakup of vibrated interface",     image: "res/simulations/f.png", computer: "Summit",  accelerators: "128 V100s", walltime: "4h",      source: "https://player.vimeo.com/video/922022757" },
-            { name: "Mach 2 flow over a sphere",         image: "res/simulations/i.png", computer: "Phoenix", accelerators: "36 V100s",  walltime: "30m",     source: "https://vimeo.com/1020775531?share=copy" },
-            { name: "Mach 2 shear layer",                image: "res/simulations/j.png", computer: "Phoenix", accelerators: "32 V100s",  walltime: "15m",     source: "https://vimeo.com/1020775541?share=copy" },
+            { name: "Breakup of vibrated interface",     image: "res/simulations/f.png", computer: "Summit",  accelerators: "128 V100s", walltime: "4h",      source: "https://www.youtube.com/watch?v=XQ3g1oSg8mc" },
+            { name: "Mach 2 flow over a sphere",         image: "res/simulations/i.png", computer: "Phoenix", accelerators: "36 V100s",  walltime: "30m",     source: "https://www.youtube.com/watch?v=HQGSUvYEGqM" },
+            { name: "Mach 2 shear layer",                image: "res/simulations/j.png", computer: "Phoenix", accelerators: "32 V100s",  walltime: "15m",     source: "https://www.youtube.com/watch?v=GtcdCHLmJO8" },
             { name: "Collapsing bubbles (pressure)",     image: "res/simulations/b.png", computer: "Summit",  accelerators: "216 V100s", walltime: "3h",      source: "https://doi.org/10.48550/arXiv.2305.09163" },
             { name: "Collapsing bubbles (streamlines)",  image: "res/simulations/c.png", computer: "Summit",  accelerators: "216 V100s", walltime: "3h",      source: "https://doi.org/10.48550/arXiv.2305.09163" },
         ];
 
         const scalings = [
-            { image: "res/weakScaling/frontier.svg", label: "Oak Ridge Frontier (AMD MI250X GPUs)" },
-            { image: "res/weakScaling/summit.svg",   label: "Oak Ridge Summit (NVIDIA V100 GPUs)" },
+            { image: "res/weakScaling/weakscaling.png", label: "Weak scaling on El Capitan (MI300A), Frontier (MI250X), and Alps (GH200)" },
         ];
 
         document.addEventListener("DOMContentLoaded", () => {
@@ -71,7 +76,7 @@
             `).join("");
 
             document.getElementById("ft-scaling").innerHTML = scalings.map(s => `
-                <div class="flex md:w-2/6 flex-col text-white rounded bg-slate-900 rounded-b-lg">
+                <div class="flex md:w-2/6 mx-auto flex-col text-white rounded bg-slate-900 rounded-b-lg">
                     <div class="flex-1 grid bg-white pb-2">
                         <img class="place-self-center" src="${s.image}" alt="${s.label}">
                     </div>
@@ -118,12 +123,15 @@
                 <div class="w-full flex flex-col gap-4">
                     <img src="res/banner.png" class="h-20 md:h-24 mx-auto">
                 </div>
-                <div class="w-full flex flex-col text-white text-md md:text-lg text-justify font-semibold">
+                <div class="w-full flex flex-col text-white text-md md:text-lg text-justify font-semibold gap-3">
                     An exascale compressible multiphase and multiphysics flow code.
+                    <span class="text-amber-400 text-sm md:text-base font-bold">
+                        2025 Gordon Bell Prize Finalist - 200+ trillion grid points on 43,000+ GPUs
+                    </span>
                 </div>
             </div>
             <div class="flex mx-auto">
-                <div class="justify-center grid grid-cols-2 sm:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5 gap-x-4 md:gap-x-8 text-md md:text-xl text-center text-white font-medium">
+                <div class="justify-center grid grid-cols-2 sm:grid-cols-3 lg:grid-cols-6 gap-x-4 md:gap-x-8 text-md md:text-xl text-center text-white font-medium">
                     <a class="px-4 flex flex-row items-center py-4 border-b-2 hover:border-amber-400" href="https://github.com/MFlowCode/MFC">
                         <i class="pr-4 fa-brands fa-github"></i>
                         <span class="flex-1">GitHub</span>
@@ -147,6 +155,10 @@
                         <i class="pr-4 fa-solid fa-newspaper"></i>
                         <span class="flex-1">Papers</span>
                     </a>
+                    <a class="px-4 flex flex-row items-center py-4 border-b-2 hover:border-amber-400" href="https://www.youtube.com/@MFCode" target="_blank">
+                        <i class="pr-4 fa-brands fa-youtube"></i>
+                        <span class="flex-1">YouTube</span>
+                    </a>
                 </div>
             </div>
         </div>
@@ -198,7 +210,7 @@ <h1 class="flex-1 flex flex-col justify-center gap-y-4">
         </div>
         <div class="text-justify flex-1 text-xs md:text-sm text-neutral-300">
             Multiple 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 the National Science Foundation (NSF).
-            MFC computations use OLCF Frontier, Summit, and Wombat; LLNC LC Tuolumne and Lassen; and many ACCESS-CI systems
+            MFC computations use OLCF Frontier, Summit, and Wombat; LLNL El Capitan, Tuolumne, and Lassen; and many ACCESS-CI systems
         </div>
     </div>
 </body>

docs/index.html

@@ -213,9 +213,9 @@ def _generate_commands_by_category(
 def generate_cli_reference(schema: CLISchema) -> str:
     """Generate complete CLI reference documentation in markdown."""
     lines = [
-        "@page cli-reference Command Line Reference",
+        "@page cli-reference CLI Reference",
         "",
-        "# Command Line Reference",
+        "# CLI Reference",
         "",
         "> **Auto-generated** from `toolchain/mfc/cli/commands.py`",
         "> ",