README.md

### This folder contains:

- #### [FOCUS_calibration_t2m.ipynb](https://earth.bsc.es/gitlab/external/cstools/-/blob/develop-CalibrationVignette/FOCUS_7_2/FOCUS_calibration_t2m.ipynb): 
    This vignette provides an example of code written in R that can be used to calibrate seasonal forecasts using several calibration methods.
    
    For each calibration method, the results and different skill scores are displayed and compared to the ones obtained by using a non-calibrated forecast. This example is conducted over a south-african domain, along a reference period going from 1995 to 2015 and for the variable "t2m" (air temperature 2m above the ground). The initialisation month of the hindcast - which is a forecast initialised in the past (known as well as retrospective forecast) - is November and the analysis is done for the seasonal aggregation of November, December and January (NDJ).  

    The vignette includes five main steps: (1) Loading R libraries, (2) Downloading the data and setting the configuration parameters, (3) Loading the seasonal data, (4) Calibrating and verifying the forecast and (5) Visualising the results.

    **THIS VIGNETTE MAY BE RUN IN TWO WAYS:**
    - **1. Virtually**. To use this option (and to know some information regarding this) you can go to the [binder](https://earth.bsc.es/gitlab/external/cstools/-/tree/develop-CalibrationVignette/FOCUS_7_2/binder) folder .
    - **2. Using your own computer**. Some computational requirements must be met. To get more information on this option you can go to the [in_computer](https://earth.bsc.es/gitlab/external/cstools/-/tree/develop-CalibrationVignette/FOCUS_7_2/in_computer) folder

<br>

- #### [Figures](https://earth.bsc.es/gitlab/external/cstools/-/tree/develop-CalibrationVignette/FOCUS_7_2/Figures): 

    Folder which contains the figures obtained in the analysis conducted within [FOCUS_calibration_t2m.ipynb](https://earth.bsc.es/gitlab/external/cstools/-/blob/develop-CalibrationVignette/FOCUS_7_2/FOCUS_calibration_t2m.ipynb) 

 - #### [download_seasonal_data.R](https://earth.bsc.es/gitlab/external/cstools/-/blob/develop-CalibrationVignette/FOCUS_7_2/download_seasonal_data.R):

    This script might be called when the vignette [FOCUS_calibration_t2m.ipynb](https://earth.bsc.es/gitlab/external/cstools/-/blob/develop-CalibrationVignette/FOCUS_7_2/FOCUS_calibration_t2m.ipynb) is run. It allows downloading, formatting and storing the seasonal data from the CDS (netCDFs files are obtained). This script is aimed at providing an example of how the seasonal hindcast and observations can be downloaded using R.

- #### [binder](https://earth.bsc.es/gitlab/external/cstools/-/tree/develop-CalibrationVignette/FOCUS_7_2/binder):

    Folder containing the elements necessaries to run the vignette [FOCUS_calibration_t2m.ipynb](https://earth.bsc.es/gitlab/external/cstools/-/blob/develop-CalibrationVignette/FOCUS_7_2/FOCUS_calibration_t2m.ipynb) through Binder.


- #### [in_computer](https://earth.bsc.es/gitlab/external/cstools/-/tree/develop-CalibrationVignette/FOCUS_7_2/in_computer):

    Folder containing information regarding some computational requirements and steps that need to be followed to run the vignette [FOCUS_calibration_t2m.ipynb](https://earth.bsc.es/gitlab/external/cstools/-/blob/develop-CalibrationVignette/FOCUS_7_2/FOCUS_calibration_t2m.ipynb) in a computer. 

- #### [reference_seas5.nc](https://earth.bsc.es/gitlab/external/cstools/-/blob/develop-CalibrationVignette/FOCUS_7_2/reference_seas5.nc):

    netCDF file used within [FOCUS_calibration_t2m.ipynb](https://earth.bsc.es/gitlab/external/cstools/-/blob/develop-CalibrationVignette/FOCUS_7_2/FOCUS_calibration_t2m.ipynb) to match the resolutions of both the observations and the hindcast.