Add a Jupyter esmvalcore API tutorial

[flicj191]

Pull Request checklist

We appreciate your time and effort to improve the tutorial. Please keep in mind that lesson maintainers are volunteers and it may be some time before they can respond to your contribution.

---

Before you start

• Read CONTRIBUTING.md.
• Create an issue to discuss your idea. This allows your contributions to be incorporated into the tutorial.
  Mention posibility of using Jupyter notebooks in the tutorial #283 and Potential lesson additions from the May 2024 Workshop discussions #324

Tasks

• Give this pull request a descriptive title.
• If you are contributing to existing lesson materials, please make sure the content conforms to the Lesson development section in CONTRIBUTING.md and does not contain any spelling or grammatical errors.
• If you are making a new episode, please make sure the content conforms to the Lesson organization and Lesson formatting sections in CONTRIBUTING.md and does not contain any spelling or grammatical errors.
• Preferably Codacy checks pass. Status can be seen below your pull request. If there is an error, click the link to find out why.
• Preview changes on your machine before pushing them to GitHub by running make serve, alternatively make docker-serve. Please see the Previewing your changes locally section in CONTRIBUTING.md for installation instructions.
• All code instructions have been tested.

If you need help with any of the tasks above, please do not hesitate to ask by commenting in the issue or pull request.

---

Closes {Link to the corresponding issue} #283 and part of #324

[flicj191]

Adding lesson made for our ACCESS 2024 workshop Training day Hackathon with @rbeucher. Have edited to remove references to Gadi (Australia's NCI supercomputer) workflow

[rbeucher]

@LisaBock , @rswamina
Would any of you have time to look at this? Thank you!

[LisaBock]

@LisaBock , @rswamina Would any of you have time to look at this? Thank you!

Sorry! I will do next week...

[rswamina]

@rbeucher - I will also try it this week. Thanks!

[LisaBock]

Thanks a lot, @flicj191 ! It is great that we have finally a episode how to use the Jupyter esmvalcore API. And since I've never used it before, I can say that you learn it well with this episode. The examples and exercises are also very useful.

Some comments:

• I am missing in the beginning a small part about the configuration. How to check the CFG keys and how to adapt them. (I think Peter has it in his blog.)
• When using the ESMValCore preprocessor function I got many warnings with the output. Is it the same for you? I am not sure if we should mention that somehow. Otherwise it could be irritating.
• I could not find the 'ACCESS-OM2, omip2' data on ESGF. Did I something wrong or could you replace it with a dataset which is available on ESGF?

[flicj191]

Thanks @LisaBock for your comments! Good points, I will address them though I'm at a conference next week so probably the week after. Cheers

[rswamina]

@flicj191 - I have started this review..will try and see if the instructions work simultaneously.

[rswamina]

@flicj191 - This is really nice! I have added some comments at the start of the lesson essentially to provide more detailed instructions in keeping with other lessons and for easy assimilation by the user. We haven't mentioned anything about the ESMValCore API in the tutorial, so either we should provide some background here and/or link to documentation in a way that explains this.
Also, we have to have some way of explaining how to use the appropriate environment.

I'd be interested to know what you and @LisaBock think about this.

[rswamina]

@flicj191 - Leaving this request for changes based on overall comments. Happy to discuss how best to make these changes.

[flicj191]

Hi @LisaBock and @rswamina I have edited this to address all your comments in this episode. Let me know what you think, thanks

[rbeucher]

This is quite old. @flicj191 any update on this?

[flicj191]

This is quite old. @flicj191 any update on this?

Oh yes, it would need updating for new versions and then will request another review

updates added

[CLAassistant]

All committers have signed the CLA.

[flicj191]

Hi @rswamina and @LisaBock, I have updated to v2.14 and have addressed previous comments. What are your thoughts? happy to discuss what else could be useful