|
1 | | -# eCLM Documentation |
| 1 | +# Welcome to eCLM! |
2 | 2 |
|
3 | | -```{important} |
4 | | -**Welcome!** You are viewing the first version of the documentation for eCLM. This is a living document, which means it will be continuously updated and improved. Please check back regularly for the latest information and updates. |
| 3 | +eCLM is based on version 5.0 of the Community Land Model ([CLM5](https://www.cesm.ucar.edu/models/clm)) The Community Land Model is the land model for the Community Earth System Model (CESM). It focuses on modeling the land as the critical interface through which humanity affects, adapts to, and mitigates global environmental change. It includes a comprehensive representation of land biogeophysics, hydrology, plant physiology, biogeochemistry, anthropogenic land use, and ecosystem dynamics across a variety of spatial and temporal scales. The central theme is that terrestrial ecosystems, through their cycling of energy, water, chemical elements, and trace gases, are important determinants of climate. |
| 4 | + |
| 5 | +## Difference with CLM5 |
| 6 | + |
| 7 | +eCLM has simplified infrastructure for build and namelist generation. The build system is handled entirely by CMake and namelists are generated through a small set of Python scripts. Similar to CLM5, eCLM is forced with meteorological data and uses numerous input streams on soil properties, land cover and land use, as well as complex parameter sets on crop phenology, and plant hydraulics for simulations. |
| 8 | + |
| 9 | +## Biogeophysical and Biogeochemical Processes |
| 10 | + |
| 11 | +eCLM, like [CLM5](https://escomp.github.io/CTSM/release-clm5.0/tech_note/Introduction/CLM50_Tech_Note_Introduction.html#biogeophysical-and-biogeochemical-processes), represents several aspects of the land surface including surface heterogeneity and consists of components or submodels related to land biogeophysics, the hydrologic cycle, biogeochemistry, human dimensions, and ecosystem dynamics. Specific processes that are represented include: |
| 12 | + |
| 13 | +- Vegetation composition, structure, and phenology |
| 14 | +- Absorption, reflection, and transmittance of solar radiation |
| 15 | +- Absorption and emission of longwave radiation |
| 16 | +- Momentum, sensible heat (ground and canopy), and latent heat (ground evaporation, canopy evaporation, transpiration) fluxes |
| 17 | +- Heat transfer in soil and snow including phase change |
| 18 | +- Canopy hydrology (interception, throughfall, and drip) |
| 19 | +- Snow hydrology (snow accumulation and melt, compaction, water transfer between snow layers) |
| 20 | +- Soil hydrology (surface runoff, infiltration, redistribution of water within the column, sub-surface drainage, groundwater) |
| 21 | +- Plant hydrodynamics |
| 22 | +- Stomatal physiology and photosynthesis |
| 23 | +- Lake temperatures and fluxes |
| 24 | +- Dust deposition and fluxes |
| 25 | +- Routing of runoff from rivers to ocean |
| 26 | +- Volatile organic compounds emissions |
| 27 | +- Urban energy balance and climate |
| 28 | +- Carbon-nitrogen cycling |
| 29 | +- Dynamic landcover change |
| 30 | +- Land management including crops and crop management and wood harvest |
| 31 | +- Ecosystem Demography (FATES, optional) |
| 32 | + |
| 33 | +```{figure} users_guide/images/CLM5_processes_Lawrence2019.png |
| 34 | +:height: 400px |
| 35 | +:name: fig1 |
| 36 | +
|
| 37 | +Overview of land biogeophysical, biogeochemical and landscape processes simulated by eCLM, which is the same as CLM5. <a href="http://dx.doi.org/10.1029/2018MS001583" target="_blank">Lawrence et al. (2019)</a>. |
5 | 38 | ``` |
6 | 39 |
|
7 | | -eCLM is based on version 5.0 of the Community Land Model ([CLM5](https://www.cesm.ucar.edu/models/clm)) with simplified infrastructure for build and namelist generation. The build system is handled entirely by Cmake and namelists are generated through a small set of Python scripts. Similar to CLM5, eCLM is forced with meteorological data and uses numerous input streams on soil properties, land cover and land use, as well as complex parameter sets on crop phenology, and plant hydraulics for simulations. |
| 40 | +Each time step the model solves the surface energy balance, water balance, and carbon exchange. Submodels of CLM include biophysics and biogeochemistry. It represents land surface heterogeneity through a subgrid tiling structure and different plant functional types that have unique parameters in terms of optical properties, morphology, photosynthesis. It can be run with prescribed vegetation states using satelllite phenology (SP mode) or prognostic vegetation states and biogeochemistry (BGC mode). |
| 41 | + |
| 42 | +```{figure} users_guide/images/CLM5_subgrid_structure_v1.png |
| 43 | +:height: 400px |
| 44 | +:name: fig2 |
| 45 | +
|
| 46 | +Configuration of the CLM subgrid hierarchy. Box in upper right shows hypothetical subgrid distribution for a single grid cell. Note that the Crop land unit is only used when the model is run with the crop model active. Abbreviations: TBD – Tall Building District; HD – High Density; MD – Medium Density, G – Glacier, L – Lake, U – Urban, C – Crop, V – Vegetated, PFT – Plant Functional Type, Irr – Irrigated, UIrr – Unirrigated. Red arrows indicate allowed land unit transitions. Purple arrows indicate allowed patch-level transitions. From <a href="https://escomp.github.io/ctsm-docs/versions/release-clm5.0/html/tech_note/Ecosystem/CLM50_Tech_Note_Ecosystem.html#id14" target="_blank">CLM5 Technical Note</a>. |
| 47 | +``` |
8 | 48 |
|
0 commit comments