Merge pull request #1259 from CliMA/js/ext

juliasloan25 · web-flow · commit 080e46e8c973 · 2025-07-24T15:26:50.000-07:00
add FluxnetSimulations ext
diff --git a/.buildkite/Manifest-v1.11.toml b/.buildkite/Manifest-v1.11.toml
@@ -484,7 +484,7 @@ version = "0.17.2"
 weakdeps = ["BSON", "CSV", "CairoMakie", "ClimaAnalysis", "DataFrames", "Flux", "GeoMakie", "HTTP", "Poppler_jll", "Printf", "StatsBase"]
 
     [deps.ClimaLand.extensions]
-    LandSimulationVisualization = ["CairoMakie", "ClimaAnalysis", "GeoMakie", "Poppler_jll", "Printf", "StatsBase"]
+    LandSimulationVisualizationExt = ["CairoMakie", "ClimaAnalysis", "GeoMakie", "Poppler_jll", "Printf", "StatsBase"]
     NeuralSnowExt = ["CSV", "DataFrames", "HTTP", "Flux", "StatsBase", "BSON"]
 
 [[deps.ClimaParams]]
diff --git a/.buildkite/Manifest.toml b/.buildkite/Manifest.toml
@@ -481,7 +481,7 @@ version = "0.17.2"
 weakdeps = ["BSON", "CSV", "CairoMakie", "ClimaAnalysis", "DataFrames", "Flux", "GeoMakie", "HTTP", "Poppler_jll", "Printf", "StatsBase"]
 
     [deps.ClimaLand.extensions]
-    LandSimulationVisualization = ["CairoMakie", "ClimaAnalysis", "GeoMakie", "Poppler_jll", "Printf", "StatsBase"]
+    LandSimulationVisualizationExt = ["CairoMakie", "ClimaAnalysis", "GeoMakie", "Poppler_jll", "Printf", "StatsBase"]
     NeuralSnowExt = ["CSV", "DataFrames", "HTTP", "Flux", "StatsBase", "BSON"]
 
 [[deps.ClimaParams]]
diff --git a/NEWS.md b/NEWS.md
@@ -3,6 +3,7 @@ ClimaLand.jl Release Notes
 
 main
 -------
