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 5.7 Release Notes
  • 1.2. JULES version 5.6 Release Notes
  • 1.3. JULES version 5.5 Release Notes
  • 1.4. JULES version 5.4 Release Notes
  • 1.5. JULES version 5.3 Release Notes
  • 1.6. JULES version 5.2 Release Notes
  • 1.7. JULES version 5.1 Release Notes
  • 1.8. JULES version 5.0 Release Notes
  • 1.9. JULES version 4.9 Release Notes
  • 1.10. JULES version 4.8 Release Notes
  • 1.11. JULES version 4.7 Release Notes
  • 1.12. JULES version 4.6 Release Notes
  • 1.13. JULES version 4.5 Release Notes
  • 1.14. JULES version 4.4 Release Notes
  • 1.15. JULES version 4.3 Release Notes
  • 1.16. JULES version 4.2 Release Notes
  • 1.17. JULES version 4.1 Release Notes
  • 1.18. JULES version 4.0 Release Notes
  • 1.19. JULES version 3.4 Release Notes
  • 1.20. JULES version 3.3 Release Notes
  • 1.21. JULES version 3.2 Release Notes
  • 1.22. JULES version 3.1 Release Notes
  • 1.23. JULES version 3.0 Release Notes
  • 1.24. JULES version 2.2 Release Notes
  • 1.25. JULES version 2.1 Release Notes
  • 1.26. JULES version 2.0 Release Notes
  • 1.27. 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_lsm_switch.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. science_fixes.nml
  • 6.17. timesteps.nml
  • 6.18. model_grid.nml
  • 6.19. ancillaries.nml
  • 6.20. pft_params.nml
  • 6.21. nveg_params.nml
  • 6.22. jules_soilparm_cable.nml
  • 6.23. crop_params.nml
  • 6.24. triffid_params.nml
  • 6.25. urban.nml
  • 6.26. fire.nml
  • 6.27. drive.nml
  • 6.28. imogen.nml
  • 6.29. prescribed_data.nml
  • 6.30. initial_conditions.nml
  • 6.31. 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. Variables that have a single value at each gridpoint (land and sea)
  • 9.2. Variables that have a single value at each land gridpoint
  • 9.3. Variables that have a value for each PFT at each land gridpoint
  • 9.4. Variables that have a value for each PFT and each soil biogeochemistry layer at each land gridpoint
  • 9.5. Variables that have a value for each crop PFT at each land grid point
  • 9.6. Variables that have a value for each tile at each land gridpoint
  • 9.7. Variables that have a value for each surface type at each land gridpoint
  • 9.8. Variables that have a value for each soil level at each land gridpoint
  • 9.9. Variables that have a value for each bedrock layer at each land gridpoint
  • 9.10. Variables that have a value for each soil biogeochemistry pool at each soil biogeochemistry layer at each land gridpoint
  • 9.11. Variables that have a value for each soil biogeochemistry layer at each land gridpoint
  • 9.12. Variables that have a value for each snow layer on each tile at each land gridpoint