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 gpu julia land land-surface-model

Keywords from Contributors

data-assimilation climate-change ocean earth-observation canopy fluorescence sif soil-plant-atmosphere climate-model ocean-modelling

Last synced: about 24 hours ago
JSON representation

Repository metadata

Clima's Land Model

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: 22 days ago

Total Commits: 1,096
Total Committers: 35
Avg Commits per committer: 31.314
Development Distribution Score (DDS): 0.675

Commits in past year: 377
Committers in past year: 22
Avg Commits per committer in past year: 17.136
Development Distribution Score (DDS) in past year: 0.69

Name Email Commits
kmdeck k****k@c****u 356
Julia Sloan j****n@c****u 215
Gabriele Bozzola s****r@g****m 126
Kevin Phan 9****v 117
AlexisRenchon a****n@g****m 73
imreddyTeja t****5@g****m 66
nefrathenrici n****i@g****m 17
Edward Speer e****r@c****u 16
Renato Braghiere r****e@g****m 14
Andy Charbonneau a****n@c****u 13
Charles Kawczynski k****s@g****m 10
Yuchen Li y****i@s****u 10
Ben Mackay j****y@c****u 8
Valeria Barra v****1@g****m 7
CompatHelper Julia c****y@j****g 5
dependabot[bot] 4****] 5
Tapio Schneider t****o@c****u 4
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
Simon Byrne s****e@g****m 2
ThanhNguyen428 t****4@g****m 2
costachris c****a@g****m 2
github-actions[bot] 4****] 1
emarkows e****s@c****u 1
Sarah s****a@b****u 1
Pete Bachant p****t@c****u 1
Olivier Bonte 6****e 1
and 5 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 29 days ago

Total issues: 336
Total pull requests: 1,252
Average time to close issues: 4 months
Average time to close pull requests: 14 days
Total issue authors: 17
Total pull request authors: 29
Average comments per issue: 0.93
Average comments per pull request: 0.96
Merged pull request: 742
Bot issues: 0
Bot pull requests: 47

Past year issues: 87
Past year pull requests: 308
Past year average time to close issues: 18 days
Past year average time to close pull requests: 5 days
Past year issue authors: 8
Past year pull request authors: 17
Past year average comments per issue: 0.29
Past year average comments per pull request: 0.47
Past year merged pull request: 140
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 (108)
  • juliasloan25 (89)
  • AlexisRenchon (34)
  • Sbozzolo (33)
  • imreddyTeja (25)
  • ph-kev (13)
  • ychnli (9)
  • waywardpidgeon (5)
  • jb-mackay (5)
  • Espeer5 (4)
  • charleskawczynski (3)
  • a-charbon (2)
  • odunbar (2)
  • LenkaNovak (1)
  • gagnelandmanna (1)

Top Pull Request Authors

  • kmdeck (502)
  • juliasloan25 (173)
  • AlexisRenchon (150)
  • Sbozzolo (111)
  • imreddyTeja (94)
  • ph-kev (52)
  • github-actions[bot] (38)
  • Espeer5 (20)
  • mitraA90 (16)
  • a-charbon (15)
  • nefrathenrici (13)
  • charleskawczynski (9)
  • ychnli (9)
  • dependabot[bot] (9)
  • ThanhNguyen428 (8)

Top Issue Labels

  • enhancement (156)
  • bug (61)
  • SDI (28)
  • documentation (11)
  • good first issue (8)
  • performance (4)
  • 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 (182)
  • Run benchmarks (103)
  • enhancement (47)
  • breaking change (23)
  • documentation (13)
  • bug (10)
  • Diagnostics (10)
  • LSMv1 (10)
  • dependencies (9)
  • AMIP (7)
  • Run test calibration (6)
  • performance (6)
  • software clarity (6)
  • API (5)
  • Continuous integration :gear: (5)
  • github_actions (4)
  • Calibration (4)
  • bugfix (3)
  • Visualization (2)
  • 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 about 1 year ago)
  • Last Synced: 2026-03-24T16:32:15.888Z (3 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
docs/src/standalone/Project.toml julia
  • Bonito *
  • ClimaLand *
  • ClimaLandSimulations *
  • ClimaParams *
  • ParamViz *
  • Unitful *
.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.82770606571328