[Example] Tropical cyclone with stationary stratiform rainband (YD19)

.github/workflows/Documentation.yml

@@ -38,7 +38,7 @@ jobs:
     container:
       image: 'ghcr.io/numericalearth/breeze-docker-images:docs-julia_1.12.6'
       options: --gpus=all
-    timeout-minutes: 90
+    timeout-minutes: 120
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
       - name: Set BREEZE_BUILD_ALL_EXAMPLES
@@ -63,7 +63,7 @@ jobs:
           git config --global --add safe.directory ${PWD}
       - name: Build documentation
         shell: bash
-        timeout-minutes: 75
+        timeout-minutes: 110
         run:
           earlyoom -m 3 -s 100 -r 300 --prefer 'julia' &
           julia --color=yes --project=docs --threads 1,$(($(nproc)-1)) docs/make.jl

docs/make.jl

@@ -36,20 +36,21 @@ examples = [
     Example("Stratified dry thermal bubble", "dry_thermal_bubble"; build_always=true, gpu=false),
     Example("Cloudy thermal bubble", "cloudy_thermal_bubble"; build_always=true, gpu=false),
     Example("Cloudy Kelvin-Helmholtz instability", "cloudy_kelvin_helmholtz"; build_always=true, gpu=false),
-    Example("Shallow cumulus convection (BOMEX)", "bomex"; build_always=true, gpu=true),
+    # Example("Shallow cumulus convection (BOMEX)", "bomex"; build_always=true, gpu=true),
     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("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),
     Example("Acoustic wave in shear layer", "acoustic_wave"; build_always=true, gpu=false),
     Example("Cloud formation in prescribed updraft", "kinematic_driver"; build_always=true, gpu=false),
-    Example("Schär mountain wave with terrain-following coordinates", "two_dimension_mountain_wave"; build_always=false, gpu=true),
-    Example("Splitting supercell", "splitting_supercell"; build_always=false, gpu=true),
-    Example("Tropical cyclone world", "tropical_cyclone_world"; build_always=false, gpu=true),
-    Example("Diurnal cycle of radiative convection", "radiative_convection"; build_always=false, gpu=true),
+    # Example("Schär mountain wave with terrain-following coordinates", "two_dimension_mountain_wave"; build_always=false, gpu=true),
+    # Example("Splitting supercell", "splitting_supercell"; build_always=false, gpu=true),
+    # Example("Tropical cyclone world", "tropical_cyclone_world"; build_always=false, gpu=true),
+    Example("Tropical cyclone with stratiform rainband heating (YD19)", "tropical_cyclone_with_rainband"; build_always=false, gpu=true),
+    # Example("Diurnal cycle of radiative convection", "radiative_convection"; build_always=false, gpu=true),
 ]
 
 # Filter out long-running example if necessary

docs/src/breeze.bib

@@ -658,3 +658,69 @@ @article{Simmons1981
   year = {1981},
   doi = {10.1175/1520-0493(1981)109<0758:AEAAMC>2.0.CO;2}
 }
+
+@article{YuDidlake2019,
+  author = {Yu, Cheng-Ku and Didlake, Anthony C.},
+  title = {Impact of a stationary stratiform rainband on a tropical-cyclone-like vortex},
+  journal = {Journal of the Atmospheric Sciences},
+  volume = {76},
+  number = {11},
+  pages = {3169--3189},
+  year = {2019},
+  doi = {10.1175/JAS-D-18-0259.1}
+}
+
+@article{MoonNolan2010,
+  author = {Moon, Yumin and Nolan, David S.},
+  title = {The dynamic response of the hurricane wind field to spiral rainband heating},
+  journal = {Journal of the Atmospheric Sciences},
+  volume = {67},
+  number = {6},
+  pages = {1779--1805},
+  year = {2010},
+  doi = {10.1175/2010JAS3284.1}
+}
+
+@article{SternNolan2009,
+  author = {Stern, Daniel P. and Nolan, David S.},
+  title = {Reexamining the vertical structure of tangential winds in tropical cyclones: {Observations} and theory},
+  journal = {Journal of the Atmospheric Sciences},
+  volume = {66},
+  number = {12},
+  pages = {3579--3600},
+  year = {2009},
+  doi = {10.1175/2009JAS3021.1}
+}
+
+@article{Nolan2001,
+  author = {Nolan, David S.},
+  title = {The stabilizing effects of axial stretching on turbulent vortex dynamics},
+  journal = {Physics of Fluids},
+  volume = {13},
+  number = {6},
+  pages = {1724--1738},
+  year = {2001},
+  doi = {10.1063/1.1369646}
+}
+
+@article{Jordan1958,
+  author = {Jordan, Charles L.},
+  title = {Mean soundings for the {West} {Indies} area},
+  journal = {Journal of Meteorology},
+  volume = {15},
+  number = {1},
+  pages = {91--97},
+  year = {1958},
+  doi = {10.1175/1520-0469(1958)015<0091:MSFTWI>2.0.CO;2}
+}
+
+@article{Emanuel1986,
+  author = {Emanuel, Kerry A.},
+  title = {An air-sea interaction theory for tropical cyclones. {Part} {I}: {Steady}-state maintenance},
+  journal = {Journal of the Atmospheric Sciences},
+  volume = {43},
+  number = {6},
+  pages = {585--605},
+  year = {1986},
+  doi = {10.1175/1520-0469(1986)043<0585:AASITF>2.0.CO;2}
+}

examples/.gitignore

@@ -0,0 +1,14 @@
+# Experiment outputs
+experiments/
+
+# TC rainband reproduction outputs
+output_tc_*/
+figures_tc_*/
+_legacy_output/
+dev/figures_balance_test/
+
+# Legacy output files (if any exist)
+*.jld2
+*.mp4
+*.png
+tropical_cyclone_checkpoint*