Skip to content

Commit 4a8bd9e

Browse files
Apply suggestions from code review
Co-authored-by: Erik van Sebille <[email protected]>
1 parent 6f5426c commit 4a8bd9e

File tree

1 file changed

+8
-7
lines changed

1 file changed

+8
-7
lines changed

docs/paper/paper.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -14,21 +14,22 @@ authors:
1414
affiliation: "1, 2"
1515
- name: Emma E. Daniels
1616
orcid: 0009-0005-9805-5257
17-
affiliation: 2
18-
- name: Nick Hodgskin
1917
affiliation: 1
18+
- name: Nick Hodgskin
19+
affiliation: 2
2020
- name: Aart C. Stuurman
21+
affiliation: 1
2122
- name: Iury Simoes-Sousa
2223
orcid: 0000-0002-2484-510X
23-
affiliation: 2
24+
affiliation: 3
2425
- name: Erik van Sebille
2526
orcid: 0000-0003-2041-0704
2627
affiliation: "1, 2"
2728

2829
affiliations:
29-
- name: Institute for Marine and Atmospheric Research, Utrecht University, the Netherlands
30-
index: 1
3130
- name: Freudenthal Institute, Utrecht University, the Netherlands
31+
index: 1
32+
- name: Institute for Marine and Atmospheric Research, Utrecht University, the Netherlands
3233
index: 2
3334
- name: Woods Hole Oceanographic Institution, Falmouth, MA, USA
3435
index: 3
@@ -44,7 +45,7 @@ bibliography: paper.bib
4445

4546
Marine science relies on fieldwork for data collection, yet sea-going opportunities are limited due to financial costs, logistical constraints, and environmental burdens. We present an alternative means, namely `VirtualShip`, for training scientists to conduct oceanographic fieldwork in an authentic manner, to plan future expeditions and deployments, and to directly compare observational and instrumentational strategies with model data.
4647

47-
`VirtualShip` goes beyond simply extracting grid-cell values from model output. Instead, it uses programmable behaviours and sophisticated interpolation techniques (with `Parcels` underpinnings) to access data in exact locations and timings, as if they were being collected by real-world instruments. `VirtualShip` shares some functionality with existing tools, such as `OceanSpy` [@Almansi2019] and `VirtualFleet` [@Maze2023], but extends capabilities to mesh many different instrument deployments into a unified expedition simulation framework. Moreover, `VirtualShip` exploits readily available, streamable data via the Copernicus Marine Data Store, removing the need for users to download and manage large datasets locally and/or arrange for access to remote servers. `VirtualShip` can also integrate coordinate files exported from the [NIOZ Marine Facilities Planning](https://nioz.marinefacilitiesplanning.com/cruiselocationplanning#) (MFP) tool, giving users the option to define expedition waypoints via an intuitive web-based mapping interface.
48+
`VirtualShip` goes beyond simply extracting grid-cell values from model output. Instead, it uses programmable behaviours and sophisticated interpolation techniques (with `Parcels` underpinnings) to access data in exact locations and timings, as if they were being collected by real-world instruments. `VirtualShip` shares some functionality with existing tools, such as `OceanSpy` [@Almansi2019] and `VirtualFleet` [@Maze2023], but extends capabilities to mesh many different instrument deployments into a unified expedition simulation framework. Moreover, `VirtualShip` exploits readily available, streamable data via the Copernicus Marine Data Store, removing the need for users to download and manage large datasets locally and/or arrange for access to remote servers. `VirtualShip` can also integrate coordinate files exported from the [Marine Facilities Planning](https://www.marinefacilitiesplanning.com/cruiselocationplanning#) (MFP) tool, giving users the option to define expedition waypoints via an intuitive web-based mapping interface.
4849

4950
# Functionality
5051

@@ -54,7 +55,7 @@ The software can simulate complex multidisciplinary expeditions. One example is
5455

5556
![Example VirtualShip expedition simulated in July/August 2023. Expedition waypoints displayed via the NIOZ MFP tool (a), Underway ADCP measurements (b), Surface drifter releases (c; 90-day lifetime per drifter), and CTD vertical profiles for temperature (d) and oxygen (e). Black triangles in b), d) and e) mark waypoint locations across the expedition route, corresponding to the purple markers in a).\label{fig:fig1}](figure1.png)
5657

57-
The software is designed to be highly accessible to the user. It is wrapped into three high-level command line interface commands (using [Click](https://click.palletsprojects.com/en/stable/)):
58+
The software is designed to be highly intuitive to the user. It is wrapped into three high-level command line interface commands (using [Click](https://click.palletsprojects.com/en/stable/)):
5859

5960
1. `virtualship init`: Initialises the expedition directory structure and an `expedition.yaml` configuration file, which controls the expedition route, instrument choices and deployment timings. A common workflow is for users to import pre-determined waypoint coordinates using the `--from-mfp` flag in combination with a coordinates `.csv` or `.xlsx` file (e.g. exported from the NIOZ MFP tool).
6061
2. `virtualship plan`: Launches a user-friendly Terminal-based expedition planning User Interface (UI), built using [`Textual`](https://textual.textualize.io/). This allows users to intuitively set their waypoint timings and instrument selections, and also modify their waypoint locations.

0 commit comments

Comments
 (0)