+- Rename LandSimulationVisualization to LandSimulationVisualizationExt; add template for FluxnetSimulationsExt PR[#1259](https://github.com/CliMA/ClimaLand.jl/pull/1259)
 - Remove root_depths from the PrescribeGroundConditions struct, and treat these ground ``drivers" consistently with how we handle atmospheric forcing PR[#1199](https://github.com/CliMA/ClimaLand.jl/pull/1240)
 - Add constructors with default values for Canopy components PR[#1233](https://github.com/CliMA/ClimaLand.jl/pull/1233)
 
diff --git a/Project.toml b/Project.toml
@@ -29,6 +29,7 @@ CSV = "336ed68f-0bac-5ca0-87d4-7b16caf5d00b"
 CairoMakie = "13f3f980-e62b-5c42-98c6-ff1f3baf88f0"
 ClimaAnalysis = "29b5916a-a76c-4e73-9657-3c8fd22e65e6"
 DataFrames = "a93c6f00-e57d-5684-b7b6-d8193f3e46c0"
+DelimitedFiles = "8bb1440f-4735-579b-a4ab-409b98df4dab"
 Flux = "587475ba-b771-5e3f-ad9e-33799f191a9c"
 GeoMakie = "db073c08-6b98-4ee5-b6a4-5efafb3259c6"
 HTTP = "cd3eb016-35fb-5094-929b-558a96fad6f3"
@@ -37,13 +38,14 @@ Printf = "de0858da-6303-5e67-8744-51eddeeeb8d7"
 StatsBase = "2913bbd2-ae8a-5f71-8c99-4fb6c76f3a91"
 
 [extensions]
-LandSimulationVisualization = ["CairoMakie", "ClimaAnalysis", "GeoMakie", "Poppler_jll", "Printf", "StatsBase"]
+FluxnetSimulationsExt = ["DelimitedFiles"]
+LandSimulationVisualizationExt = ["CairoMakie", "ClimaAnalysis", "GeoMakie", "Poppler_jll", "Printf", "StatsBase"]
 NeuralSnowExt = ["CSV", "DataFrames", "HTTP", "Flux", "StatsBase", "BSON"]
 
 [compat]
 BSON = "0.3.9"
-CairoMakie = "0.12"
 CSV = "0.10.14"
+CairoMakie = "0.12"
 ClimaAnalysis = "0.5.17"
 ClimaComms = "0.6.2"
 ClimaCore = "0.14.23"
@@ -53,6 +55,7 @@ ClimaTimeSteppers = "0.8"
 ClimaUtilities = "0.1.24"
 DataFrames = "1.4"
 Dates = "1"
+DelimitedFiles = "1.9"
 DocStringExtensions = "0.9"
 Flux = "0.15, 0.16"
 GeoMakie = "< 0.7.13"
diff --git a/docs/Manifest-v1.11.toml b/docs/Manifest-v1.11.toml
@@ -406,7 +406,7 @@ uuid = "08f4d4ce-cf43-44bb-ad95-9d2d5f413532"
 version = "0.17.2"
 
     [deps.ClimaLand.extensions]
-    LandSimulationVisualization = ["CairoMakie", "ClimaAnalysis", "GeoMakie", "Poppler_jll", "Printf", "StatsBase"]
+    LandSimulationVisualizationExt = ["CairoMakie", "ClimaAnalysis", "GeoMakie", "Poppler_jll", "Printf", "StatsBase"]
     NeuralSnowExt = ["CSV", "DataFrames", "HTTP", "Flux", "StatsBase", "BSON"]
 
     [deps.ClimaLand.weakdeps]
diff --git a/docs/Manifest.toml b/docs/Manifest.toml
@@ -409,7 +409,7 @@ uuid = "08f4d4ce-cf43-44bb-ad95-9d2d5f413532"
 version = "0.17.2"
 
     [deps.ClimaLand.extensions]
-    LandSimulationVisualization = ["CairoMakie", "ClimaAnalysis", "GeoMakie", "Poppler_jll", "Printf", "StatsBase"]
+    LandSimulationVisualizationExt = ["CairoMakie", "ClimaAnalysis", "GeoMakie", "Poppler_jll", "Printf", "StatsBase"]
     NeuralSnowExt = ["CSV", "DataFrames", "HTTP", "Flux", "StatsBase", "BSON"]
 
     [deps.ClimaLand.weakdeps]
diff --git a/experiments/long_runs/bucket.jl b/experiments/long_runs/bucket.jl
@@ -37,8 +37,8 @@ using CairoMakie, GeoMakie, Poppler_jll, ClimaAnalysis
 LandSimVis =
     Base.get_extension(
         ClimaLand,
-        :LandSimulationVisualization,
-    ).LandSimulationVisualization;
+        :LandSimulationVisualizationExt,
+    ).LandSimulationVisualizationExt;
 
 const FT = Float64;
 time_interpolation_method = LinearInterpolation(PeriodicCalendar())
diff --git a/experiments/long_runs/land_region.jl b/experiments/long_runs/land_region.jl
@@ -41,8 +41,8 @@ using CairoMakie, GeoMakie, Poppler_jll, ClimaAnalysis
 LandSimVis =
     Base.get_extension(
         ClimaLand,
-        :LandSimulationVisualization,
-    ).LandSimulationVisualization;
+        :LandSimulationVisualizationExt,
+    ).LandSimulationVisualizationExt;
 
 const FT = Float64;
 context = ClimaComms.context()
@@ -115,7 +115,7 @@ function setup_model(FT, context, start_date, Δt, domain, earth_param_set)
     SAI = FT(0.0) # m2/m2
     f_root_to_shoot = FT(3.5)
     RAI = FT(1.0)
-    K_sat_plant = FT(7e-8) # m/s 
+    K_sat_plant = FT(7e-8) # m/s
     ψ63 = FT(-4 / 0.0098) # / MPa to m
     Weibull_param = FT(4) # unitless
     a = FT(0.2 * 0.0098) # 1/m
