Add tutorial

[jatkinson1000]

Closes #126

This adds a tutorial for new users to the docs, with associated scripts in the GitHub repo.

It works through

• Installing TCTrack with TE and TSTORMS
• Fetching data
• Preprocessing data
• Running TCTrack (TE and TSTORMS)
• Visualising tracks

Potential issues:

• TSTORMS does not detect any tracks for the input data. Consider using a different period where it does?
• Data pre-processing can take a long time and requires conda env which feels clunky
• We use a mixture of sources for input data when ideally we would use a single source
• We use wget to fetch data, but I would prefer if we used OpenDAP or THREDDS. Perhaps improve later. Open an issue?

On CSD3 I use the following environment:

module purge
module load rhel8/cclake/base
module load intel-oneapi-compilers/2023.2.4/gcc/4lbvg4hv
module load netcdf-cxx4/4.3.1/intel/intel-oneapi-mpi/gxfwrfnl
module load netcdf-fortran/4.6.1/intel/intel-oneapi-mpi/kqukipdf
module load python/3.11.9/gcc/nptrdpl

To run the regridding script I submitted as a batch job (approx 30mins to run) using the following:

#!/bin/bash
#SBATCH -J regrid
#SBATCH -A ICCS-SL2-CPU
#SBATCH -p icelake
#SBATCH --output=regrid_%A_%a.out
#SBATCH --error=regrid_%A_%a.err
#SBATCH --nodes=1
#SBATCH --ntasks=2
#SBATCH --time=01:00:00

. /etc/profile.d/modules.sh

module purge
module load rhel8/cclake/base

cd /home/jwa34/rds/rds-inspire-tc-TqEGHMWTn8A/TCTrack/tutorial

source miniforge3/bin/activate
conda activate regrid

python regrid.py

conda deactivate
conda deactivate

which assumes you have already cloned TCTrack and placed your miniforge installation in the tutorial/ directory.

It would be good if you could work through this when back @sjavis to see how well it works or any sticking points/points for clarification/improvement.

[sjavis]

This seems to mostly work for me locally, with the exception of TSTORMS since I don't have ifort. I have just a few suggested changes.

I think the conda environment is fine, especially since we discussed that this will probably be what we recommend. The pre-processing time also didn't seem too dreadful to me. I think, ultimately, is going to take time for the pre-processing for any reasonable.

I agree that the multiple sources and using wget can probably also be made an issue to look at improving later.

[sjavis]

I've tried using the equivalent data from 1951, 1952, and 1953, but TSTORMs still gives no output trajectories. It seems to me that there might be an issue somewhere. I have checked and run_tstorms.py matches the parameters in the documentation aside from less strict values for wind_crit and n_day_crit so it probably isn't an issue there. It could be a problem with the preprocessing?

[jatkinson1000]

Yes, I think we need to look at the esgf-generated vorticity file.
If I run the full the tutorial with HadGEM3 Vorticity files downloaded from CEDA it works fine.

[jatkinson1000]

Rebased and autosquashed. Picked up version and linting fixes from main.

[sjavis]

I'm happy with this now. I have opened an issue (#156) for the problem with TSTORMS giving no output. But this PR should be merged as it is now.