Deployment Plan

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  ...    country          model
0   2026-09-01 00:00:00 -36.000  ...        USA        SOLO_II
1   2026-09-01 00:00:00   5.000  ...        USA        SOLO_II
2   2026-09-01 00:00:00  -5.000  ...        USA        SOLO_II
3   2026-09-01 00:00:00   1.000  ...        USA        SOLO_II
4   2026-09-01 00:00:00  -1.000  ...        USA        SOLO_II
..                  ...     ...  ...        ...            ...
535 2028-07-14 09:02:22  36.202  ...      ITALY   PROVOR_V - J
536 2028-08-13 09:04:00 -12.312  ...  AUSTRALIA  ARVOR 2 float
537 2028-10-14 08:58:10  39.690  ...      ITALY        ARVOR_D
538 2028-10-14 09:04:07  42.830  ...      ITALY   PROVOR_V - J
539 2080-12-12 00:00:00  45.000  ...     RUSSIA          FLOAT

[540 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()
../../_images/scatter_map_deployment_status.png

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