Skip to content

update assignments for DyOc #284

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.

Sign up for GitHub

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

Open
ammedd wants to merge 9 commits into
base: main
Choose a base branch
from
Open

update assignments for DyOc #284

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
93ff951
update assignments
ammedd Feb 11, 2026
f524701
fix notes
ammedd Feb 12, 2026
cba2f7b
add participant letter
ammedd Feb 12, 2026
54cce65
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Feb 12, 2026
824450e
add research proposal again
ammedd Feb 12, 2026
1b05546
merge pre-commit changes
ammedd Feb 12, 2026
878499e
note on CTD_BGC
j-atkins Feb 12, 2026
be575ec
internal link
j-atkins Feb 12, 2026
1269876
fix CoC date
ammedd Feb 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/user-guide/assignments/Code_of_conduct.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"_Please read this code of conduct, fill out the [parts between brackets] after consultation with your group, remove these italic sections, and then all individually upload a copy to Brightspace before Wednesday 18 February 13:00._ \n",
"_Please read this code of conduct, fill out the [parts between brackets] after consultation with your group, remove these italic sections, and then all individually upload a copy to Brightspace before Friday 20 February 17:00._ \n",
"\n",
"**Note that the Code of Conduct applies to the actual collaboration within your group in the VirtualShip Assignment; so is not about how you would work on the ship.**\n",
"\n",
Expand All @@ -23,7 +23,7 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"This code of conduct has been decided by [NAMES] for their group project during the Virtual Ship Classroom and is enacted from [DD-MM-YYYY]. The procedure is based on [this exercise by Aurelia Moser](http://aureliamoser.com/aaas-guides/conduct/index.html).\n",
"This code of conduct has been decided by [NAMES] for their group project during the Virtual Ship Classroom and is enacted from [DD-MM-YYYY]. The procedure is based on an exercise by [Aurelia Moser](https://github.com/auremoser/aaas-guides/blob/master/CODE_OF_CONDUCT.md).\n",
"\n",
"Everyone taking part in the course and group discussions (mentors, helpers, coordinators, and learners) is required to conform to the following Code of Conduct. Coordinators will oversee adherence to this code throughout the course.\n",
"\n",
Expand Down
6 changes: 5 additions & 1 deletion docs/user-guide/assignments/Research_Proposal_only.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,11 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"# Research Proposal for student grant"
"# Research Proposal for student grant\n",
"\n",
"<div class=\"alert alert-block alert-warning\"> \n",
"**Note**: This can be used as a separate exercise in the VirtualShip Classroom where students don't interact with VirtualShip but only write a proposal\n",
"</div>"
]
},
{
Expand Down
17 changes: 13 additions & 4 deletions docs/user-guide/assignments/Research_proposal_intro.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,9 @@
"\n",
"Congratulations on receiving a student research grant for ship time on a scientific research vessel! This achievement is a testament to your hard work and commitment to advancing marine science. The opportunity will undoubtedly enhance your research and contribute significantly to our understanding of marine science. \n",
"\n",
"You will have access to the ship for a three-week period—a duration identified as a favorable trade-off between research time and ensuring an enjoyable vessel experience. Your vessel will be equipped with two vessel-mounted ADCPs, a CTD, and can collect underway data of temperature and salinity from 2 meters below the hull of the ship. In addition, you can deploy XBTs and up to 30 Argo floats and/or 30 surface drifters. A detailed plan of your route, timing and required instruments needs to be sent in for approval/grading. \n",
"You will have access to the ship for a maximum of three weeks, period—a duration identified as a favorable trade-off between research time and ensuring an enjoyable vessel experience. Your vessel will be equipped with two vessel-mounted ADCPs, a CTD, and can collect underway data of temperature and salinity from 2 meters below the hull of the ship. In addition, you can deploy XBTs and up to 30 Argo floats and/or 30 surface drifters. A detailed plan of your route, timing and required instruments needs to be sent in for approval/grading. \n",
"\n",
"To get a taste of what it’s like to board a real vessel, you'll find some [general information that is shared with all cruise participants here](https://surfdrive.surf.nl/files/index.php/s/i2u2zqNNFECbOlJ)\n",
"To get a taste of what it’s like to board a real vessel, you'll find some [general information that is shared with all cruise participants here](../teacher-content/letter.md)\n",
"\n",
"You might also like to watch the video clip about [Life on board a research ship (RRS Discovery)](https://youtu.be/IHM7JFWg9qw?feature=shared) or the one below. \n",
"\n",
Expand All @@ -28,7 +28,7 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"In your grant application you’ve shown great potential, so you can choose to do your research [in any of these areas](https://surfdrive.surf.nl/files/index.php/s/808kAVvQUN6bH9u) or discuss your own idea with your teacher.\n",
"In your grant application you’ve shown great potential, so you can choose to do your research [in any of these areas](./case_studies_virtualship.ipynb) or discuss your own idea with your teacher.\n",
"\n",
"We’ve prepared some exercises to help you get familiar with the type of data that will be collected by the research vessel. Research is typically done on **station** while staying stationary for a period of time, or while moving over a **transect**. So let’s give you some more information on the different scientific instruments first. \n"
]
Expand Down Expand Up @@ -97,6 +97,11 @@
"\n",
"In total, therefore, you can expect a CTD deployment to take approximately 50 minutes.\n",
"\n",
"<!-- TODO: this note can be removed when CTD and CTD_BGC are combined to one instrument -->\n",
"<div class=\"alert alert-block alert-info\"> \n",
"**Note**: If you are deploying CTDs in both standard and biogeochemical configurations (`CTD` and `CTD_BGC`) in your [VirtualShip expeditions](./Sail_the_ship.ipynb), you only need to factor in the 50 minutes **once** per waypoint, as both can be deployed on the same cast.\n",
"</div>\n",
"\n",
Comment on lines +100 to +104
Copy link
Collaborator

