Joint UK Land Environment Simulator (JULES) User Guide

The Joint UK Land Environment Simulator (JULES) is a computer model that simulates many soil and vegetation processes. This guide primarily describes the format of the input and output files, and does not include detailed descriptions of the science and representation of the processes in the model.

The first version of JULES was based on the Met Office Surface Exchange System (MOSES), the land surface model used in the Unified Model (UM) of the UK Met Office. After that initial split, the MOSES and JULES code bases evolved separately, but with JULES v2.1 these differences were reconciled with the UM. As of JULES v3.1, a single code repository is used for both standalone JULES and JULES in the UM.

Further information can be found on the JULES website: http://jules.jchmr.org/.

• 1. Release notes for JULES
  • 1.1. JULES version 7.0 Release Notes
  • 1.2. JULES version 6.3 Release Notes
  • 1.3. JULES version 6.2 Release Notes
  • 1.4. JULES version 6.1 Release Notes
  • 1.5. JULES version 6.0 Release Notes
  • 1.6. JULES version 5.9 Release Notes
  • 1.7. JULES version 5.8 Release Notes
  • 1.8. JULES version 5.7 Release Notes
  • 1.9. JULES version 5.6 Release Notes
  • 1.10. JULES version 5.5 Release Notes
  • 1.11. JULES version 5.4 Release Notes
  • 1.12. JULES version 5.3 Release Notes
  • 1.13. JULES version 5.2 Release Notes
  • 1.14. JULES version 5.1 Release Notes
  • 1.15. JULES version 5.0 Release Notes
  • 1.16. JULES version 4.9 Release Notes
  • 1.17. JULES version 4.8 Release Notes
  • 1.18. JULES version 4.7 Release Notes
  • 1.19. JULES version 4.6 Release Notes
  • 1.20. JULES version 4.5 Release Notes
  • 1.21. JULES version 4.4 Release Notes
  • 1.22. JULES version 4.3 Release Notes
  • 1.23. JULES version 4.2 Release Notes
  • 1.24. JULES version 4.1 Release Notes
  • 1.25. JULES version 4.0 Release Notes
  • 1.26. JULES version 3.4 Release Notes
  • 1.27. JULES version 3.3 Release Notes
  • 1.28. JULES version 3.2 Release Notes
  • 1.29. JULES version 3.1 Release Notes
  • 1.30. JULES version 3.0 Release Notes
  • 1.31. JULES version 2.2 Release Notes
  • 1.32. JULES version 2.1 Release Notes
  • 1.33. JULES version 2.0 Release Notes
  • 1.34. JULES version 1.0
• 2. Overview of JULES
  • 2.1. Overview
  • 2.2. Some key switches
• 3. Building and running JULES
  • 3.1. Considerations
  • 3.2. Required software
  • 3.3. Building JULES using FCM
  • 3.4. Running JULES
  • 3.5. Automatic upgrading and GUI using Rose
• 4. Input files for JULES
  • 4.1. General principles
  • 4.2. ASCII files
  • 4.3. NetCDF files
  • 4.4. File name templating
  • 4.5. Temporal interpolation
• 5. JULES output
  • 5.1. Associating output values with the correct time
  • 5.2. Initial data
  • 5.3. Dump files
• 6. The JULES namelist files
  • 6.1. Introduction to Fortran namelists
  • 6.2. jules_prnt_control.nml
  • 6.3. jules_surface_types.nml
  • 6.4. cable_surface_types.nml
  • 6.5. model_environment.nml
  • 6.6. jules_surface.nml
  • 6.7. jules_radiation.nml
  • 6.8. jules_hydrology.nml
  • 6.9. jules_soil.nml
  • 6.10. jules_vegetation.nml
  • 6.11. jules_soil_biogeochem.nml
  • 6.12. jules_soil_ecosse.nml
  • 6.13. jules_deposition.nml
  • 6.14. jules_snow.nml
  • 6.15. jules_rivers.nml
  • 6.16. jules_water_resources.nml
  • 6.17. jules_irrig.nml
  • 6.18. science_fixes.nml
  • 6.19. timesteps.nml
  • 6.20. model_grid.nml
  • 6.21. ancillaries.nml
  • 6.22. cable_prognostics.nml
  • 6.23. pft_params.nml
  • 6.24. cable_pftparm.nml
  • 6.25. nveg_params.nml
  • 6.26. cable_soilparm.nml
  • 6.27. crop_params.nml
  • 6.28. triffid_params.nml
  • 6.29. urban.nml
  • 6.30. fire.nml
  • 6.31. drive.nml
  • 6.32. imogen.nml
  • 6.33. prescribed_data.nml
  • 6.34. initial_conditions.nml
  • 6.35. output.nml
• 7. JULES examples
• 8. Aspects of the code
  • 8.1. I/O framework
  • 8.2. Known limitations of the code
• 9. JULES Output variables
  • 9.1. Meteorology
  • 9.2. Radiation
  • 9.3. Energy and momentum fluxes, and surface temperatures
  • 9.4. Soil moisture and temperature, and soil characteristics
  • 9.5. Hydrology
  • 9.6. Rivers
  • 9.7. Snow
  • 9.8. Vegetation carbon and related fluxes
  • 9.9. Vegetation nitrogen and related fluxes
  • 9.10. Soil carbon and related fluxes
  • 9.11. Soil nitrogen and related fluxes
  • 9.12. Fire
  • 9.13. Crops
  • 9.14. Trace gas concentrations and fluxes
  • 9.15. Water resources
  • 9.16. Urban
  • 9.17. IMOGEN
  • 9.18. Grid and indexing variables