Home page

Introduction

Welcome to the new documentation system for the ORCHIDEE Land Surface Model. We have moved from a monolithic PDF (Overleaf) to a modular HTML site generated by Sphinx.

Read the Guide: From LaTeX to Sphinx with MyST Markdown to get started.

Table of Contents

• 1. Guide: From LaTeX to Sphinx with MyST Markdown
  • 1.1. Structure and headers
  • 1.2. Mathematics
  • 1.3. Cross-referencing
  • 1.4. Callouts (Admonitions)
  • 1.5. Images and figures
  • 1.6. Footnotes
  • 1.7. Citations (Bibliography)
• 2. References
• 3. DONE: Objectives of ORCHIDEE
• 4. DONE: Structural assumptions
• 5. DONE: Symbolic notation
• 6. DONE: Spatial and temporal discretisation
  • 6.1. DONE: Land surface
  • 6.2. DONE: Vegetation classes
  • 6.3. DONE: Age classes
  • 6.4. DONE: Diameter classes
  • 6.5. DONE: Vertical canopy layers
  • 6.6. DONE: Soil water columns
  • 6.7. DONE: Soil texture classes
  • 6.8. DONE: Vertical soil layers
  • 6.9. DONE: River basins
  • 6.10. DONE: Lakes
  • 6.11. DONE: Elevation, aspect and groundwater depth
  • 6.12. DONE: time steps
• 7. Boundary conditions
  • 7.1. DONE: Soil properties
  • 7.2. DONE: Vegetation distribution
  • 7.3. DONE: 2 forcing
  • 7.4. DONE: Climate forcing
  • 7.5. DONE: Lake properties
  • 7.6. DONE: Routing graphs
  • 7.7. Reservoirs and irrigation
  • 7.8. Slope
  • 7.9. DONE: Nitrogen inputs
  • 7.10. DONE: Forest management
  • 7.11. DONE: Albedo background
  • 7.12. DONE: Litter raking
• 8. The energy budget
  • 8.1. OK: The surface energy budget: principle and main equation
  • 8.2. OK: Radiative transfers
  • 8.3. Surface albedo calculation
  • 8.4. Turbulent transfers
  • 8.5. Sensible heat flux - associated resistance
  • 8.6. Latent heat flux components - associated resistances
  • 8.7. Soil thermodynamics
  • 8.8. Implicit resolution of the energy budget when coupled to LMDZ atmospheric model
  • 8.9. OK: Lakes energy budget
• 9. The water cycle
  • 9.1. Hydrological framework: Water fluxes in the soil - plant - atmosphere continuum
  • 9.2. OK: Canopy interception and througfall
  • 9.3. OK: Water status of plants and water transport inside the vegetation
  • 9.4. OK: Snow and land ice
  • 9.5. Soil evaporation
  • 9.6. Wetlands
  • 9.7. WIP (FK): Soil hydrology
  • 9.8. Routing to the oceans
• 10. The carbon and nitrogen cycle
  • 10.1. DONE: Vegetation phenology
  • 10.2. DONE: Photosynthesis
  • 10.3. DONE: Maintenance respiration
  • 10.4. DONE: Allocation and growth respiration
  • 10.5. DONE: Vegetation characteristics
  • 10.6. DONE: Natural mortality
  • 10.7. DONE: Litter decomposition
  • 10.8. Soil carbon decomposition, nitrogen transformations, and heterotrophic respiration
  • 10.9. DONE: BVOC emissions
  • 10.10. DONE: Vegetation demography
• 11. Land use
  • 11.1. DONE: Land cover change
  • 11.2. Irrigation
  • 11.3. DONE: Crop and grass harvest
  • 11.4. DONE: Forest management
  • 11.5. DONE: Forest PFT and management change
  • 11.6. DONE: Forest litter raking
  • 11.7. DONE: Products use and decay
• 12. OK: Disturbances
  • 12.1. DONE: Drought
  • 12.2. OK: Wind throw
  • 12.3. DONE: Bark beetles
  • 12.4. DONE Fire
  • 12.5. DONE: Herbivory
  • 12.6. DONE: Individual tree vs. stand replacing disturbances
• 13. OK: Quality control and quality assurance of the model code
  • 13.1. DONE: Mass balance checks for carbon and nitrogen
  • 13.2. OK: Water balance checks
  • 13.3. DONE: Surface area checks
  • 13.4. DONE: Technical quality control of the code
• 14. OK: Default model configuration
• 15. Model results for the main outputs
  • 15.1. Results for the energy budget
  • 15.2. Results for the water budget
  • 15.3. Results for the carbon-nitrogen budgets
  • 15.4. Results for land use
• 16. Table: MTC and PFT
• 17. Table: spatial and temporal discretization
• 18. Table: Variable description
  • 18.1. Table: fluxes
  • 18.2. Table: climate
  • 18.3. Table: soil dimensions
  • 18.4. Table: soil and litter mass components
  • 18.5. Table: vegetation dimensions
  • 18.6. Table: vegetation mass components
  • 18.7. Table: vegetation potentials and resistances
  • 18.8. Table: harvest and product pools
  • 18.9. Table: modulators
  • 18.10. Table: fractions
  • 18.11. Table: bark
  • 18.12. Table: calculated parameters
  • 18.13. Table: other
  • 18.14. Table: fire