Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

ClimaLand.jl

Create and run land models in integrated or standalone modes.
https://github.com/clima/climaland.jl

Category: Natural Resources
Sub Category: Soil and Land

Keywords

climate climate-modeling earth-system-model gpu hydrology julia land land-surface-model machine-learning scientific-computing snow soil vegetation

Keywords from Contributors

data-assimilation atmospheric-modeling pde dynamical-core finite-difference numerical-methods spectral-elements atmospheric-science climate-model climate-change

Last synced: about 19 hours ago
JSON representation

Repository metadata

Modular, GPU-capable land surface model of the CliMA Earth System Model, designed for data-driven parameterizations

README.md

Documentation dev
GHA CI gha ci
Code Coverage codecov
Downloads downloads

Introduction

This is the repository of the CliMA land model code. Here are some notable features:

  • ClimaLand has a modular design, models can be run as standalone (e.g., soil moisture/energy only) or integrated (e.g., soil moisture/energy AND canopy AND snow, etc.)
  • ClimaLand can simulate single columns, regional boxes, and global runs
  • ClimaLand is CPU and GPU compatible
  • ClimaLand welcomes contributions! Please feel free to reach out to us with questions about how to get started, create a branch, and extend our code.

For more information, read our manuscript: Deck, Katherine, et al. "ClimaLand: A land surface model designed to enable data‐driven parameterizations." Journal of Advances in Modeling Earth Systems 18.1 (2026): e2025MS005118.

Installation

To use ClimaLand.jl, first you need to install Julia.
Then, you can install ClimaLand.jl by doing:

julia> using Pkg
julia> Pkg.add("ClimaLand")

You are now ready to use ClimaLand.jl.
To run a simple first simulation, please see our documentation page Running your first simulation.

Models

In our code base, a "model" define a set of prognostic variables which must be timestepped. The equations which govern the time evolution likely contain parameters and are informed by parameterization and physical domain choices. Any ClimaLand model contains all of the information needed to evaluate these equations. Below are the current models we support:

Component Models:

  • RichardsModel: Soil model option; runnable only in standalone mode

  • EnergyHydrology: Soil model option; runnable in standalone mode, or as part of an integrated model

  • CanopyModel: runnable in standalone mode, or as part of an integrated model

  • SnowModel: runnable in standalone mode, or as part of an integrated model

  • SoilCO2Model: runnable in standalone mode, or as part of an integrated model. Please note that this model is in beta version.

Combined Models:

  • SoilCanopyModel: an integrated model made of individual component models EnergyHydrology + CanopyModel
  • LandModel: an integrated model made of individual component models EnergyHydrology + CanopyModel + SnowModel + SoilCO2Model

Notes

Recommended Julia Version: Stable release v1.12.x. CI tests Julia v1.10 and 1.12.

ClimaLand.jl is a different model from the original CliMA Land,
which aims to utilize remote sensing data through more complex canopy RT
and plant physiology modules. For more details, please refer to
https://github.com/CliMA/Land.

  • Wang, Yujie, et al. "Testing stomatal models at the stand level in deciduous angiosperm and evergreen gymnosperm forests using CliMA Land (v0. 1)." Geoscientific Model Development 14.11 (2021): 6741-6763.
  • R. K. Braghiere, Y. Wang, R. Doughty, D. Souza, T. Magney, J. Widlowski, M. Longo, A. Bloom, J. Worden, P. Gentine, and C. Frankenberg. 2021. Accounting for canopy structure improves hyperspectral radiative transfer and sun-induced chlorophyll fluorescence representations in a new generation Earth System model. Remote Sensing of Environment. 261: 112497.
  • Wang, Yujie, and Christian Frankenberg. "On the impact of canopy model complexity on simulated carbon, water, and solar-induced chlorophyll fluorescence fluxes." Biogeosciences 19.1 (2022): 29-45.
  • Wang, Yujie, et al. "GriddingMachine, a database and software for Earth system modeling at global and regional scales." Scientific data 9.1 (2022): 258.
  • Holtzman, Nataniel, et al. "Constraining plant hydraulics with microwave radiometry in a land surface model: Impacts of temporal resolution." Water Resources Research 59.11 (2023): e2023WR035481.
  • Braghiere, R. K., Wang, Y., Gagné-Landmann, A., Brodrick, P. G., Bloom, A. A., Norton, A. J., Ma, S., Levine, P., Longo, M., Deck, K., Gentine, P., Worden, J. R., Frankenberg, C., & Schneider, T. (2023). The Importance of Hyperspectral Soil Albedo Information for Improving Earth System Model Projections. AGU Advances, 4(4), e2023AV000910. link
  • Wang, Y., Braghiere, R. K., Yin, Y., Yao, Y., Hao, D., & Frankenberg, C. (2024). Beyond the visible: Accounting for ultraviolet and far-red radiation in vegetation productivity and surface energy budgets. Global Change Biology, 30(5), e17346. link

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 3 days ago

Total Commits: 1,155
Total Committers: 37
Avg Commits per committer: 31.216
Development Distribution Score (DDS): 0.68

