Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Contribution of training materials #539

Open
lhmarsden opened this issue Sep 19, 2024 · 7 comments
Open

Contribution of training materials #539

lhmarsden opened this issue Sep 19, 2024 · 7 comments
Labels
enhancement Enhancements to the website's presentation or contents

Comments

@lhmarsden
Copy link

lhmarsden commented Sep 19, 2024

There was some discussion after my presentation of the CF 2024 workshop that I could contribute some of the training materials I have developed to CF. Yes, I would be very happy for you to make any of these materials available via the CF website training page.

I host a YouTube channel and have written a few jupyter books with code and written explanations that accompany some of the videos. Here is a list of some of the materials that you might find relevant.

Working with CF-NetCDF in R:
Written document: https://lhmarsden.github.io/NetCDF_in_R_from_beginner_to_pro
YouTube playlist: https://www.youtube.com/playlist?list=PLpykv05eUR0oqBYFNqtiRgJGYR2tpCYtw

Working with CF-NetCDF in Python:
Written document: https://lhmarsden.github.io/NetCDF_in_Python_from_beginner_to_pro
YouTube playlist: https://www.youtube.com/playlist?list=PLpykv05eUR0rAuaLnybkZORnCwyND4CV4

Introduction to CF-NetCDF:
A short video describing the classic data format, including CF and ACDD
YouTube video: https://www.youtube.com/watch?v=FGHJhAFf1W0

If you were to endorse these materials, I would recommend that this is done with a disclaimer that these are not developed as part of CF. I can not confidently state that everything I have written or said is in-line with the best practices CF would recommend.

I also welcome any suggestions and contributions. The videos can't be edited, but the written documents are hosted on GitHub as Jupyter Books. You are welcome to submit and issue or even a pull request if you are feeling particularly generous with your time.

I don't know if this is possible with a website made using markdown etc, but there are a lot of data showing that people are much more likely to watch an embedded video than clicking on a link to a video. People also retain a lot more information from a video than from text.

I hope this is helpful, and I am happy to contribute as much or little as you like. I am also open to suggestions on making more materials that you think might be useful for the CF community.

Also, @erget has a very nice video on visualising data in NetCDF files... which has a lot more views that my videos!
https://www.youtube.com/watch?v=XqoetylQAIY

@lhmarsden lhmarsden added the enhancement Enhancements to the website's presentation or contents label Sep 19, 2024
@lhmarsden
Copy link
Author

@sadielbartholomew
Copy link
Member

Hi Luke,

I haven't had a chance to check out your training videos in any depth yet, though will certainly do in the near future, but from a glance over your materials and brief watch of some content they seem very impressive.

Speaking on behalf of myself, @japamment and others who formed a CF Training group a few years ago, with the aim to create dedicated training for the CF Conventions, we'd love it if we could include your content under our 'CF Training' page.

I think the best means to include your resources are:

  • add a direct link in a bullet point under the 'CF training materials' heading to the pages you think are most relevant to link to to showcase your content, for example to the tutorial series and notebooks; and
  • since we also have a dedicated YouTube channel as part of that, linked as you may have seen - is there a way we can include your videos there, whilst still allowing them to be directly attributed to your 'Luke Data Manager' user source account, in a way that you'd be happy with?

@sadielbartholomew
Copy link
Member

I also welcome any suggestions and contributions.

In this case, I also come to you with a request. Your 'NetCDF-in-Python-from-beginner-to-pro' course looks very useful and thorough and I note the material there centres around the use of xarray to read, interpret and write out data. But as you may be aware, there are other approaches to using Python to work with netCDF, for example myself and a small team at my group, NCAS-CMS, develop a set of Python libraries called cf-python and cf-plot (amongst some others related libraries, but these two are most directly relevant to the content in your courses), which are designed for data analysis with the CF Conventions and CF Data Model at the center.

If you have the bandwidth, we'd love it if you could try out our tools, notably cf-python as a starting point, and if you find them useful ideally you could include some content where you showcase their usage as an alternative to the pure xarray way of working with netCDF, if nothing else to demonstrate that there are different Python tools for the job. We have designed these tools with CF metadata at the heart, and think therefore that they offer improved CF awareness to xarray. But, to avoid a shameless plug, I can let you make your own mind up about their usefulness 🙂 And if you find any deficiencies with these libraries relative to xarray otherwise, please let us know on the Issue Trackers - we love to get feedback and requests to help us to make the libraries as useful as possible for the community.

@lhmarsden
Copy link
Author

  • add a direct link in a bullet point under the 'CF training materials' heading to the pages you think are most relevant to link to to showcase your content, for example to the tutorial series and notebooks; and

This would be good. The materials I have listed above would be my recommendations, but feel free to pick and choose.

  • since we also have a dedicated YouTube channel as part of that, linked as you may have seen - is there a way we can include your videos there, whilst still allowing them to be directly attributed to your 'Luke Data Manager' user source account, in a way that you'd be happy with?

It is possible to create a playlist of videos from other channels.
image

To do this:

  1. Find the video you want to add
  2. Click the three dots, and select 'add to playlist'
  3. If the playlist doesn't exist, you will be prompted to create it. Make it public.
  4. Add more videos
  5. You can also go to your channel and add details about the playlist, e.g. a description.

Python libraries called cf-python and cf-plot

These sound really useful! I will try them out and certainly consider creating a video in future. Probably this will be next year as I have a bit of a backlog, but I have created a task for myself to review this.

@lhmarsden
Copy link
Author

lhmarsden commented Sep 26, 2024

Speaking on behalf of myself, @japamment and others who formed a CF Training group a few years ago, with the aim to create dedicated training for the CF Conventions

Is this group still active? I would be happy to be part of this if you are looking for more contributors!

@sadielbartholomew
Copy link
Member

sadielbartholomew commented Sep 30, 2024

Is this group still active? I would be happy to be part of this if you are looking for more contributors!

We haven't done much in the past few years, after we initiated the training, but it is an ongoing effort and open call for the inclusion of training materials (assuming they are suitable). We'd love for you to join - there is no formal process (as far as I am aware, and unless anyone corrects me, since the team started as volunteers). And perhaps your joining can prompt us to meet again to review where we are at with training...

@lhmarsden
Copy link
Author

Wonderful! Keep me posted.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement Enhancements to the website's presentation or contents
Projects
None yet
Development

No branches or pull requests

3 participants
@sadielbartholomew @lhmarsden and others