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-07-01 00:00:00  24.604  ...      USA  GENERIC_DEEP_FLOAT
1   2026-07-01 00:00:00   7.392  ...      USA   GENERIC_BGC_FLOAT
2   2026-07-01 00:00:00   5.272  ...      USA   GENERIC_BGC_FLOAT
3   2026-07-01 00:00:00   1.600  ...      USA   GENERIC_BGC_FLOAT
4   2026-07-01 00:00:00   9.088  ...      USA  GENERIC_CORE_FLOAT
..                  ...     ...  ...      ...                 ...
706 2028-07-14 09:02:22  36.202  ...    ITALY        PROVOR_V - J
707 2028-10-14 08:58:10  39.690  ...    ITALY             ARVOR_D
708 2028-10-14 09:04:07  42.830  ...    ITALY        PROVOR_V - J
709 2030-01-01 00:00:00   0.000  ...    JAPAN              PROVOR
710 2080-12-12 00:00:00  45.000  ...   RUSSIA               FLOAT

[711 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