Training | JULES JCHMR

To begin working with JULES, please see the online training page at https://jules.jchmr.org/training . There are several tutorials there, though I (Toby) recommend the one I wrote, which is called JULES From Scratch and I keep it as up to date as possible.

Additionally, I wouldn't recommend to run JULES on a Mac or Windows laptop: it should be possible, but large runs will be relatively slow on that (and parallel runs may be impossible). Most users run JULES on an HPC (i.e., a larger computer), e.g. JASMIN. Anyone working in the area of Environmental Sciences can get a JASMIN login, so I would recommend to apply for that and see whether this is a feasible option first. I have put details about JASMIN on a page on my website at https://www.tobymarthews.com/jules-on-jasmin.html .

Training resources

Up-to-date workshops and online tutorials
Worked examples
Older resources

JULES training workshops and online tutorials

The most recent training courses and online resources:

CONTINUOUSLY UPDATED: Toby Marthews's JULES From Scratch tutorial (originally written May 2017).
CONTINUOUSLY UPDATED: Patrick McGuire's tutorial about How to use Rose/Cylc for JULES on JASMIN (originally written Sep 2017). Along with several other tutorials for Running JULES.
January 2019: JULES WORKSHOP IN EXETER (based on JULESvn5.3).
September 2018: JULES WORKSHOP IN EXETER (based on JULESvn5.2).
September 2018: Edward Comyn-Platt started his JULES Tutorial youtube series.

July 2017: Charlie Williams wrote an Idiot's guide to Rose/Cylc for JULES on JASMIN (note from Toby: this tutorial refers to my suite u-ai227 and branch vn4.8_testHoT, both of which have since been deleted).
UPDATED EVERY VERSION RELEASE OF JULES: The official JULES manual pages contain some training tutorials (the first few sections give you a step-by-step guide to Building and running JULES, and later sections include Kerry Smout-Day's JULES-Rose tutorials).
UPDATED EVERY VERSION RELEASE OF JULES: The JULES TRAC contains a number of information pages and self-teach tutorials (e.g. Rose JULES on JASMIN) as well as links to useful pages like the JULES Tip of the Day, JULESWithRose, JULESRosePractical and UsingGriddedDatasets.

Additionally, the regular UM Training Workshops are THE best place to learn about using JULES in coupled mode, and training is also available regularly for using ARCHER2.

Worked examples

In my experience, it's usually the worked examples people that are the most useful. Here are a selection:

Example	Where
A sequence of point runs based on FLUXNET2015 and LBA data	This is an ongoing project: For the latest developments, see here (and perhaps also see Patrick McGuire's ppt at the 2018 Exeter Workshop for the state of play in August 2018).
A point run using ASCII input rather than NetCDF	Search Rosie Go for "Loobos" Eddy's three video tutorials use the same basic data (although on vn5.2): JULES Tutorial 1 (Check Out and Go): The single-site Loobos example (using suite u-bb219). JULES Tutorial 2 (Spin Me Round): Single-site Loobos with a spin-up added in. JULES Tutorial 3 (Go Green): Single-site Loobos with dynamic vegetation. *** n.b. Loobos data should NOT be used for any serious work: it is only example data to demonstrate the use of JULES ***
A gridded run using 1D (land axis) NetCDF input	Toby's JULES From Scratch tutorial used to include a gridded run like this, but removed Oct 2022. Alberto Martínez's practical 2 from the 2016 JULES Short Course based on the River Thames, U.K. (vn4.5)
A gridded run using 2D NetCDF input	See Toby's JULES From Scratch tutorial. Also see UsingGriddedDatasets (the link is worth reading, but note the example it describes is only for JULESvn4.1 and also the driving data for GSWP2 are not provided and you can't actually run it without acquiring those files (and Toby doesn't have them!))

Older training resources

2016 training at Lancaster by Toby Marthews and others at CEH/MetO: see here (based on JULESvn4.8).
2012 training at Exeter by Matt Pryor (based on JULESvn3.2)
2010 training at Wallingford by Doug Clark (based on JULESvn2.1.2)

I believe that these are still worth going through to pick up tips, but n.b. they do not refer to (and therefore cannot help with) the latest versions of JULES.