Overview of the Galaxy Training Material for Instructors

name: inverse
layout: true
class: center, middle, inverse

</span></div>

</span></div>

---

# Overview of the Galaxy Training Material for Instructors

<div class="contributors-line">
		
	
<ul class="text-list">
			
			<li>
				
<a href="/training-material/hall-of-fame/hexylena/" class="contributor-badge contributor-hexylena"><img src="/training-material/assets/images/orcid.png" alt="orcid logo"/><img src="https://avatars.githubusercontent.com/hexylena?s=27" alt="Avatar">Helena Rasche</a>

</li>
</ul>

</div>

<div class="footnote" style="bottom: 8em;"><i class="far fa-calendar" aria-hidden="true"></i><span class="visually-hidden">last_modification</span> Updated: Sep 23, 2022</div>

<div class="footnote" style="bottom: 6em;">

<i class="far fa-play-circle" aria-hidden="true"></i><span class="visually-hidden">video-slides</span> <a href="/training-material/videos/watch.html?v=/teaching/tutorials/gtn-for-instructors/slides">Video slides</a> |

<i class="fas fa-file-alt" aria-hidden="true"></i><span class="visually-hidden">text-document</span><a href="slides-plain.html"> Plain-text slides</a>
</div>

<div class="footnote" style="bottom: 2em;">
    <strong>Tip: </strong>press <kbd>P</kbd> to view the presenter notes
    | <i class="fa fa-arrows" aria-hidden="true"></i><span class="visually-hidden">arrow-keys</span> Use arrow keys to move between slides

</div>

???
Presenter notes contain extra information which might be useful if you intend to use these slides for teaching.

Press `P` again to switch presenter notes off

Press `C` to create a new window where the same presentation will be displayed.
This window is linked to the main window. Changing slides on one will cause the
slide to change on the other.

Useful when presenting.

---

### <i class="far fa-question-circle" aria-hidden="true"></i><span class="visually-hidden">question</span> Questions

- How can I use the GTN for teaching?

- What resources are available?

- Why is it a good choice?

---

### Some questions

- 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

.image-75[![Screenshot of the website](/training-material/topics/contributing/images/website_screenshot.png)]

https://training.galaxyproject.org

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"

![Screenshot with 2 web-browsers open side-by-side: one pointed at the current tutorial and the other at a Galaxy instance](/training-material/topics/contributing/images/interactive_hands_on.png)

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"><div class="col-md-4"> <div class="gtn-card color-agenda">   <div class="card-title">29</div>   <div class="card-text">Topics</div> </div></div><div class="col-md-4"> <div class="gtn-card color-tip">   <div class="card-title">297</div>   <div class="card-text">Tutorials</div> </div></div><div class="col-md-4"> <div class="gtn-card color-details">   <div class="card-title">354</div>   <div class="card-text"><abbr title="Frequently Asked Questions">FAQs</abbr></div> </div></div><div class="col-md-6"> <div class="gtn-card color-comment">   <div class="card-title">279</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.4</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

.image-75[![Screenshot of github repo](/training-material/topics/contributing/images/github_screenshot.png)]

https://github.com/galaxyproject/training-material

???

- 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

???

- 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.

Everywhere:
- 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

![screenshot of tiaas dashboard showing a few jobs queued in grey, and a few completed successfully in green](/training-material/topics/teaching/images/tiaas-status.png)

???

- 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

![video library homepage showing some descriptive text and big buttons leading to video library contents](/training-material/topics/contributing/images/video-library.png)

???

- 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.

---

![video library stats graphic showing 101 hours and 175 videos](/training-material/topics/contributing/images/video-library-stats.png)

???
- 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.

![video library all videos page listing several categories of tutorials with multiple videos covering Assembly, Climate, and Community](/training-material/topics/contributing/images/video-library-list.png)

???

- 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

.pull-left[
![video library detail showing an embedded youtube video, and large metadata box below covering advanced video metadata](/training-material/topics/contributing/images/video-library-detail.png)
]