Commits in past year: 361
Committers in past year: 24
Avg Commits per committer in past year: 15.042
Development Distribution Score (DDS) in past year: 0.731

Name Email Commits
kmdeck k****k@c****u 370
Julia Sloan j****n@c****u 215
Gabriele Bozzola s****r@g****m 126
Kevin Phan 9****v 123
AlexisRenchon a****n@g****m 83
imreddyTeja t****5@g****m 82
nefrathenrici n****i@g****m 17
Edward Speer e****r@c****u 16
Renato Braghiere r****e@g****m 15
Andy Charbonneau a****n@c****u 13
Yuchen Li y****i@s****u 10
Charles Kawczynski k****s@g****m 10
Ben Mackay j****y@c****u 8
dependabot[bot] 4****] 8
Tapio Schneider t****o@c****u 7
Valeria Barra v****1@g****m 7
CompatHelper Julia c****y@j****g 6
Zhaoyi Shen 1****1 4
akshaysridhar a****r@c****u 4
Gabriele Bozzola g****a@c****u 4
Anna GL g****a@g****m 3
Anna Jaruga a****a@c****u 3
nicobartolomeo n****2@u****u 2
costachris c****a@g****m 2
ThanhNguyen428 t****4@g****m 2
Simon Byrne s****e@g****m 2
Kaitlyn Alphonse k****e@e****m 2
Dennis Yatunin d****n@g****m 2
Cheikh Mbengue c****e@w****g 1
Gregory L. Wagner g****r@g****m 1
and 7 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 360
Total pull requests: 1,285
Average time to close issues: 4 months
Average time to close pull requests: 14 days
Total issue authors: 18
Total pull request authors: 31
Average comments per issue: 0.91
Average comments per pull request: 0.97
Merged pull request: 760
Bot issues: 0
Bot pull requests: 50

Past year issues: 65
Past year pull requests: 224
Past year average time to close issues: 19 days
Past year average time to close pull requests: 7 days
Past year issue authors: 10
Past year pull request authors: 18
Past year average comments per issue: 0.26
Past year average comments per pull request: 0.57
Past year merged pull request: 91
Past year bot issues: 0
Past year bot pull requests: 15

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/clima/climaland.jl

Top Issue Authors

  • kmdeck (119)
  • juliasloan25 (89)
  • AlexisRenchon (45)
  • Sbozzolo (33)
  • imreddyTeja (25)
  • ph-kev (13)
  • ychnli (9)
  • jb-mackay (5)
  • waywardpidgeon (5)
  • Espeer5 (4)
  • odunbar (3)
  • charleskawczynski (3)
  • a-charbon (2)
  • gagnelandmanna (1)
  • LenkaNovak (1)

Top Pull Request Authors

  • kmdeck (510)
  • juliasloan25 (174)
  • AlexisRenchon (160)
  • Sbozzolo (111)
  • imreddyTeja (97)
  • ph-kev (55)
  • github-actions[bot] (41)
  • Espeer5 (20)
  • mitraA90 (16)
  • a-charbon (15)
  • nefrathenrici (13)
  • charleskawczynski (9)
  • dependabot[bot] (9)
  • ychnli (9)
  • ThanhNguyen428 (8)

Top Issue Labels

  • enhancement (159)
  • bug (63)
  • SDI (28)
  • documentation (11)
  • good first issue (8)
  • performance (5)
  • AMIP (4)
  • Calibration (3)
  • Continuous integration :gear: (3)
  • LSMv1 (2)
  • ClimaLandSimulations (2)
  • manuscript (2)
  • software clarity (2)
  • Run long runs (2)
  • GPU (2)
  • Visualization (1)
  • Diagnostics (1)
  • dependencies (1)
  • API (1)
  • Run benchmarks (1)

Top Pull Request Labels

  • Run long runs (184)
  • Run benchmarks (103)
  • enhancement (47)
  • breaking change (23)
  • Launch Buildkite (21)
  • documentation (13)
  • Diagnostics (10)
  • bug (10)
  • LSMv1 (10)
  • dependencies (9)
  • AMIP (7)
  • Run test calibration (7)
  • performance (6)
  • software clarity (6)
  • API (5)
  • Continuous integration :gear: (5)
  • github_actions (4)
  • Calibration (4)
  • bugfix (3)
  • Visualization (2)
  • long run opt lai (1)
  • GPU (1)

Package metadata

juliahub.com: ClimaLand

  • Homepage:
  • Documentation: https://docs.juliahub.com/General/ClimaLand/stable/
  • Licenses: apache-2.0
  • Latest release: 0.16.2 (published over 1 year ago)
  • Last Synced: 2026-03-24T16:32:15.888Z (5 months ago)
  • Versions: 35
  • Dependent Packages: 1
  • Dependent Repositories: 0
  • Downloads: 3,281 Last month
  • Rankings:
    • Dependent repos count: 9.832%
    • Average: 24.71%
    • Dependent packages count: 39.587%

Dependencies

.github/workflows/JuliaFormatter.yml actions
  • actions/checkout v2.2.0 composite
  • dorny/paths-filter v2.9.1 composite
  • julia-actions/setup-julia latest composite
  • styfle/cancel-workflow-action 0.4.0 composite
