Overview of the Galaxy Training Material for Instructors
How can I use the GTN for teaching?
What resources are available?
Why is it a good choice?
- Are you an instructor, giving training/workshop?
- Are you an instructor, giving training or workshops?
- Are you using Galaxy for training?
- Are you using Galaxy for training?
- Do you know the resources of the Galaxy Training Network?
- Do you know the resources of the Galaxy Training Network?
Galaxy Training Material
One website, aggregating training material covering many current research topics.
- We have just the resource for you
- The Galaxy Training Network is a central hub for Galaxy related training materials
- One website, with hundreds of tutorials and training resources.
Interactive learning via hands-on tutorials built around a “research story”
Usable by individual users & instructors
- The GTN is structured as hands-on, interactive tutorials.
- These promote better learning as students can immediately apply their knowledge.
- By basing our tutorials around research stories we ensure science is reproducible, and students are doing real world analyses.
- The materials are usable as self-study, as well as for instructors in front of a classroom.
Many Tutorials, Large Community
<div class="row" style="color: var(--text-color-boxtitle)"> <div class="col-md-4"> <div class="gtn-card color-agenda"> <div class="card-title">31</div> <div class="card-text">Topics</div> </div> </div> <div class="col-md-4"> <div class="gtn-card color-tip"> <div class="card-title">308</div> <div class="card-text">Tutorials</div> </div> </div> <div class="col-md-4"> <div class="gtn-card color-details"> <div class="card-title">357</div> <div class="card-text">FAQs</div> </div> </div> <div class="col-md-6"> <div class="gtn-card color-comment"> <div class="card-title">282</div> <div class="card-text">Contributors</div> </div> </div> <div class="col-md-6"> <div class="gtn-card color-handson"> <div class="card-title">7.6</div> <div class="card-text">Years</div> </div> </div> </div>
- We have curated over 250 tutorials from as many contributors, over the past years of the GTN.
- These tutorials cover a wide range of scientific domains, from genomics, to machine learning, to climate sciences.
Public, Peer-Reviewed, Community Maintained
- The GTN is hosted on GitHub, and all changes need to be reviewed before they are accepted.
- This way, we have peer-reviewed tutorials that are checked by multiple reviewers before being accepted.
- Our fantastic volunteer community and topic moderators make this process possible.
Galaxy + GTN Ecosystem Features
- Galaxy and the GTN’s ecosystems work together for an optimised learning experience.
- Tutorial mode is a recently added feature, wherein you can use the training materials from directly inside Galaxy.
- No more need to split your screen between a tutorial, and Galaxy.
- Additionally this adds the important feature of click-to-run tools.
- All tools used in the tutorials are hyperlinked to the Galaxy server you’re using, just click a tool to activate it in Galaxy.
Training Infrastructure as a Service (TIaaS)
.pull-left[ If you’re using a Public Galaxy
- Sometimes the server is busy
- It’s too popular, and someone else is running Big Jobs™
- I need my jobs to complete fast
If you’re using a Private Galaxy
- What are my students doing?
- Are they keeping up?
- Or goofing off? ]
- If you have ever given a training using a Public galaxy server, maybe you have encountered the situation where the server is extremely busy, and your students jobs cannot run.
- In training you need these to complete quickly.
- Or if you’re using a private server, you might want to keep an eye on your students.
.pull-right[ TIaaS Provides:
On public servers:
- Free resources for your events/classes/etc
- Private Queues on the big servers, only for your class/event.
- A live dashboard showing how students are progressing ]
- TIaaS provides answers to both of these scenarios.
- On public Galaxies like Galaxy Europe or Australia, TIaaS provides a private queue to let your jobs run fast
- But everywhere, it gives you a dashboard to track student progress.
The TIaaS Dashboard
- This dashboard was developed during a hybrid training event, pre-pandemic.
- Here we gave a training broadcast into three classrooms, and found we could not feel how fast or slow students were going.
- Were they completing jobs successfully? Or were they encountering issues?
- Thus the dashboard was born.
- It provides an anonymised list of students in the class, and shows which tools have been run recently.
- If a tool fails, you can know you may need to address this issue with the students.
- Or you can tell when you see 20 green jobs, that all of your students are done successfully!
- This allows you to be confident that you can move on with teaching.
The Video Library
- The video library was a recent pandemic addition to the ecosystem.
- We gave several remote training events, namely the Smörgåsbord series.
- There we asked instructors to record themselves teaching a tutorial, and we uploaded these online for students to watch.
- These events were a great success, and a wealth of content was produced.
- Over 100 hours spread across 175 videos.
- All videos are fully captioned and checked by a human.
- So we have collected all of the videos in a central location.
- You can re-use these freely in your lessons.
- We have heard that instructors love to include these in their lessons as preperatory videos for students to follow.
- Students can hear from experts, and come to class prepared for lessons.
Reusable Videos with Teaching Resources
Videos with Metadata
- Who Captioned It
- Associated Materials
- Support Resources
Embeddable! (E.g. BrightSpace, Blackboard, Moodle, etc.)
- All of these videos track extensive metadata including who produced and captioned it, associated learning materials like the tutorial or slides, and support resources
- All of the content is openly licensed for re-use.
- You can embed it in your classroom software for students to follow!
- Want to give a workshop?
- Don’t want to make a course website?
- Or embed a bunch of YouTube videos?
- Based on the video library, build a schedule
- Try it Today!
- An in-development tool is being produced based on the video library.
- It will let you easily host a workshop, by selecting which videos and tutorials you want to include.
- A website is automatically produced that you can use to announce your course.
- Test it out today, and let us know what bugs you find!
A wide array of tutorial features help you and your learners. The GTN builds features directly into the tutorial framework to enhance your trainings and tutorials, with no extra effort from yourself.
- Tutorial features are features we build directly into the GTN to enhance the learning experience for students, that come at low or no time cost to you.
- We’ll go into detail on a few of the great things the GTN provides.
Keeps Training FAIR
GTN is a completely FAIR Training platform, meeting all 10 criteria of the “Ten simple rules for making training materials FAIR” (Garcia et al. 2020)
- Rich machine-readable metadata, exposed for search engines
- Tracked in TeSS’s Training Repository
- Persistent URLs and DOIs
- Collaborative infrastructure
- Keeping training FAIR, or findable, accessible, interoperable, and reusable is a hot buzzword these days.
- Endless papers and resources are produced on how to make your training fair, but implementing that is a lot of work.
- By using the GTN you are getting FAIR for free!
- Rich metadata about tutorials and resources are tracked within the GTN’s framework, and exposed in machine readable ways that help us stay fair.
- All of our tutorials are additionally ingested and tracked by TeSS, the training e-support system of elixir.
- So get FAIR for free, and use the GTN.
Keeps Training Accessible (Automatically!)
The GTN community cares about accessible training for students with disabilities.
- Screenreader friendly
- Alternative slide deck views specifically for screen readers
- All images have (overall good) alt text
- No sound used outside automated videos
- Those have transcripts + SRT captions available
- Animations respond to
- No auto-playing videos
- No sounds used
- The GTN community cares about accessibility, and works explicitly to ensure that all of our training resources are automatically accessible.
- This includes things like our framework generating more-accessible versions of existing training resources automatically.
- Or ensuring that we require alt text for every image.
- We cover a broad range of disabilities and accomodations that can be made, and are always open to hearing if there are ways we can improve what we are doing.
- If you or one of your students needs additional accomodations, please let us know, we will do our best.
Frequently Asked Questions Library
- Massive library of common questions
- Questions over Galaxy
- Questions over the GTN
- Reusable snippets that can be used in tutorials!
- See them here! ]
.pull-right[ Example FAQs
- How do I upload via link?
- How to troubleshoot a failed job
- Why not use Excel?
- How to manage histories
- How to share a history
- Which Galaxy should I use? ]
- One of the things that is only possible at the scale of the GTN is a large FAQ library.
- With hundreds of training materials, and thousands of trained students, we’ve identified many common questions and stored them as FAQs that can be reused in materials, or provided to students via URL.
- We use this large resource for all of our common questions for trainings, for answering student questions, and so on.
- Do you use Jupyter or RStudio notebooks?
- Do you use them as tutorials, where students can follow along?
- Check out the GTN’s Automatic Notebook Generation
It’s quite easy:
- Write a GTN tutorial like normal
- Enable the feature.
- Select your programming language.
- Automatic Notebooks are generated! ]
- If you’ve ever written tutorials that cover programming topics like python or R, you might have wanted to use a notebook
- Producing a web version of that requires additional steps, and new tools to learn!
- So the GTN built a way to automatically generate notebooks from plain markdown, just like other GTN tutorials.
- If you write your lesson, you can easily convert it into a notebook compatible tutorial
- It will be visible online, for those who just want to read the text
- And it can be run in jupyter or rstudio via the automatic export of notebooks.
- Essentially no effort is required on your part.
Choose Your Own Tutorial
.pull-left[ Do your students choose Path A (fresh data access)
.pull-right[ Or Path B (archived data copies)
- A new feature of the GTN is choose your own tutorials.
- Here we have additional syntax you can use in your tutorial text, which lets you have multiple paths through your tutorial.
- We use this currently to have an alternative tool for a single step in a longer tutorial.
- The students can choose between either one assembler, or another.
- In the above graphic, students choose between a lengthy process to acquire data access, or using a public dataset now.
Do you hate re-recording slide decks, once you’ve updated a single number, on a single slide?
- Try automated videos!
- By using the GTN’s slide deck platform
- And adding speaker notes with exactly what you want to say
- We’ll auto-generate a video
- Updating ALL visual + spoken portions ]
.pull-left[ Demo ]
- The GTN has a large library of great slide decks!
- Many of these already had good speaker notes to help other trainers teach a given topic.
- So we automatically generate videos from these slides.
- The speaker notes are read off from the slide and combined with the images, to produce a video.
- This is one such slide deck, which you may be listening to via an automated video currently! If not, check it out now.
- We automatically collect feedback on trainings
- And aggregate it for tutorial authors to see ] .pull-right[ ]
- To support our amazing trainer community, we collect feedback on every tutorial.
- Students are encouraged to fill out a very short form which records any parts they loved, and what they thought needs improvement.
- We aggregate these reports for trainers to see, and use them to improve tutorials.
Page View Metrics
For every training page, the view metrics are public to see how well training is doing
- Additionally one of the most requested features was the ability to see how often a tutorial was viewed.
- We used to use google analytics and obtaining that data required a specific person to access it for us.
- We have replaced that with a public metrics dashboard, where anyone can see the GTN’s page views over time.
- This particular tutorial was has 7.1 thousand unique views over the last 12 months, and we can see that many viewers came from google and a few university websites.
- Love Kahoot in theory?
- But not in practice?
- The GTN has a built-in Kahoot-like quiz interface
- Another feature built into the GTN from teacher frustration was kahoot quizzes.
- We wanted a similar interface, but not full of adverts or using proprietary infrastructure.
- Additionally we wanted something we could track and version control, allowing us to review changes to quizzes like we review changes to tutorials.
- So we built it.
- Here is what the interface looks like, students see an identical one and can click on the large colourful buttons.
- A teacher view is available that is kept in-sync with student views.
- After a question is completed you can review what percentage got it correct.
- Some of the explicitly competitive features like answering more quickly for more points are not present.
Planemo Training Development Kit
- Tutorials require a lot of writing to setup
- Automates the boring parts!
- Build a workflow in Galaxy
- Publish it
- Use ptdk.apps.galaxyproject.eu to create a skeleton
- All steps, tools, parameters are filled out for you!
- We found that writing tutorials was a lot of work, on a lot of routine tasks like describing how to execute Galaxy tools.
- So the Planemo Training Development Kit or PTDK for short was born.
- It converts a workflow in Galaxy, into a tutorial ready to be added to the GTN.
- All workflow steps are converted into text descriptions that students can use to follow the workflow
- It’s just up to you to add in any formative assessments or explanations you need to help your students understand the background of the analysis.
Running a workshop
Lots of resources for new teachers as well:
- For teachers getting into Galaxy training, we have a large library of resources available to you.
- We encourage you to check out the “How to teach with Galaxy” topic in the GTN.
- GTN offers many, many resources for instructors
Thank you!This material is the result of a collaborative work. Thanks to the Galaxy Training Network and all the contributors! This material is licensed under the Creative Commons Attribution 4.0 International License.
- Garcia, L., B. Batut, M. L. Burke, M. Kuzak, F. Psomopoulos et al., 2020 Ten simple rules for making training materials FAIR (S. Markel, Ed.). PLOS Computational Biology 16: e1007854. 10.1371/journal.pcbi.1007854