You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _episodes/first_example_recipe.md
+21-12Lines changed: 21 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,7 +20,6 @@ keypoints:
20
20
21
21
---
22
22
23
-
24
23
This episode describes how ESMValTool recipes work, how to run a recipe and how to explore the recipe output. By the end of this episode, you should be able to run your first recipe, look at the recipe output, modify a recipe, explore and run some basic recipe debugging.
25
24
26
25
## Introduction to Recipes
@@ -177,8 +176,11 @@ Please note the following sections:
177
176
178
177
179
178
> What is the short_name of the variable being analysed?
179
+
>
180
180
> What is the diagnostic script being used?
181
+
>
181
182
> How many years of data are being analysed?
183
+
>
182
184
> What do you think running this recipe will produce?
183
185
{: .challenge}
184
186
@@ -190,29 +192,36 @@ Please note the following sections:
> Follow the terminal guiding you through the subprocesses that are running. Can you find where the preprocessor and the diagnostic are starting? Which one took longer to process?
197
200
{: .challenge}
198
201
202
+
Each time you run the ESMValTool, it will produce a new output directory within your specified work directory with the name of the recipe and the tagged runtime. This folder should contain four folders:
203
+
- run
204
+
- work
205
+
- preproc
206
+
- plots
199
207
200
208
> ## Inspect the output:
201
-
> Now that you have run the esmvaltool command for the first time, please locate your output directory.
202
-
> Each time you run ESMValTool, it will produce a new output directory with the following format:
203
-
> This directory should contain four folders:
204
-
> run work preproc plots
209
+
> Now that you have ran the esmvaltool command for the first time, please locate your output directory.
205
210
> If you’re missing the preproc directory, then your config-user.yml file has the value remove_preproc_dir set to true (this is used to save disk space). Please set this value to false and run the recipe again.
206
211
>
212
+
{: .challenge}
213
+
214
+
> ## Inspect specific files:
207
215
> Please locate and inspect the following files:
208
-
> Your output plot(s).
209
-
> Your main output log file
210
-
> Your settings.yml file
211
-
> A metadata.yml file
216
+
> - Your output plot(s).
217
+
> - Your main output log file.
218
+
> - Your settings.yml file.
219
+
> - A metadata.yml file.
220
+
> - The diagnostic log file.
212
221
{: .discussion}
213
222
214
223
215
-
> ## Edit the recipe and run
224
+
> ## Edit the recipe and run again
216
225
> So far, the example recipe has used global volume-weighted ocean temperature. Please edit this recipe to investigate one of the following fields:
0 commit comments