Skip to content

Commit 6abfe13

Browse files
author
BenMGeo
committed
restructure some challenges
1 parent f595c7b commit 6abfe13

File tree

1 file changed

+21
-12
lines changed

1 file changed

+21
-12
lines changed

_episodes/first_example_recipe.md

Lines changed: 21 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,6 @@ keypoints:
2020

2121
---
2222

23-
2423
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.
2524

2625
## Introduction to Recipes
@@ -177,8 +176,11 @@ Please note the following sections:
177176
178177
179178
> What is the short_name of the variable being analysed?
179+
>
180180
> What is the diagnostic script being used?
181+
>
181182
> How many years of data are being analysed?
183+
>
182184
> What do you think running this recipe will produce?
183185
{: .challenge}
184186
@@ -190,29 +192,36 @@ Please note the following sections:
190192
>
191193
> Use the command:
192194
> ~~~
193-
> esmvaltool -c user-config.yml recipe_example.yml
195+
> esmvaltool -c ./path_to_file/user-config.yml ./path_to_file/recipe_example.yml
194196
> ~~~
195197
> {: .source}
196-
> What ...
198+
>
199+
> 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?
197200
{: .challenge}
198201
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
199207
200208
> ## 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.
205210
> 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.
206211
>
212+
{: .challenge}
213+
214+
> ## Inspect specific files:
207215
> 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.
212221
{: .discussion}
213222
214223
215-
> ## Edit the recipe and run
224+
> ## Edit the recipe and run again
216225
> So far, the example recipe has used global volume-weighted ocean temperature. Please edit this recipe to investigate one of the following fields:
217226
> - Land surface average temperature (tsland)
218227
> - Atmospheric surface average temperature (tas)

0 commit comments

Comments
 (0)