Add neutral atmospheric boundary layer example (#615)

ewquon · glwagner · navidcy · web-flow · commit f2b982d22f7c · 2026-04-20T19:43:32.000+01:00
* Add neutral ABL example from Moeng & Sullivan 1994 * Cleanup, add plotting * Numbers must have meaning. Co-authored-by: Gregory L. Wagner <gregory.leclaire.wagner@gmail.com> * GPU plotting fix * Clarify simulation "S" * Add example for neutral atmospheric boundary layer at least temporarily to see how the example renders in the docs preview * Apply suggestions from code review Co-authored-by: Navid C. Constantinou <navidcy@users.noreply.github.com> * Apply suggestion from @navidcy * few tweaks * fix title * undo * fix citations * Update neutral_atmospheric_boundary_layer.jl * fix refs + tweaks * tweaks * Update simulation duration from 6 hours to 5 hours * Apply suggestion from @navidcy * tweaks * drop empty lines * disable most examples * enable dry_thermal_bubble * show figs * adds explanations * tweaks * remove duplicate plots * don't show Δz array * reenable examples * cleaner * Update examples/neutral_atmospheric_boundary_layer.jl Co-authored-by: Mosè Giordano <765740+giordano@users.noreply.github.com> * bit cleaner plotting * Update outputs and add plotting interval * Best practice with WENO9 * Cleanup docs * Update examples/neutral_atmospheric_boundary_layer.jl Co-authored-by: Navid C. Constantinou <navidcy@users.noreply.github.com> * DROP ME: Check out Oceananigans PR * Reduce precision to Float32 * Apply suggestion from @navidcy Co-authored-by: Navid C. Constantinou <navidcy@users.noreply.github.com> * Clean up docs and plotting * More cleanup * All averaged output at cell centers * Fix plot * Postproc fixes * Apply suggestion from @navidcy * Apply suggestion from @giordano Co-authored-by: Mosè Giordano <765740+giordano@users.noreply.github.com> * attempt to compute derivatives on the fly * fix bug * Revert "DROP ME: Check out Oceananigans PR" This reverts commit 6c27e77. * Update examples/neutral_atmospheric_boundary_layer.jl Co-authored-by: Mosè Giordano <765740+giordano@users.noreply.github.com> * Fix plotting * drop empty line * Minor cleanup, clarification * Minor doc edit * More docs edits --------- Co-authored-by: Gregory L. Wagner <gregory.leclaire.wagner@gmail.com> Co-authored-by: Navid C. Constantinou <navidcy@users.noreply.github.com> Co-authored-by: Mosè Giordano <765740+giordano@users.noreply.github.com> Co-authored-by: Mosè Giordano <mose@gnu.org>
diff --git a/docs/make.jl b/docs/make.jl
@@ -40,6 +40,7 @@ examples = [
     Example("Precipitating shallow cumulus (RICO)", "rico"; build_always=false, gpu=false),
     Example("Convection over prescribed sea surface temperature (SST)", "prescribed_sea_surface_temperature"; build_always=true, gpu=false),
     Example("Inertia gravity wave: many time steppers", "inertia_gravity_wave"; build_always=true, gpu=false),
+    Example("Neutral atmospheric boundary layer", "neutral_atmospheric_boundary_layer"; build_always=false, gpu=true),
     Example("Single column radiation", "single_column_radiation"; build_always=true, gpu=false),
     Example("Stationary parcel model", "stationary_parcel_model"; build_always=true, gpu=false),
     Example("Rising parcel: adiabatic ascent", "rising_parcels"; build_always=true, gpu=false),
diff --git a/docs/src/breeze.bib b/docs/src/breeze.bib
@@ -573,7 +573,7 @@ @article{Klemp2011
   doi = {10.1175/MWR-D-10-05046.1}
 }
 
-@article{Sullivan2014,
+@article{Sullivan1994,
   author = {Sullivan, Peter P. and McWilliams, James C. and Moeng, Chin-Hoh},
   title = {A subgrid-scale model for large-eddy simulation of planetary boundary-layer flows},
   journal = {Boundary-Layer Meteorology},
@@ -584,6 +584,50 @@ @article{Sullivan2014
   doi = {10.1007/BF00713741}
 }
 
+@article{Moeng1994,
+  author = {Moeng, Chin-Hoh and Sullivan, Peter P.},
+  title = {A comparison of shear- and buoyancy-driven planetary boundary layer flows},
+  journal = {Journal of the Atmospheric Sciences},
+  volume = {51},
+  number = {7},
+  pages = {999--1022},
+  year = {1994},
+  doi = {10.1175/1520-0469(1994)051<0999:ACOSAB>2.0.CO;2}
+}
+
+@article{Berg2020,
+  author = {Berg, Jacob and Patton, Edward G. and Sullivan, Peter P.},
+  title = {{Large-eddy simulation of conditionally neutral boundary layers: A mesh resolution sensitivity study}},
+  journal = {Journal of the Atmospheric Sciences},
+  volume = {77},
+  number = {6},
+  pages = {1969--1991},
+  year = {2020},
+  doi = {10.1175/JAS-D-19-0252.1}
+}
+
+@article{Pedersen2014,
+  author = {Pedersen, Jesper G. and Gryning, Sven-Erik and Kelly, Mark},
+  title = {On the structure and adjustment of inversion-capped neutral atmospheric boundary-layer flows: {Large}-eddy simulation study},
+  journal = {Boundary-Layer Meteorology},
+  volume = {153},
+  number = {1},
+  pages = {43--62},
+  year = {2014},
+  doi = {10.1007/s10546-014-9937-z}
+}
+
+@article{Sauer2020,
+  author = {Sauer, Jeremy A. and {Mu{\~n}oz-Esparza}, Domingo},
+  title = {The {FastEddy}\textregistered{} resident-{GPU} accelerated large-eddy simulation framework: {Model} formulation, dynamical-core validation and performance benchmarks},
+  journal = {Journal of Advances in Modeling Earth Systems},
+  volume = {12},
+  number = {11},
+  pages = {1--30},
+  year = {2020},
+  doi = {10.1029/2020MS002100}
+}
+
 @article{Simmons1981,
   author = {Simmons, Adrian J. and Burridge, David M.},
   title = {An energy and angular-momentum conserving vertical finite-difference scheme and hybrid vertical coordinates},
diff --git a/examples/Project.toml b/examples/Project.toml
@@ -4,6 +4,8 @@ Breeze = "660aa2fb-d4c8-4359-a52c-9c057bc511da"
 CUDA = "052768ef-5323-5732-b1bb-66c8b64840ba"
 CairoMakie = "13f3f980-e62b-5c42-98c6-ff1f3baf88f0"
 CloudMicrophysics = "6a9e3e04-43cd-43ba-94b9-e8782df3c71b"
+ITerm2Images = "9348d769-4460-4e86-9927-452f530f5601"
+JLD2 = "033835bb-8acc-5ee8-8aae-3f567f8a3819"
 NCDatasets = "85f8d34a-cbdd-5861-8df4-14fed0d494ab"
 Oceananigans = "9e8cae18-63c1-5223-a75c-80ca9d6e9a09"
 Printf = "de0858da-6303-5e67-8744-51eddeeeb8d7"
diff --git a/examples/neutral_atmospheric_boundary_layer.jl b/examples/neutral_atmospheric_boundary_layer.jl