diff --git a/experiments/long_runs/snowy_land.jl b/experiments/long_runs/snowy_land.jl
@@ -43,8 +43,8 @@ using CairoMakie, GeoMakie, Poppler_jll, ClimaAnalysis
 LandSimVis =
     Base.get_extension(
         ClimaLand,
-        :LandSimulationVisualization,
-    ).LandSimulationVisualization;
+        :LandSimulationVisualizationExt,
+    ).LandSimulationVisualizationExt;
 
 const FT = Float64;
 # If you want to do a very long run locally, you can enter `export
diff --git a/experiments/long_runs/soil.jl b/experiments/long_runs/soil.jl
@@ -38,8 +38,8 @@ using CairoMakie, GeoMakie, Poppler_jll, ClimaAnalysis
 LandSimVis =
     Base.get_extension(
         ClimaLand,
-        :LandSimulationVisualization,
-    ).LandSimulationVisualization;
+        :LandSimulationVisualizationExt,
+    ).LandSimulationVisualizationExt;
 
 const FT = Float64;
 # If you want to do a very long run locally, you can enter `export
diff --git a/ext/FluxnetSimulationsExt.jl b/ext/FluxnetSimulationsExt.jl
@@ -0,0 +1,13 @@
+module FluxnetSimulationsExt
+using ClimaLand
+import DelimitedFiles
+
+# Include site-specific configurations, as well as the default generic site.
+include("fluxnet_simulations/generic_site.jl")
+include("fluxnet_simulations/US-MOz.jl")
+include("fluxnet_simulations/US-Ha1.jl")
+include("fluxnet_simulations/US-NR1.jl")
+include("fluxnet_simulations/US-Var.jl")
+# export get_parameters, get_domain_info - TODO uncomment once we implement these
+
+end # module FluxnetSimulationsExt
diff --git a/ext/LandSimulationVisualizationExt.jl b/ext/LandSimulationVisualizationExt.jl
@@ -1,4 +1,4 @@
-module LandSimulationVisualization
+module LandSimulationVisualizationExt
 import ClimaDiagnostics
 import ClimaAnalysis
 import ClimaAnalysis.Visualize as viz
@@ -56,7 +56,7 @@ end
 )
 
 Creates the leaderboard plots a global LandModel simulations with diagnostics output
-as defined by `diagnostics` using `leaderboard_data_sources` as the source of truth; 
+as defined by `diagnostics` using `leaderboard_data_sources` as the source of truth;
 saves the output to files in `savedir`.
 
 The first two arguments are used for dispatch only.
@@ -103,8 +103,8 @@ specifically for the list of variables `short_names`, at the date
 given by `date`, and at the layers defined by `levels`; the output
 plots are saved in `savedir`.
 
-Please note that 
-- `date` must be a DateTime, and the output closest to this date will be used 
+Please note that
+- `date` must be a DateTime, and the output closest to this date will be used
 for plotting
 - `short_names` can be a string (single variable), a list, or `nothing`, in which
 case all possible variables will be plotted
@@ -213,12 +213,12 @@ end
 	plot_name = "annual_timeseries.pdf",
 )
 
-Makes timeseries of the domain-averaged variable, 
+Makes timeseries of the domain-averaged variable,
  using the diagnostics output of the `sim` simulation,
 specifically for the list of variables `short_names; the output
 plots are saved in `savedir`.
 
-Please note that 
+Please note that
 - `short_names` can be a string (single variable), a list, or `nothing`, in which
 case all possible variables will be plotted
 - The top layer of 3D variables is used for plotting.
diff --git a/ext/fluxnet_simulations/US-Ha1.jl b/ext/fluxnet_simulations/US-Ha1.jl
@@ -0,0 +1 @@
+
diff --git a/ext/fluxnet_simulations/US-MOz.jl b/ext/fluxnet_simulations/US-MOz.jl
@@ -0,0 +1 @@
+
diff --git a/ext/fluxnet_simulations/US-NR1.jl b/ext/fluxnet_simulations/US-NR1.jl
@@ -0,0 +1 @@
+
diff --git a/ext/fluxnet_simulations/US-Var.jl b/ext/fluxnet_simulations/US-Var.jl
@@ -0,0 +1 @@
+
diff --git a/ext/fluxnet_simulations/generic_site.jl b/ext/fluxnet_simulations/generic_site.jl
@@ -0,0 +1 @@
+
