0.2.4.5 ClimaLandSimulations: all FLUXNET2015 sites

[AlexisRenchon]

Purpose

OKR 0.2.4.5 is:
"Demonstrate successful land model simulation with big leaf coupled to soil driven by reanalysis meteorology for FLUXNET sites; show agreement in key metrics (RMSE, r2) with flux tower data (LE, GPP)"
which requires simulations at all FLUXNET2015 sites (NOTE: FLUXNET2015 is a subset of ~200 sites, FLUXNET has 800+, but FLUXNET2015 has standardized gap-filling and partitioning, see https://fluxnet.org/data/fluxnet2015-dataset/)
ClimaLandSimulations will have an API to run simulations at each site, as well as convenient functions to read FLUXNET2015 data from the Cluster and run diagnostic code using ClimaDiagnostics.jl

Link to any relevant PRs/issues.
The current PR iteration is #582 , which add Dict to map each FLUXNET2015 site to a folder on the cluster, as well as metadata (latitude, longitude, PFT). LAI and soil properties will be read from a map using an API which returns LAI or soil properties given longitude and latitude (LAI API has been implemented, soil properties not yet).

Cost/benefits/risks

Cost: developer hours
Benefits: Demonstration of ClimaLand simulations ability to reproduce observed ecosystem flux timeseries at diurnal to interannual time scales (e.g., net co2 exchange, gross photosynthesis, respiration, evapotranspiration, latent and sensible heat fluxes, soil moisture)
risks: -

Producers

@AlexisRenchon leading this project with the help of @kmdeck, @braghiere, @Espeer5

Components

ClimaLandSimulations already allows simulations of 4 sites in 1 line of code, using the run_fluxnet() function, which can run with 1 argument (site name), taking default model configuration and parameters, or multiple arguments to customize the simulation configuration and parameters. To add all FLUXNET2015 sites, more work needs to be done:

• Dict mapping sites to metadata (folder name, lat, lon, PFTs)
• Modify run_fluxnet code to run with FLUXNET2015 sites, for example, need to use LAI API which reads LAI from lon lat, as well as soil properties API from lon lat
• Multiple quality of code adjustments (for example, less dependencies, using extensions)

Results and deliverables

Deliverables: an API to run FLUXNET2015 simulations along with diagnostic before and after calibration, this API may be used in a web dashboard for broader accessibility, a manuscript will be written to describe the result of ClimaLand.jl performance to reproduce observations.

Task breakdown

A preliminary list of PRs and a preliminary timeline of PRs, milestones, and key results.

• Task 1
• Task 2
  ...

Reviewers

@kmdeck @braghiere