.github/workflows/TagBot.yml actions
  • JuliaRegistries/TagBot v1 composite
.github/workflows/ci.yml actions
  • actions/cache v1 composite
  • actions/checkout v2 composite
  • codecov/codecov-action v1 composite
  • julia-actions/julia-buildpkg v1 composite
  • julia-actions/julia-processcoverage v1 composite
  • julia-actions/julia-runtest v1 composite
  • julia-actions/setup-julia v1 composite
.github/workflows/docs.yml actions
  • actions/checkout v2 composite
  • julia-actions/setup-julia latest composite
.github/workflows/CompatHelper.yml actions
.github/workflows/downstream.yml actions
  • actions/cache v4 composite
  • actions/checkout v5 composite
  • julia-actions/julia-buildpkg v1 composite
  • julia-actions/setup-julia v2 composite
docs/Manifest.toml julia
  • 486 dependencies
.buildkite/Manifest.toml julia
  • 455 dependencies
Project.toml julia
  • Adapt *
  • ClimaComms *
  • ClimaCore *
  • ClimaDiagnostics *
  • ClimaParams *
  • ClimaTimeSteppers *
  • ClimaUtilities *
  • Dates *
  • DocStringExtensions *
  • Insolation *
  • Interpolations *
  • LazyArtifacts *
  • LazyBroadcast *
  • LinearAlgebra *
  • NCDatasets *
  • RootSolvers *
  • SciMLBase *
  • StaticArrays *
  • SurfaceFluxes *
  • Thermodynamics *
.github/workflows/DocCleanup.yml actions
  • actions/checkout v5 composite
.github/workflows/cla.yml actions
.github/workflows/downgrade.yml actions
  • actions/cache v4 composite
  • actions/checkout v5 composite
  • julia-actions/julia-buildpkg latest composite
  • julia-actions/julia-downgrade-compat v2 composite
  • julia-actions/julia-runtest latest composite
  • julia-actions/setup-julia latest composite
.buildkite/Project.toml julia
  • Aqua *
  • ArgParse *
  • BSON *
  • CSV *
  • CUDA *
  • CairoMakie *
  • ClimaAnalysis *
  • ClimaCalibrate *
  • ClimaComms *
  • ClimaCore *
  • ClimaCoreMakie *
  • ClimaDiagnostics *
  • ClimaLand *
  • ClimaParams *
  • ClimaTimeSteppers *
  • ClimaUtilities *
  • DataFrames *
  • Dates *
  • DelimitedFiles *
  • EnsembleKalmanProcesses *
  • Flux *
  • Format *
  • GeoMakie *
  • HTTP *
  • Insolation *
  • Interpolations *
  • JLD2 *
  • JSON *
  • LazyArtifacts *
  • LinearAlgebra *
  • MPI *
  • NCDatasets *
  • NLsolve *
  • Printf *
  • ProfileCanvas *
  • RootSolvers *
  • SafeTestsets *
  • SciMLBase *
  • StaticArrays *
  • Statistics *
  • StatsBase *
  • SurfaceFluxes *
  • TOML *
  • Test *
  • Thermodynamics *
test/Project.toml julia
  • Aqua *
  • Artifacts *
  • BSON *
  • CSV *
  • ClimaAnalysis *
  • ClimaComms *
  • ClimaCore *
  • ClimaDiagnostics *
  • ClimaLand *
  • ClimaParams *
  • ClimaTimeSteppers *
  • ClimaUtilities *
  • DataFrames *
  • Dates *
  • DelimitedFiles *
  • Flux *
  • HTTP *
  • Insolation *
  • Interpolations *
  • LazyArtifacts *
  • LinearAlgebra *
  • NCDatasets *
  • NLsolve *
  • Pkg *
  • Random *
  • SafeTestsets *
  • SciMLBase *
  • StaticArrays *
  • Statistics *
  • StatsBase *
  • SurfaceFluxes *
  • Test *
  • Thermodynamics *
docs/Project.toml julia
  • AbstractTrees *
  • BSON *
  • CSV *
  • CairoMakie *
  • ClimaAnalysis *
  • ClimaComms *
  • ClimaCore *
  • ClimaDiagnostics *
  • ClimaLand *
  • ClimaParams *
  • ClimaTimeSteppers *
  • ClimaUtilities *
  • DataFrames *
  • Dates *
  • DiffEqBase *
  • Distributed *
  • Documenter *
  • DocumenterCitations *
  • DocumenterInterLinks *
  • EnsembleKalmanProcesses *
  • Flux *
  • Format *
  • GeoMakie *
  • HTTP *
  • Insolation *
  • InteractiveUtils *
  • Interpolations *
  • JSON *
  • Literate *
  • MethodAnalysis *
  • Plots *
  • PrettyTables *
  • Roots *
  • SciMLBase *
  • SpecialFunctions *
  • StaticArrays *
  • StatsBase *
  • SurfaceFluxes *
  • Thermodynamics *

Score: 16.980125742858007