Content for EGU22 PyGMT short course

[weiji14]

Continuing on from GenericMappingTools/website#131 (comment), we're going to have a 10 min intro + 4x20min sessions (total 90 min) for the PyGMT short course on 24 May 2022. This issue is for discussing what sort of material we'd like to teach, and sort out who is doing what (i.e. logistics).

👉 Draft outline: https://hackmd.io/@pygmt/egu22pygmt_outline

Important dates:

• 31 Mar 2022 - Early bird registration deadline
• 14 Apr 2022 - On-site attendance registration deadline
• 18 May 2022 - Short course pre-recording upload deadline
• 24 May 2022 - PyGMT short course

Note that the short course content can be pre-recorded ahead of time. I'm suggesting that we set an individual deadline on Friday 6 May 2022 Tuesday 10 May 2022 to have the presentation material (in mp4 format) ready for upload (though let me know if this doesn't work). This should give us time to review each other's work, make corrections, and merge the presentation together into the final 1.5 hour presentation (max 2-3GB) by the hard deadline on Wednesday 18 May 2022. Note that the EGU upload 'portal' is open from 9–18 May 2022 according to https://egu22.eu/guidelines/short-course_guidelines.html.

Also, @meghanrjones suggested at GenericMappingTools/website#131 (comment) that we can have a think about having some sort of interactive component (e.g. gather.town with the participants).

@leouieda, @meghanrjones, @andrebelem. I've set up a poll at https://www.when2meet.com/?15145108-mijPx so that we can have a 1 hour Zoom meeting to discuss this in more detail. (Edit: cancelling the meeting since hard to get everyone together, see #1 (comment)) But feel free to jot down any ideas you have below!

[leouieda]

@weiji14 thanks for organizing all of this! I'll be on vacation next week (2-10 April) so none of those dates work for me. I can catch up on notes afterwards if it's not possible to move this to the week after (or this week still).

[weiji14]

Ah ok, that's alright with me, I'll move the meeting to the week after (11-16 April), will update the when2meet poll. Edit: done, new link at https://www.when2meet.com/?15145108-mijPx.

[maxrjones]

Ah ok, that's alright with me, I'll move the meeting to the week after (11-16 April), will update the when2meet poll. Edit: done, new link at https://www.when2meet.com/?15145108-mijPx.

Rough timing, but I am on vacation April 09 - 17 and will be unavailable the following week (until April 23). But I can share some thoughts via GitHub ahead of time and review the notes.

[weiji14]

Ok, let's just skip the meeting and do this asynchronously then 🙂. I think @andrebelem is doing fieldwork too, so we might as well just do this at our own pace.

I've started a draft outline at https://hackmd.io/@pygmt/egu22pygmt_outline which you should all be able to edit 📝 Just pick any free slot and write some notes on what you'd like to teach. We can then discuss more about how to turn all of this into a coherent piece.

[leouieda]

Sorry, kind of dropped the ball on this. I can do the first tutorial with a PyGMT basics (Anatomy of a PyGMT figure) to introduce things like the layer-cake, how to read the docs, common arguments, coast, and plot.

Happy to switch as well if someone else was planning on doing that one already.

[weiji14]

Cool, thanks @leouieda! @meghanrjones and @andrebelem, do you both have any preference on what you would like to include in the short course?

If the individual deadline for this Friday 6 May is too tight, we can move it to next Tuesday 10 May so people can get the video done over the weekend or so. Just be aware that there is a hard deadline on 18 May when the full tutorial will need to be uploaded.

[maxrjones]

I'm glad to take either of the two remaining sections mentioned in the abstract

• Add context to their figures, such as legends, colorbars, and inset overview maps
• Use PyGMT to process PyData data structures (xarray/pandas/geopandas) and plot them on maps

Thanks for the flexibility @weiji14, I will make the content and video over the weekend.

We should aim for some consistency between videos in how the tutorials are presented. What do you all think about having the videos be demos of Jupyter notebooks? We could share the notebooks in this repo either as just a simple collection or if there's time collated into a Jupyter book.

[leouieda]

We should aim for some consistency between videos in how the tutorials are presented.

Absolutely!

What do you all think about having the videos be demos of Jupyter notebooks?

That's probably the most useful way to do this. Then people watching can have a copy of the code to play with. I was planning on making a brief notebook and then writing the code live in the recording (but leaving any markdown cells populated in the notebook already). I've been doing this for my courses for the past few years and it works very well.

I would avoid having a notebook full of code already that we just run in the video. Whenever I see or do that, the tendency is to go waaaay too fast and then the video becomes more of a demo and less a tutorial/workshop. Even for a demo, that only works if you don't want people to actually read and understand the code as you're going through it and just focus on the output.

[weiji14]

Yep, agree with going with the live-coding/typing method, it'll make it much easier for folks to follow along. I'll try and set up a Binder link (or links) today on this repo so that there will be a JupyterLab environment for us to code on.

[andrebelem]

Dear colleagues,
I wrote to @weiji a few days ago saying I was in a field with really bad internet and I came back in a somewhat complex family health situation that has been a mix of "hospital emergency" interspersed with university duties squeezed in time what's left.

I was to reply to @weiji next and - bump! - another emergency! I apologize for only being able to sit down now.

In my head, I was thinking about the last part of Tutorial 1 (anatomy of a PyGMT figure) but based on "Mars" (more or less along the same lines as this forum post https://forum.generic-mapping-tools.org/t/how-can-i-make-a-scale-bar-for-mars/1168/5) as a way to attract people from the Planetary Science. At the time we talked I thought about doing the same for Europa (Jupiter) but I saw that the explanation of the projections could get complicated (but you can use Moon IAU2000).

@leouieda, what kind of map are you thinking of making? something about bathymetry? I can try to fit something in from there. What will Tutorial 4 be? Another thing - @weiji, are we going to do everything in Binder ? I ask this because somehow I "wrecked" my conda with a setup of a jupyter server and will have to reinstall the whole machine. At the moment I'm just using Colab (I haven't tested it for the new version of pyGMT but it would be an idea to also make a tutorial with it!).

Once again sorry for this inconvenience and thanks for your patience.