@@ -22,7 +22,7 @@ keypoints:
2222
2323## Introduction
2424
25- One of the key strenghts of ESMValTool is in making complex analyses reusable
25+ One of the key strengths of ESMValTool is in making complex analyses reusable
2626and reproducible. But that doesn't mean everything in ESMValTool needs to be
2727complex. Sometimes, the biggest challenge is in keeping things simple. You
2828probably know the 'warming stripes' visualization by Professor Ed Hawkins. On
@@ -38,14 +38,14 @@ ESMValTool. We have prepared a small Python script that takes a NetCDF file with
3838timeseries data, and visualizes it in the form of our desired warming stripes
3939figure.
4040
41- You can find the diagnostic script that we will use
42- [ here ( ` warming_stripes.py ` ) ] ( ../files/warming_stripes.py ) .
41+ The diagnostic script that we will use is called ` warming_stripes.py ` and
42+ can be downloaded [ here] ( ../files/warming_stripes.py ) .
4343
4444Download the file and store it in your working directory. If you want, you may
4545also have a look at the contents, but it is not necessary to follow along.
4646
4747We will write an ESMValTool recipe that takes some data, performs the necessary
48- preprocessing, and then runs our Python script.
48+ preprocessing, and then runs this Python script.
4949
5050> ## Drawing up a plan
5151>
@@ -55,7 +55,7 @@ preprocessing, and then runs our Python script.
5555>
5656> > ## Answer
5757> >
58- > > In this episode, we will need to do 2 tasks:
58+ > > In this episode, we will need to do the following two tasks:
5959> >
6060> > - A preprocessing task that converts the gridded temperature data to a timeseries
6161> > of global temperature anomalies
@@ -73,17 +73,18 @@ start from scratch. This forces us to think about all the steps. We will deal
7373with common errors as they occur throughout the development.
7474
7575Remember the basic structure of a recipe, and notice that each of them is
76- extensively described in the documentation under the header [ "The recipe
77- format"] ( https://docs.esmvaltool.org/projects/esmvalcore/en/latest/recipe/overview.html ) :
76+ extensively described in the documentation under the header
77+ [ "The recipe
78+ format"] ( https://docs.esmvaltool.org/projects/esmvalcore/en/latest/recipe/overview.html ) {: target ="_ blank"}:
7879
7980- [ documentation] (https://docs.esmvaltool.org/projects/esmvalcore/en/latest/
80- recipe/overview.html#recipe-section-documentation)
81+ recipe/overview.html#recipe-section-documentation){ : target =" _ blank"}
8182- [ datasets] (https://docs.esmvaltool.org/projects/esmvalcore/en/latest/recipe/
82- overview.html#recipe-section-datasets)
83+ overview.html#recipe-section-datasets){ : target =" _ blank"}
8384- [ preprocessors] (https://docs.esmvaltool.org/projects/esmvalcore/en/latest/
84- recipe/overview.html#recipe-section-preprocessors)
85+ recipe/overview.html#recipe-section-preprocessors){ : target =" _ blank"}
8586- [ diagnostics] (https://docs.esmvaltool.org/projects/esmvalcore/en/latest/
86- recipe/overview.html#recipe-section-diagnostics)
87+ recipe/overview.html#recipe-section-diagnostics){ : target =" _ blank"}
8788
8889This is the first place to look for help if you get stuck.
8990
@@ -201,16 +202,16 @@ Although there is no actual error in the recipe, ESMValTool assumes you mistaken
201202left out a variable name to process and alerts you with this error message.
202203## Adding a dataset entry
203204
204- Let's add a datasets section. We will reuse the same datasets that we used in
205- previous episodes.
205+ Let's add a datasets section.
206+
206207
207208> ## Filling in the dataset keys
208209>
209210> Use the paths specified in the configuration file to explore the data directory,
210211> and look at the explanation of the dataset entry
211212> in the [ESMValTool
212213> documentation](https://docs.esmvaltool.org/projects/esmvalcore/en/latest/
213- recipe/overview.html#recipe-section-documentation).
214+ recipe/overview.html#recipe-section-documentation){:target="_blank"} .
214215> For both the datasets, write down the following properties:
215216>
216217> - project
@@ -229,7 +230,7 @@ recipe/overview.html#recipe-section-documentation).
229230> > | project | CMIP6 | CMIP5 |
230231> > | short name | tas | tas |
231232> > | CMIP table | Amon | Amon |
232- > > | dataset | BCC-ESM1 | CanESM2 |
233+ > > | dataset | BCC-ESM1 | bcc-csm1-1 |
233234> > | experiment | historical | historical |
234235> > | ensemble | r1i1p1f1 | r1i1p1 |
235236> > | grid | gn (native grid) | N/A |
@@ -249,9 +250,23 @@ of the `diagnostic` section in the recipe example seen in
249250[Running your first recipe]({{ page.root }}{% link _episodes/04-recipe.md %}).
250251
251252```yaml
253+ # ESMValTool
254+ # recipe_warming_stripes.yml
255+ ---
256+ documentation:
257+ description: Reproducing Ed Hawkins' warming stripes visualization
258+ title: Reproducing Ed Hawkins' warming stripes visualization.
259+
260+ authors:
261+ - doe_john
252262datasets:
253263 - {dataset: BCC-ESM1, project: CMIP6, mip: Amon, exp: historical,
254264 ensemble: r1i1p1f1, grid: gn, start_year: 1850, end_year: 2014}
265+
266+ diagnostics:
267+ dummy_diagnostic_1:
268+ scripts: null
269+
255270```
256271
257272The recipe should run but produce the same message as in the previous case since we
0 commit comments