@j-atkins j-atkins Feb 12, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is what I added - are you happy with this @ammedd ?

Copy link
Collaborator Author

@ammedd ammedd Feb 12, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes

"<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/7N2UsPDczTw\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture\" allowfullscreen></iframe>"
]
},
Expand Down Expand Up @@ -158,7 +163,11 @@
{
"cell_type": "markdown",
"metadata": {},
"source": []
"source": [
"![](https://www.nioz.nl/sites/default/files/styles/ratio_16_9_md/public/migrated-images/2023-01-16-packing.jpg?itok=NDkcxMBM)\n",
"![](https://www.nioz.nl/sites/default/files/styles/ratio_16_9_md/public/migrated-images/2023-01-23-container02.jpg?itok=1W9nQ7eU)\n",
"![](https://www.nioz.nl/sites/default/files/styles/ratio_16_9_md/public/migrated-images/2023-03-06-container-shifting.jpg?itok=OIuysnEm)"
]
}
],
"metadata": {
Expand Down
3 changes: 3 additions & 0 deletions docs/user-guide/assignments/Sail_the_ship.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -158,6 +158,9 @@
"\n",
"The easiest way to do so is to use the bespoke VirtualShip planning tool. Enter the following command in Terminal: `virtualship plan EXPEDITION_NAME`.\n",
"\n",
"<div class=\"alert alert-block alert-success\"> \n",
"**TIP**: Using the `virtualship plan` tool is optional. Advanced users can also edit the `expedition.yaml` file directly if preferred.\n",
"</div>\n",
"\n",
"### Ship speed\n",
"\n",
Expand Down
18 changes: 11 additions & 7 deletions docs/user-guide/assignments/Virtualship_research_proposal.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,9 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"Please read the [Introduction](./Research_proposal_intro.ipynb) and fill out the Proposal below."
"<div class=\"alert alert-block alert-warning\"> \n",
"**IMPORTANT**: Please read the [Introduction](./Research_proposal_intro.ipynb) and fill out the Proposal below.\n",
"</div>"
]
},
{
Expand All @@ -35,7 +37,7 @@
"### Project Data\n",
"1. **Title of the proposal**\n",
"\n",
"Please choose an appropriate and concise title for the expedition that refers to the work area. \n",
"Please choose an appropriate and concise title for the expedition that refers to the work area or your research topic. \n",
"\n",
"2. **Cruise participants**\n",
"\n",
Expand Down Expand Up @@ -64,7 +66,7 @@
"[Argo float observations of basin-scale deep convection in the Irminger sea during winter 2011–2012](https://doi.org/10.1016/j.dsr.2015.12.012)\n",
"\n",
"\n",
"<i>Note that your question does not have to be novel. The most important is that it is researchable with the expedition planned here. <i>"
"<i>Note that your question does not have to be novel. The most important is that it is researchable with the expedition planned here. You'll have data for the duration of your expedition and up to 6 weeks of Drifter and Argo float data. <i>"
]
},
{
Expand Down Expand Up @@ -112,7 +114,7 @@
"A map and cruise plan can be created through [the NIOZ MFP website](https://nioz.marinefacilitiesplanning.com/cruiselocationplanning#)\n",
"\n",
"Documentation on how to use the website can be found [here](https://surfdrive.surf.nl/files/index.php/s/84TFmsAAzcSD56F) and you can watch the video below.\n",
"<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/yIpYX2xCvsM?si=sEXq0Zn5z94JJ3yE\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen></iframe>"
"<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/yIpYX2xCvsM?si=1yNOfK0kjUzfk6WX\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen></iframe>"
]
},
{
Expand All @@ -121,7 +123,7 @@
"source": [
"6. **Cruise period**\n",
"\n",
"Please state the preferred year, season, and/or month(s) for the cruise, and provide reasons for restrictions to limited periods. Because we are sampling from reanalysis data, dates are limited from 1 Nov 2020 to present. \n"
"Please state the preferred year, season, and/or month(s) for the cruise, and provide reasons for restrictions to limited periods. Because we are sampling from reanalysis data, dates are available from 1993 to present, but we recommend choosing a period from 1 Nov 2020 to present. \n"
]
},
{
Expand All @@ -130,7 +132,7 @@
"source": [
"7. **Scientific work program**\n",
"\n",
"Please upload a screenshot of the MFP website inlcuding port of departure and arrival, all stations (and transects) and total time. Please indicate at each station what instruments you want to deploy (CTD, Argo float, drifter, XBT) and take the deployment time into account. If you plan to use Argo floats, please give the required depth and cycle duration. In case of the CTD the deployment time depends on the depth of the ocean. Note that transit times from the port of departure to the first station and from the last station in the working area to the port of arrival are regarded as work days at sea, so they are deducted from your three-week availability. "
"Please upload a screenshot of the MFP website inlcuding port of departure and arrival, all stations (and transects) and total time. Please indicate at each station what instruments you want to deploy (CTD, Argo float, drifter, XBT) and take the deployment time into account. If you plan to use Argo floats, please give the required depth and cycle duration. In case of the CTD the deployment time depends on the depth of the ocean. Note that transit times from the port of departure to the first station and from the last station in the working area to the port of arrival are regarded as work days at sea, so they are deducted from your (three-week) availability. "
]
},
{
Expand All @@ -146,7 +148,9 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"Remember to download your schedule from the MFP website using the Export button on the right in case you want to continue working with it."
"<div class=\"alert alert-block alert-info\"> \n",
"**NOTE**: Download your schedule from the MFP website using the Export button on the right (Export -> Export Coordinates -> DD) to continue working with it and/or import it into VirtualShip.\n",
"</div>"
]
}
],
Expand Down
1 change: 1 addition & 0 deletions docs/user-guide/assignments/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ maxdepth: 1
caption: Assignments
---
Research_proposal_intro.ipynb
Research_proposal_only.ipynb
Virtualship_research_proposal.ipynb
sciencecommunication_assignment.ipynb
Code_of_conduct.ipynb
Expand Down
12 changes: 6 additions & 6 deletions docs/user-guide/teacher-content/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ VirtualShip is used as part of the VirtualShip Classroom, that combines authenti

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.ipnb) 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).
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.ipynb) 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:

Expand All @@ -16,12 +16,12 @@ The VSC design focuses on creating didactically sound, authentic learning experi

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: 2
caption: Teaching material
---
```{toctree}
:maxdepth: 1
:caption: Teaching materials

ILOs.ipynb
letter.md
```

```{nbgallery}
Expand Down
Loading