Skip to content

Add atmos monthly benchmarks: pr (GPCP), evspsbl (ERA5), prw (ERA5 tcw)#72

Merged
AlexisRenchon merged 1 commit into
mainfrom
ar/atmos-monthly-benchmarks
Jul 2, 2026
Merged

Add atmos monthly benchmarks: pr (GPCP), evspsbl (ERA5), prw (ERA5 tcw)#72
AlexisRenchon merged 1 commit into
mainfrom
ar/atmos-monthly-benchmarks

Conversation

@AlexisRenchon

Copy link
Copy Markdown
Member

What

Adds three new built-in benchmark variables for the atmos component of coupled runs:

Sim variable Observation Artifact Disk
pr GPCP monthly precipitation (2.5°, 1979–present) precipitation_obs (new, lazy) ~20 MB
evspsbl ERA5 mean evaporation rate mer surface single-level (already shipped) 0
prw ERA5 total column water tcw era5_monthly_averages_atmos_single_level_1979_2024 (new, lazy) ~137 MB

Details

  • Water mass fluxes (kg m^-2 s^-1) are now displayed in mm day^-1, mirroring the existing carbon-flux display conversion. The ClimaAtmos negative-downward precipitation fluxes (pr, prra, prsn) are sign-flipped for display, matching ClimaCoupler's leaderboard (× -86400).
  • ERA5 mer uses the ECMWF sign convention (negative = evaporation); the loader flips it to positive-up to match evspsbl.
  • ERA5 tcw is total column water (vapour + ~1 % cloud condensate) while sim prw is vapour-only — noted in the code and docs; the ERA5 monthly artifacts carry no tcwv.
  • New artifacts are lazy = true (non-lazy entries in the project's own Artifacts.toml are not installed by Pkg.instantiate; benchmark.jl already uses LazyArtifacts, so they download on first use).
  • Folds in the run-title caption fix that was live on the server (smaller font, white-space: pre-line, overflow-wrap: anywhere).

Validation

  • Loader smoke test: GPCP pr mean 2.24 mm/day, ERA5 evspsbl mean 2.16 mm/day (positive after flip), ERA5 prw mean 18.4 kg/m² — all physically sane, E≈P globally.
  • New unit tests for to_display_units water fluxes and all three loaders (units, labels, sane global means); full suite passes (117 tests).

🤖 Generated with Claude Code

New built-in observation loaders for the coupled/atmos dashboards:
- pr: GPCP monthly precipitation (new lazy `precipitation_obs` artifact, ~20 MB)
- evspsbl: ERA5 mean evaporation rate `mer` from the already-shipped surface
  single-level artifact (ECMWF sign convention flipped to positive-up)
- prw: ERA5 total column water `tcw` (new lazy
  `era5_monthly_averages_atmos_single_level_1979_2024` artifact, ~137 MB)

Water mass fluxes (kg m^-2 s^-1) are now shown in mm day^-1, mirroring the
carbon display conversion; the ClimaAtmos negative-downward precipitation
fluxes (pr/prra/prsn) are sign-flipped for display, matching ClimaCoupler's
leaderboard convention.

Also folds in the run-title caption fix that was live on the server: smaller
font, newlines rendered as line breaks, long tokens (commit hashes) wrap
inside the menu column.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@AlexisRenchon
AlexisRenchon merged commit 1446a92 into main Jul 2, 2026
2 of 3 checks passed
@AlexisRenchon
AlexisRenchon deleted the ar/atmos-monthly-benchmarks branch July 2, 2026 18:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant