Import Data (DIMAP)

Description

A data block that enables using DIMAP Pleiades and Spot data, stored in a bucket on Google Cloud Storage (GCS) or Amazon Web Services (AWS), in a workflow on UP42.

Within the bucket, the user can select specific images (via the scene ids) or search by location and time. The search can also be limited to a subfolder in the bucket via the prefix parameter. The block outputs the scene data and an automatically created data.json file with the scene metadata.

See this block on the marketplace.

Supported parameters

For more information, please read the section JSON parameters.

• cloud_provider: The cloud storage provider of the bucket, either gcs or aws.

• bucket_name: The bucket name.

• prefix: A file structure prefix to limit the dataset search to a specific subdirectory. Conforms to the gcs & aws prefix structure, which excludes the bucket name. E.g. folder1/folder2/.

• ids: An array of DIMAP Pleiades or Spot image identifiers. The ids filter overrides all other filters, e.g., intersects, limit and/or time.

• time: A date range to filter scenes on. This range applies to the acquisition date/time of the scenes.

• bbox: The bounding box to use as an AOI. Will return all scenes that intersect with this box. Use only box or intersects.

• intersects: A GeoJSON geometry to use as an AOI. Will return all scenes that intersect with this geometry. Use only intersects or bbox.

• contains: A GeoJSON geometry to use as an AOI. Will return all scenes that completely cover this geometry. Use only contains or intersects or bbox.

• limit: An integer number of maximum results to return. Omit this to set no limit.

• max_cloud_cover: Filters the search result to scenes with lower or equal the cloud coverage % in the scene metadata.

Example queries

Example query with Google Cloud Storage, using ids and prefix:

{
  "dimap-custom:1": {
    "cloud_provider": "gcs",
    "bucket_name": "pleiades-dimap-data",
    "prefix": "europe/france/",
    "ids": ["DS_PHR1A_202005061019188_FR1_PX_E013N52_0513_01183"],
    "intersects": null,
    "time": "2018-01-01T00:00:00+00:00/2020-12-31T23:59:59+00:00",
    "limit": 1,
    "max_cloud_cover": 100
  }
}

Example query with Amazon Web services, searching via time & aoi.

{
  "dimap-custom:1": {
    "cloud_provider": "aws",
    "bucket_name": "spot-dimap-data",
    "prefix": null,
    "ids": null,
    "bbox": [13.351818, 52.501907, 13.379109, 52.510788],
    "time": "2019-01-01T00:00:00+00:00/2020-12-31T23:59:59+00:00",
    "limit": 4,
    "max_cloud_cover": 20
  }
}

Output format

The output GeoJSON contains the Dimap file metadata, with the up42.data_path pointing to the scene folder.

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "bbox": [13.359888888888898, 52.50534722222226, 13.373152777777788, 52.509944444444486],
      "id": "DS_SPOT7_201909220949204_FR1_FR1_SV1_SV1_E013N53_03414",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [13.359889, 52.509944],
            [13.373153, 52.509944],
            [13.373153, 52.505347],
            [13.359889, 52.505347],
            [13.359889, 52.509944]
          ]
        ]
      },
      "properties": {
        "time": "2019-09-22 09:49:20.400000+00:00",
        "cc": 0.0,
        "up42.data_path": "DS_SPOT7_201909220949204_FR1_FR1_SV1_SV1_E013N53_03414/7d59ef45-2944-4d98-af73-642c84dff0bc"
      }
    }
  ]
}

Capabilities

[
  "red",
  "green",
  "blue",
  "nir",
  "pan"
]

{
  "or": [
    "uint16",
    "uint8"
  ]
}

{
  "or": [
    "Pleiades",
    "SPOT"
  ]
}