Skip to content

Commit 0552d3d

Browse files
j-atkinsj-atkins
committed
update documentation, describing the different coperncius products used
1 parent 56e400c commit 0552d3d

3 files changed

Lines changed: 86 additions & 0 deletions

File tree

‎docs/user-guide/additional_information.md‎

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
# Additional information
2+
3+
This file contains additional technical information and guidance not covered in the [Quickstart](https://virtualship.readthedocs.io/en/latest/user-guide/quickstart.html) guide or in the [Tutorials](https://virtualship.readthedocs.io/en/latest/user-guide/tutorials/index.html).
4+
5+
### Copernicus Marine products
6+
7+
VirtualShip supports running experiments anywhere in the global ocean from 1993 through to the present day (and approximately two weeks into the future), using the suite of products available from the [Copernicus Marine Data Store](https://data.marine.copernicus.eu/products).
8+
9+
The data sourcing task is handled by the `virtualship fetch` command. The three products relied on by `fetch` to source data for all [VirtualShip instruments](https://virtualship.readthedocs.io/en/latest/user-guide/assignments/Research_proposal_intro.html#Measurement-Options) (both physical and biogeochemical) are:
10+
11+
1. **Reanalysis** (or "hindcast" for biogeochemistry).
12+
2. **Renalysis interim** (or "hindcast interim" for biogeochemistry).
13+
3. **Analysis & Forecast**.
14+
15+
```{tip}
16+
The Copernicus Marine Service describe the differences between the three products in greater detail [here](https://help.marine.copernicus.eu/en/articles/4872705-what-are-the-main-differences-between-nearrealtime-and-multiyear-products).
17+
```
18+
19+
As a general rule of thumb the three different products span different periods across the historical period to present and are intended to allow for continuity across the previous ~ 30 years.
20+
21+
```{note}
22+
The ethos for automated dataset selection in `virtualship fetch` is to prioritise the Reanalysis/Hindcast products where possible (the 'work horse'), then _interim products where possible for continuity, and finally filling the very near-present (and near-future) temporal range with the Analysis & Forecast products.
23+
```
24+
25+
```{warning}
26+
In the rare situation where the start and end times of an expedition schedule span different products, which is possible in the case of the end time being in the **Reanalysis_interim** period and the start time in the **Reanalysis** period, the **Analysis & Forecast** product will be automatically selected, as this spans back enough in time for this niche case.
27+
```
28+
29+
### Data availability
30+
31+
The following tables summarise which Copernicus product is selected by `virtualship fetch` per combination of time period and variable (see legend below).
32+
33+
For biogeochemical variables `ph` and `phyc`, monthly products are required for hindcast and hindcast interim periods. For all other variables, daily products are available.
34+
35+
#### Physical products
36+
37+
| Period | Product ID | Temporal Resolution | Typical Years Covered | Variables |
38+
| :------------------ | :--------------------------------------- | :------------------ | :---------------------------------- | :------------------------- |
39+
| Reanalysis | `cmems_mod_glo_phy_my_0.083deg_P1D-m` | Daily | ~30 years ago to ~5 years ago | `uo`, `vo`, `so`, `thetao` |
40+
| Reanalysis Interim | `cmems_mod_glo_phy_myint_0.083deg_P1D-m` | Daily | ~5 years ago to ~2 months ago | `uo`, `vo`, `so`, `thetao` |
41+
| Analysis & Forecast | `cmems_mod_glo_phy_anfc_0.083deg_P1D-m` | Daily | ~2 months ago to ~2 weeks in future | `uo`, `vo`, `so`, `thetao` |
42+
43+
---
44+
45+
#### Biogeochemical products
46+
47+
| Period | Product ID | Temporal Resolution | Typical Years Covered | Variables | Notes |
48+
| :---------------------------- | :----------------------------------------- | :------------------ | :---------------------------------- | :-------------------------------- | :------------------------------------- |
49+
| Hindcast | `cmems_mod_glo_bgc_my_0.25deg_P1D-m` | Daily | ~30 years ago to ~5 years ago | `o2`, `chl`, `no3`, `po4`, `nppv` | Most BGC variables except `ph`, `phyc` |
50+
| Hindcast (monthly) | `cmems_mod_glo_bgc_my_0.25deg_P1M-m` | Monthly | ~30 years ago to ~5 years ago | `ph`, `phyc` | Only `ph`, `phyc` (monthly only) |
51+
| Hindcast Interim | `cmems_mod_glo_bgc_myint_0.25deg_P1D-m` | Daily | ~5 years ago to ~2 months ago | `o2`, `chl`, `no3`, `po4`, `nppv` | Most BGC variables except `ph`, `phyc` |
52+
| Hindcast Interim (monthly) | `cmems_mod_glo_bgc_myint_0.25deg_P1M-m` | Monthly | ~5 years ago to ~2 months ago | `ph`, `phyc` | Only `ph`, `phyc` (monthly only) |
53+
| Analysis & Forecast (O2) | `cmems_mod_glo_bgc-bio_anfc_0.25deg_P1D-m` | Daily | ~2 months ago to ~2 weeks in future | `o2` | |
54+
| Analysis & Forecast (Chl) | `cmems_mod_glo_bgc-pft_anfc_0.25deg_P1D-m` | Daily | ~2 months ago to ~2 weeks in future | `chl`, `phyc` | |
55+
| Analysis & Forecast (NO3/PO4) | `cmems_mod_glo_bgc-nut_anfc_0.25deg_P1D-m` | Daily | ~2 months ago to ~2 weeks in future | `no3`, `po4` | |
56+
| Analysis & Forecast (PH) | `cmems_mod_glo_bgc-car_anfc_0.25deg_P1D-m` | Daily | ~2 months ago to ~2 weeks in future | `ph` | |
57+
| Analysis & Forecast (NPPV) | `cmems_mod_glo_bgc-bio_anfc_0.25deg_P1D-m` | Daily | ~2 months ago to ~2 weeks in future | `nppv` | |
58+
59+
---
60+
61+
```{note}
62+
* "Typical Years Covered" are approximate and subject to change with new Copernicus data releases.
63+
* For the most up-to-date information, always consult the Copernicus Marine product documentation.
64+
* Certain BGC variables (`ph`, `phyc`) are only available as monthly products in hindcast and hindcast interim periods.
65+
```
66+
67+
##### CMEMS variables legend
68+
69+
| Variable Code | Full Variable Name | Category |
70+
| :------------ | :------------------------------------------------------------ | :------------- |
71+
| **uo** | Eastward Sea Water Velocity | Physical |
72+
| **vo** | Northward Sea Water Velocity | Physical |
73+
| **so** | Sea Water Salinity | Physical |
74+
| **thetao** | Sea Water Potential Temperature | Physical |
75+
| **o2** | Mole Concentration of Dissolved Molecular Oxygen in Sea Water | Biogeochemical |
76+
| **chl** | Mass Concentration of Chlorophyll a in Sea Water | Biogeochemical |
77+
| **no3** | Mole Concentration of Nitrate in Sea Water | Biogeochemical |
78+
| **po4** | Mole Concentration of Phosphate in Sea Water | Biogeochemical |
79+
| **nppv** | Net Primary Production of Biomass | Biogeochemical |
80+
| **ph** | Sea Water pH | Biogeochemical |
81+
| **phyc** | Mole Concentration of Phytoplankton | Biogeochemical |

‎docs/user-guide/index.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,4 +6,5 @@
66
quickstart
77
tutorials/index
88
assignments/index
9+
additional_information
910
```

‎docs/user-guide/quickstart.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -80,6 +80,10 @@ For the underway ADCP, there is a choice of using the 38 kHz OceanObserver or th
8080

8181
### Waypoint datetimes
8282

83+
```{note}
84+
VirtualShip supports simulating experiments in the years 1993 through to the present day (and up to two weeks in the future) by leveraging the suite of products available Copernicus Marine Data Store (see [Fetch the data](#fetch-the-data)). The data download is automated based on the time period selected in the schedule. Different periods will rely on different products from the Copernicus Marine catalogue (see [Additional information](https://virtualship.readthedocs.io/en/latest/user-guide/additional_information.html) for more details).
85+
```
86+
8387
You will need to enter dates and times for each of the sampling stations/waypoints selected in the MFP route planning stage. This can be done under _Schedule Editor_ > _Waypoints & Instrument Selection_ in the planning tool.
8488

8589
Each waypoint has its own sub-panel for parameter inputs (click on it to expand the selection options). Here, the time for each waypoint can be inputted. There is also an option to adjust the latitude/longitude coordinates and you can add or remove waypoints.

0 commit comments

Comments
 (0)