Skip to content

CliMA/Land

Repository files navigation

CliMA Land

About

CliMA Land is a next generation Land Surface Model (LSM) designed to use the broadly available remote sensing data as well as ground-based flux measurements. CliMA Land is a highly modular platform to promote research at different scales from tissue to organ, whole plant, and ecosystem. Therefore, we deliver CliMA Land via a patch of packages (also referred to as sub-modules) to reduce the time used to initialize a research project. As a result, the repository is more a collection of tutorials and examples for users, rather than a place to store the code for all sub-modules.

This project is supposed to be a community effort, leveraging all the work that has been done in Land Surface Modeling from various groups around the world. The ultimate goal is to build a bio-physical model that represents the state of the art and can be coupled to the CliMA Earth System Model (ESM), i.e. Caltech's CliMA initiative. The CliMA Land can be customized to represent Soil-Plant-Air-Continuum (SPAC) with different complexities, e.g. multi-layer soil and canopy properties and "observables" that can be used as constraint:

  • Solar Induced Chlorophyll Fluorescence (SIF) on the leaf-level propagated through the canopy;
  • Reflectance at various bands as measured from space;
  • Soil and vegetation moisture content.

A specific focus of CliMA Land will be on water-carbon feedbacks by testing recent developments in optimization theories as well as plant physiology. We will try to implement latest adhere to some coding structure developed by Gordan Bonan but implement parts from other programs, such as SCOPE.

The entire model will be written in Julia (Julia: "Looks like Python, feels like Lisp, runs like Fortran"), which should make the barrier of entry lower for incoming students, PostDocs, etc). If you want to contribute, please contact us (cfranken@caltech.edu).

Fluorescence from Space

Land model

Docs Build docs build
Documentation dev
Unit Test unit test
Code Coverage codecov
Bors Bors enabled

Examples

Run CliMA Land for a single site (v0.1)

See https://github.com/CliMA/Land/tree/v0.1 for examples of CliMA Land v0.1.

References

Please cite the following when you use the CliMA Land (v0.1)

General model description

Y. Wang, P. Köhler, L. He, R. K. Braghiere, R. Doughty, J. Wood, C. Frankenberg. 2021. Testing stomatal models at the stand level in deciduous angiosperm and evergreen gymnosperm forests using CliMA Land (v0.1). Geoscientific Model Development. 14(11): 6741-6763. DOI PDF SI CODE

@article{wang2021testing,
    author = {Wang, Y. and K{\"o}hler, P. and He, L. and Doughty, R. and Braghiere, R. K. and Wood, J. D. and Frankenberg, C.},
    year = {2021},
    title = {Testing stomatal models at the stand level in deciduous angiosperm and evergreen gymnosperm forests using CliMA Land (v0.1)},
    journal = {Geoscientific Model Development},
    volume = {14},
    number = {11},
    pages = {6741--6763}
}

Clumping index implementation

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. DOI PDF SI CODE

@article{braghiere2021accounting,
    author = {Braghiere, Renato K and Wang, Yujie and Doughty, Russell and Sousa, Daniel and Magney, Troy and Widlowski, Jean-Luc and Longo, Marcos and Bloom, A Anthony and Worden, John and Gentine, Pierre and Frankenberg, Christian},
    year = {2021},
    title = {Accounting for canopy structure improves hyperspectral radiative transfer and sun-induced chlorophyll fluorescence representations in a new generation Earth System model},
    journal = {Remote Sensing of Environment},
    volume = {261},
    pages = {112497}
}

Canopy complexity

Y. Wang, C. Frankenberg. 2022. On the impact of canopy model complexity on simulated carbon, water, and solar-induced chlorophyll fluorescence fluxes. Biogeosciences. 19(1): 29-45. DOI PDF CODE

 @article{wang2022impact,
 	author = {Wang, Y. and Frankenberg, C.},
 	year = {2022},
 	title = {On the impact of canopy model complexity on simulated carbon, water, and solar-induced chlorophyll fluorescence fluxes},
 	journal = {Biogeosciences},
 	volume = {19},
 	number = {1},
 	pages = {29--45}
 }