More tutorial notebooks for plotting (#256)

* add small random noise to drifter release locations

* first updates to argo and drifter plotting notebooks

* enhancements to drifter plotting

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* add limit to offset which can be added

* update test to account for x,y offsets

* hide old notebooks from docs tutorials

* add waypoint locations to plot and more guidance through notebook

* generic data dir path

* clean up text

* update argo/drifter plotting tutorial

* refactor tutorial headings for consistency and clarity

* new argo plotting tutorial

* new xbt plotting tutorial

* adjust default data dir path

* remove unnecessary imports

* small edits

* new underway st tutorial, plus update index.md

* update sail the ship to point to tutorials for plotting help

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: j-atkins

docs/user-guide/assignments/Sail_the_ship.ipynb

@@ -229,7 +229,11 @@
     "\n",
     "If this is your first time running VirtualShip, you will be prompted to enter your own Copernicus Marine Data Store credentials (these will be saved automatically for future use).\n",
     "\n",
-    "Small simulations (e.g. small space-time domains and fewer instrument deployments) will be relatively fast. For large, complex expeditions, it _could_ take up to an hour to simulate the measurements depending on your choices. Waiting for simulation is a great time to practice your level of patience. A skill much needed in oceanographic fieldwork ;-)"
+    "Small simulations (e.g. small space-time domains and fewer instrument deployments) will be relatively fast. For large, complex expeditions, it _could_ take up to an hour to simulate the measurements depending on your choices. Waiting for simulation is a great time to practice your level of patience. A skill much needed in oceanographic fieldwork ;-)\n",
+    "\n",
+    "<div class=\"alert alert-block alert-success\"> \n",
+    "**TIP**: Not using underway instruments will speed up the simulation time considerably. So, if you do not plan to use underway temperature/salinity or ADCP measurements, make sure to switch these off in the planning tool before running the expedition.\n",
+    "</div>"
    ]
   },
   {
@@ -240,9 +244,11 @@
     "\n",
     "Upon successfully completing the simulation, results from the expedition will be stored in the `EXPEDITION_NAME/results` directory, written as [Zarr](https://zarr.dev/) files.\n",
     "\n",
-    "From here you can carry on your post-processing analysis, **but we will focus more on this in the next VirtualShip classroom session**.\n",
+    "From here you can carry on your analysis. In general, we encourage you to explore and analyse these data using [Xarray](https://docs.xarray.dev/en/stable/). We also provide various further [VirtualShip tutorials](https://virtualship.readthedocs.io/en/latest/user-guide/tutorials/index.html) which provide examples of how to visualise data recorded by the VirtualShip instruments. Use these to help you get started!\n",
+    "\n",
+    "If you are using VirtualShip in class, the same tutorial notebooks will be uploaded in your SURF RC environment for you to use and interact directly with the code. These should be available in e.g. the `data/storage-osl/tutorials/` directory. You will notice that there is a notebook file dedicated to visualising each of the different instruments available in VirtualShip. \n",
     "\n",
-    "In general, we encourage you to explore and analyse these data using [Xarray](https://docs.xarray.dev/en/stable/). We also provide various further [VirtualShip tutorials](https://virtualship.readthedocs.io/en/latest/user-guide/tutorials/index.html) which provide examples of how to visualise data recorded by the VirtualShip instruments."
+    "To run these notebooks with your own data, you will need to copy the them over to your expedition working directory (i.e. `data/storage-osl/{your-group-name}`). This can be done by either 1) using the file explorer panel in JupyterLab to copy the relevant files or the via the command line in Terminal. In the terminal, running `cp -r /data/storage-osl/tutorials/* /data/storage-osl/{your-group-name}/` would copy __all__ the tutorial notebooks to your group's directory, so if you only want to copy specific ones, make sure to adjust the command accordingly."
    ]
   },
   {

docs/user-guide/tutorials/Argo_data_tutorial.ipynb

@@ -3,14 +3,23 @@
 ```{nbgallery}
 ---
 maxdepth: 1
-caption: Tutorials
+caption: Post-processing results
 ---
-surf_research_cloud_setup.ipynb
-surf_collaborative_setup.ipynb
-ADCP_data_tutorial.ipynb
-CTD_data_tutorial.ipynb
+<!-- ADCP_data_tutorial.ipynb -->
+<!-- CTD_data_tutorial.ipynb -->
 Drifter_data_tutorial.ipynb
 Argo_data_tutorial.ipynb
 CTD_transects.ipynb
 ADCP_transects.ipynb
+xbt_plotting.ipynb
+Ship_underwater_ST_plotting.ipynb
+```
+
+```{nbgallery}
+---
+maxdepth: 1
+caption: SURF Research Cloud set up
+---
+surf_research_cloud_setup.ipynb
+surf_collaborative_setup.ipynb
 ```