From deff1665080ebdaf7366449714d7952e6920f2b9 Mon Sep 17 00:00:00 2001 From: AlexisRenchon Date: Wed, 26 Jun 2024 13:55:23 -0700 Subject: [PATCH] Update README The old readme was not well structured and missing some info. This PR is a first step to clean things. --- README.md | 71 ++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 44 insertions(+), 27 deletions(-) diff --git a/README.md b/README.md index 3125c38bf3..3900aacf92 100644 --- a/README.md +++ b/README.md @@ -8,45 +8,59 @@ component) or standalone (single component) modes.

-[![Downloads](https://img.shields.io/badge/dynamic/json?url=http%3A%2F%2Fjuliapkgstats.com%2Fapi%2Fv1%2Ftotal_downloads%2FClimaLand&query=total_requests&suffix=%2Ftotal&label=Downloads)](http://juliapkgstats.com/pkg/ClimaLand) +
-Recommended Julia Version: Stable release v1.10.0. CI no longer tests earlier -versions of Julia. +||| +|---------------------:|:----------------------------------------------| +| **Documentation** | [![dev][docs-dev-img]][docs-dev-url] | +| **GHA CI** | [![gha ci][gha-ci-img]][gha-ci-url] | +| **Code Coverage** | [![codecov][codecov-img]][codecov-url] | +| **Downloads** | [![downloads][downloads-img]][downloads-url] | -Certain features, including global runs, are not currently available on -Windows due to limitations with our regridding software. +
-Note that 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. +# ClimaLand.jl + +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 only) or integrated (e.g., soil moisture and energy AND canopy AND snow, etc.) +- ClimaLand is CPU and GPU compatible +- ClimaLand welcome contributions: please feel free to reach out to us with questions about how to get started, create a branch, and extend our code. For example, a modeler might want to test a new stomatal conductance model. +- ClimaLand provides APIs and UIs at multiple levels. ## Models -Component Models: -RichardsModel <: AbstractSoilModel <: AbstractImExModel <: AbstractModel [runnable w/o LandModel wrapper as well] +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: -EnergyHydrologyModel <: AbstractSoilModel <: AbstractImExModel <: AbstractModel [runnable w/o LandModel wrapper as well] + Component Models: -CanopyModel <: AbstractVegetationModel <: AbstractExpModel <: AbstractModel [runnable w/o LandModel wrapper as well] +- RichardsModel <: AbstractSoilModel <: AbstractModel (runnable only in standalone mode) -SnowModel <: AbstractSnowModel <: AbstractExpModel <: AbstractModel [runnable w/o LandModel wrapper as well] +- EnergyHydrologyModel <: AbstractSoilModel <: AbstractModel (runnable in standalone mode, or as part of a land model) -Combined Models: +- CanopyModel <: AbstractVegetationModel <: AbstractModel (runnable in standalone mode, or as part of a land model) -SoilCanopyModel <: AbstractLandModel <: AbstractImExModel <: AbstractModel (constructs the individual ComponentModels based on arguments) +- SnowModel <: AbstractSnowModel <: AbstractModel (runnable in standalone mode, or as part of a land model) -||| -|---------------------:|:----------------------------------------------| -| **Docs Build** | [![docs build][docs-bld-img]][docs-bld-url] | -| **Documentation** | [![dev][docs-dev-img]][docs-dev-url] | -| **GHA CI** | [![gha ci][gha-ci-img]][gha-ci-url] | -| **Code Coverage** | [![codecov][codecov-img]][codecov-url] | + Combined Models: + +- SoilCanopyModel <: AbstractLandModel <: AbstractModel (an example of a land model, made of individual component models which are solved simultaneously but taking into account interactions between the components) + +## Notes + +Recommended Julia Version: Stable release v1.10.0. CI no longer tests earlier +versions of Julia. + +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](https://doi.org/10.1029/2023AV000910) +- 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](https://doi.org/10.1111/GCB.17346) [docs-bld-img]: https://github.com/CliMA/ClimaLand.jl/actions/workflows/docs.yml/badge.svg [docs-bld-url]: https://github.com/CliMA/ClimaLand.jl/actions/workflows/docs.yml @@ -59,3 +73,6 @@ SoilCanopyModel <: AbstractLandModel <: AbstractImExModel <: AbstractModel (cons [codecov-img]: https://codecov.io/gh/CliMA/ClimaLand.jl/branch/main/graph/badge.svg [codecov-url]: https://codecov.io/gh/CliMA/ClimaLand.jl + +[downloads-img]: https://img.shields.io/badge/dynamic/json?url=http%3A%2F%2Fjuliapkgstats.com%2Fapi%2Fv1%2Ftotal_downloads%2FClimaLand&query=total_requests&suffix=%2Ftotal&label=Downloads +[downloads-url]: http://juliapkgstats.com/pkg/ClimaLand