.pull-right[

Videos with Metadata
- Description
- Who Captioned It
- Associated Materials
- Support Resources
- Length
- License

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!

---

## Course Builder

- 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!](https://gallantries.github.io/course-builder/)

???

- 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!

---

# Tutorial Features

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" (<span class="citation"><a href="https://doi.org/10.1371/journal.pcbi.1007854">Garcia <i>et al.</i> 2020</a></span>)

[*Read more in the FAQ*](/training-material/faqs/gtn/fair_training.html)

- Rich machine-readable metadata, exposed for search engines
- [Tracked in TeSS's Training Repository](https://tess.elixir-europe.org/materials?content_provider=Galaxy+Training)
- 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.

**Visual**

- Screenreader friendly
	- Alternative slide deck views specifically for screen readers
- All images have (overall good) alt text

**Auditory**

- No sound used outside automated videos
- Those have transcripts + SRT captions available

**Cognitive**

- Animations respond to `prefers-reduced-motion`
- 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

.pull-left[
- Massive library of common questions
- Questions over Galaxy
- Questions over the GTN
- Reusable snippets that can be used in tutorials!
- [See them here!](/training-material/faqs/)
]

.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.

---

## Automatic Notebooks

.pull-left[
- 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:

1. Write a GTN tutorial like normal
2. Enable the feature.
3. Select your programming language.
4. Automatic Notebooks are generated!
]

.pull-right[
![screenshot of a jupyter notebook showing the tutorial contents, including normal question and solution boxes.](/training-material/topics/contributing/images/jupyter-notebook-tutorial.png)
]

???

- 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)

![gtn tutorial showing a CYOA box with EGA-Archive selected, and a big heading about getting DAC access](/training-material/topics/contributing/images/cyoa-a.png)
]

.pull-right[
Or **Path B** (archived data copies)

![same tutorial but with the second option selected, accessing data stored on Zenodo and a hands on box instructing the student to download from URL](/training-material/topics/contributing/images/cyoa-b.png)
]

???

- 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.

---

## Autogenerated Videos

Do you hate re-recording slide decks, once you've updated a single number, on a single slide?

.pull-right[
- 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[
![screenshot of the GTN's video player showing a slide about configuration management, with a transcript and recommended other video below](/training-material/topics/contributing/images/gtn-videos.png)
[**Demo**](https://training.galaxyproject.org/videos/watch.html?v=introduction/tutorials/galaxy-intro-short/slides)
]

???

- 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.

---

## Feedback

.pull-left[
- We automatically collect feedback on trainings
- And aggregate it for tutorial authors to see
]
.pull-right[
![two charts show a growth in responses over time, and a heavily 5-star distributino of ratings of a particular tutorial. Below is a section of detailed feedback listing positive and negative aspects.](/training-material/topics/contributing/images/feedback.png)
]

???

- 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

![plausible interface screenshot showing that we've drilled down into an introduction tutorial that had 7.1k unique visitors over the last 12 months, with 12k total page views. Below is a top sources table, most come from google, and a top pages table which only shows our selected training page.](/training-material/topics/contributing/images/plausible.png)

???

- 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.

---

## Integrated Quizzes

- Love Kahoot in theory?
- But not in practice?
- The GTN has a built-in Kahoot-like quiz interface

![image of the gtn section on quizzes with a SQL basics recap quiz, offering self study and classroom modes.](/training-material/topics/contributing/images/quiz.png)

???

- 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.

---

![Image of the quiz with the question "What keyword do you use to retrieve data in SQL" and four options in pastel colours.](/training-material/topics/contributing/images/quiz-view.png)

???

- 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!

Steps:

1. Build a workflow in Galaxy
2. Publish it
3. Use [ptdk.apps.galaxyproject.eu](http://ptdk.apps.galaxyproject.eu) to create a skeleton
4. 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:

- Set up a Galaxy for Training ([tutorial](/training-material/topics/teaching/tutorials/setup-galaxy-for-training/tutorial.html))
- Good practices to run a workshop ([tutorials](/training-material/topics/teaching/))

???

- 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.

---
### <i class="fas fa-key" aria-hidden="true"></i><span class="visually-hidden">keypoints</span> Key points

- GTN offers many, many resources for instructors

---

## Thank You!

This material is the result of a collaborative work. Thanks to the [Galaxy Training Network](https://training.galaxyproject.org) and all the contributors!

<div class="contributors-line">
		
<table class="contributions">
	
	<tr>
		<td><abbr title="These people wrote the bulk of the tutorial, they may have done the analysis, built the workflow, and wrote the text themselves.">Author(s)</abbr></td>
		<td>
			
<a href="/training-material/hall-of-fame/hexylena/" class="contributor-badge contributor-hexylena"><img src="/training-material/assets/images/orcid.png" alt="orcid logo"/><img src="https://avatars.githubusercontent.com/hexylena?s=27" alt="Avatar">Helena Rasche</a>

</td>
	</tr>

</table>

</div>

</div>

<a rel="license" href="https://creativecommons.org/licenses/by/4.0/">
This material is licensed under the Creative Commons Attribution 4.0 International License</a>.