Ship Identification

Fuses AIS properties with the ship detection block output geometries.


Analytics platform discontinued after January 31, 2024

The current analytics platform will be discontinued after January 31, 2024, and will be replaced by new advanced processing functionalities. This change will affect projects, workflows, jobs, data blocks, processing blocks, and custom blocks. For more information, see the blog post.

Description

A processing block that annotates ship geometry features detected by the Ship Detection block with ship metadata of the Automatic Identification System (AIS): ship name, cargo, destination port, etc.

See this block on the marketplace.

Compatibility

Catalog collections

Use in combination with Processing from Storage.

How it works

Ship metadata is generated when the block queries the Spire AIS data and fuses the data to the ship geometries using iterative search.

The AIS signal is queried for a time range (max +/- 720 minutes or 12 hours) around the satellite scene acquisition date, with the default range of ±15 minutes centered on the scene acquisition date. E.g., for an acquisition date of 2020-01-20T16:45:56Z the AIS query is performed for 2020-01-20T16:30:56Z to 2020-01-20T17:00:56Z. The output is the ship-identifications GeoJSON file containing the ship geometries with the fused ship metadata, as well as the data.json containing the UP42 query properties.

ParameterOverview
minutesThe delta of time in minutes around the satellite scene acquisition date. The default value is 15. The maximum value is 720.

Example

A workflow with the following blocks:

{
  "up42-processing-from-storage:1": {
    "asset_ids": ["00210895-5405-4c0r-9bca-ccca551776f9"]
  },
  "tiling:1": {
    "nodata": null,
    "tile_width": 768,
    "tile_height": 768,
    "match_extents": false,
    "output_prefix": "",
    "augmentation_factor": 1,
    "discard_empty_tiles": true
  },
  "ship-detection:1": {},
  "ship-identification:1": {
    "minutes": 15
  }
}

Capabilities

Input

Output

To know more please check the block capabilities specifications.