Deployment Plan#
It may be useful to be able to retrieve meta-data from Argo deployments. argopy can use the OceanOPS API for metadata access to retrieve these information. The returned deployment plan is a list of all Argo floats ever deployed, together with their deployment location, date, WMO, program, country, float model and current status.
To fetch the Argo deployment plan, argopy provides a dedicated utility class: OceanOPSDeployments that can be used like this:
In [1]: from argopy import OceanOPSDeployments
In [2]: deployment = OceanOPSDeployments()
In [3]: df = deployment.to_dataframe()
In [4]: df
Out[4]:
date lat lon ... program country model
0 2025-04-04 13:28:42 22.000 62.000 ... Coriolis FRANCE ARVOR
1 2025-04-05 00:00:00 0.000 80.500 ... Argo PMEL USA NAVIS_EBR
2 2025-04-07 09:33:20 15.000 135.000 ... Argo eq JAMSTEC JAPAN APEX
3 2025-04-08 00:00:00 2.000 80.500 ... Argo PMEL USA NAVIS_EBR
4 2025-04-09 00:00:00 -34.420 -20.000 ... Argo WHOI USA S2A
.. ... ... ... ... ... ... ...
464 2028-05-20 12:00:00 35.000 19.500 ... Argo ITALY ITALY ARVOR
465 2028-06-14 08:56:58 36.710 17.402 ... Argo ITALY ITALY ARVOR_D
466 2028-07-14 09:02:22 36.202 17.700 ... Argo ITALY ITALY PROVOR_V - J
467 2028-10-14 08:58:10 39.690 11.917 ... Argo ITALY ITALY ARVOR_D
468 2028-10-14 09:04:07 42.830 8.180 ... Argo ITALY ITALY PROVOR_V - J
[469 rows x 9 columns]
OceanOPSDeployments can also take an index box definition as argument in order to restrict the deployment plan selection to a specific region or period:
deployment = OceanOPSDeployments([-90, 0, 0, 90])
# deployment = OceanOPSDeployments([-20, 0, 42, 51, '2020-01', '2021-01'])
# deployment = OceanOPSDeployments([-180, 180, -90, 90, '2020-01', None])
Note that if the starting date is not provided, it will be set automatically to the current date.
Last, OceanOPSDeployments comes with a plotting method:
fig, ax = deployment.plot_status()
Note
The list of possible deployment status name/code is given by:
OceanOPSDeployments().status_code
Status |
Id |
Description |
|---|---|---|
PROBABLE |
0 |
Starting status for some platforms, when there is only a few metadata available, like rough deployment location and date. The platform may be deployed |
CONFIRMED |
1 |
Automatically set when a ship is attached to the deployment information. The platform is ready to be deployed, deployment is planned |
REGISTERED |
2 |
Starting status for most of the networks, when deployment planning is not done. The deployment is certain, and a notification has been sent via the OceanOPS system |
OPERATIONAL |
6 |
Automatically set when the platform is emitting a pulse and observations are distributed within a certain time interval |
INACTIVE |
4 |
The platform is not emitting a pulse since a certain time |
CLOSED |
5 |
The platform is not emitting a pulse since a long time, it is considered as dead |