-
Notifications
You must be signed in to change notification settings - Fork 8
add teacher info to documentation #213
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
Merged
Merged
Changes from 6 commits
Commits
Show all changes
7 commits
Select commit
Hold shift + click to select a range
92bf5a3
add teacher info to documentation
ammedd 2f459e0
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] 53c430c
incoporate review suggestions
ammedd b81efd4
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] b699137
fix default thumbnail
ammedd 6e657de
change ILOs to ipynb
ammedd d6bda23
Merge branch 'main' into teacher-content
ammedd File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -4,6 +4,7 @@ | |
| :maxdepth: 1 | ||
|
|
||
| quickstart | ||
| teacher-content/index | ||
| tutorials/index | ||
| assignments/index | ||
| ``` | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,69 @@ | ||
| { | ||
| "cells": [ | ||
| { | ||
| "cell_type": "markdown", | ||
| "id": "84d1c60b", | ||
| "metadata": {}, | ||
| "source": [ | ||
| "# Aligned learning outcomes\n", | ||
| "\n", | ||
| "_Aligned using the revised version of Blooms taxonomy (Anderson et al. 2001)_\n", | ||
| "\n", | ||
| "1. Identify practical challenges of planning sea-based research, such as:\n", | ||
| "\n", | ||
| "- Availability and capabilities of research vessels and equipment, e.g. ice breaker vessel needed, infrastructure for equipment available\n", | ||
| "- General logistics, e.g. transportation of container labs and other equipment\n", | ||
| "- Requesting permits\n", | ||
| " - Travel permits for staff\n", | ||
| " - Diplomatic clearance (EEZ)\n", | ||
| " - Customs documents\n", | ||
| "- Safety trainings (beforehand and onboard)\n", | ||
| "- Preparing, testing and transporting equipment\n", | ||
| "\n", | ||
| "2. Be aware of (describe) matters during sea-based research, such as:\n", | ||
| "\n", | ||
| "- Contingency due to weather conditions and other unforeseen circumstances\n", | ||
| "- The need to be flexible and patient\n", | ||
| "- Taking notes, recording coordinates, stations, casts\n", | ||
| "- Measurement protocols\n", | ||
| "- Communication with crew, e.g. captain, winch driver\n", | ||
| "- Living at sea, e.g. sea legs, seasickness, relaxation, water/energy/waste footprint\n", | ||
| "\n", | ||
| "3. Give examples of uncertainty and variability of sea-based observations, such as:\n", | ||
| "\n", | ||
| "- Likely errors or wrong values, and seeing the data through the noise\n", | ||
| "- Time and date coordinates, e.g. UTC, local time, ship time\n", | ||
| "- Variability and limitations of measurements\n", | ||
| "- Different scales of variability, e.g. tidal, seasonal\n", | ||
| "- ‘Synopticity’ of measurements (i.e. not possible to measure with one ship at multiple locations at the same time; therefore mixing time and space variability)\n", | ||
| "- Instrument specific qualities, e.g. ADCP reflection\n", | ||
| "\n", | ||
| "4. Learn how to analyse and interpret sea-based observations. Be able to:\n", | ||
| "\n", | ||
| "- Read in different data formats, e.g. nc, csv, zarr\n", | ||
| "- Manipulate arrays and other data structures in python\n", | ||
| "- Create and interpret density/TS profiles\n", | ||
| "- Create spatial temperature/salinity/velocity maps, do GIS things\n", | ||
| "- Interpret plots and deduce ocean circulation\n", | ||
| "- Report findings\n", | ||
| "- Contribute to a cruise report with pictures or plots\n", | ||
| "\n", | ||
| "5. Plan a research cruise. Be able to:\n", | ||
| "\n", | ||
| "- Formulate research questions\n", | ||
| "- Select sampling sites\n", | ||
| "- Consider the duration of deployments, e.g. time a CTD station takes\n", | ||
| "- Decide on on-site measurement order\n", | ||
| "- Plan rest/working shifts for scientific personnel\n", | ||
| "- Deal with contingency, e.g. consider what sites/measurements are essential, which are ok to skip" | ||
| ] | ||
| } | ||
| ], | ||
| "metadata": { | ||
| "language_info": { | ||
| "name": "python" | ||
| } | ||
| }, | ||
| "nbformat": 4, | ||
| "nbformat_minor": 5 | ||
| } |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,26 @@ | ||
| # Teacher content | ||
|
|
||
| VirtualShip is used as part of the VirtualShip Classroom, that combines authentic tools with VR to create a virtual fieldwork experience and allows you to teach about sea-based research from your regular classroom. | ||
|
|
||
| All VirtualShip Classroom (VSC) material is open under an MIT licence and freely available! You can use the VSC to teach anything from a 4 hour masterclass up to an open assignment of more than 40 hours. Example assignments are available below and please feel free to customize anything offline or [contribute](../../contributing/index.md) to the assignments provided here. | ||
|
|
||
| Our core learning outcome is for students to appreciate the difficulty of measuring the ocean, making the VSC a valuable tool for students that will go into fieldwork, modelling or anything else. Additional Intended Learning Outcomes [(ILOs)](ILOs.md) were formulated in collaboration with ocean scientists from the Royal Netherlands Institute for Sea Research [(NIOZ)](https://www.nioz.nl/en) and Utrecht University [(UU)](https://www.uu.nl/en). | ||
|
|
||
| The 360 videos are available on our YouTube channel [**_@VirtualShip Classroom_**](https://www.youtube.com/@VirtualShipClassroom) and in high resolution upon request. The videos can be viewed in the classroom or at home using: | ||
|
|
||
| - VR Headsets – Wear a headset and look around naturally by moving your head. | ||
| - Smartphones/Tablets – Move your device or swipe the screen to explore. | ||
| - PC/Mac Browsers – Click and drag with your mouse to look around. | ||
|
|
||
| The VSC design focuses on creating didactically sound, authentic learning experiences grounded in established learning theories in science education, such as constructivism [(Piaget 1954)](https://doi.org/10.4324/9781315009650) and constructionism [(Papert 1980)](https://worrydream.com/refs/Papert_1980_-_Mindstorms,_1st_ed.pdf). By integrating realistic tasks and a gamified narrative approach within Jupyter notebooks, students learn within a digital replica of the real world, constructing knowledge through ‘learning by doing’ and ‘trial and error’ as they explore oceanography concepts, research methods, and analysis tools. | ||
|
|
||
| We evaluated in several (under)graduate courses and find that the VirtualShip Classroom is highly engaging, and students report on enhanced confidence and knowledge [(Daniels et al. 2025)](https://current-journal.com/articles/10.5334/cjme.121). | ||
|
|
||
| ```{nbgallery} | ||
| --- | ||
| maxdepth: 1 | ||
| caption: Teaching material | ||
| --- | ||
| ILOs.md | ||
| ``` | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is it possible to add a picture to the tile? It now says "No Thumbnail"
And while the asterisk is nice on the ILOs.md website itself, it may be a bit confusing here? Remove it?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I tried to add a thumbnail but don't think it worked. Can you have a look why it doesn't work? Is there a better workflow to add thumbnails?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think the problem here is that this document is a markdown document and not a jupyter notebook - since the package we use for this is
nbsphinxits built for Jupyter notebook so adding a markdown file in the gallery is not really supported.I think that we should just remove the gallery aspect and use a table of contents
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
You can also update the file to be a jupyter notebook, that's another option
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for checking this out!
Updating the file to notebook sounds good. I'll be filling this section with more content, so it's nice to keep the gallery I guess. I'll think about it more when adding more files.