The harmonize tool radiometrically harmonizes imagery captured by one satellite instrument type to imagery captured by another.

• target_sensor (string): the sensor to which the input product bundles are calibrated. Each sensor value transforms items captured by a defined set of instrument IDs. Items not captured by that set of instrument IDs pass through unaffected.

Target sensor options

Sentinel-2

• PSScene surface reflectance bundles from PlanetScope instrument types (PS2, PS2.SD, and PSB.SD) can be harmonized to Sentinel-2.
• With the Sentinel-2 target sensor, the tool harmonizes PSScene surface reflectance bundle types (analytic_8b_sr_udm2, analytic_sr_udm2) to Sentinel-2 bands (blue, green, red, and near-infrared (NIR)).
• For details, see Scene Level Normalization and Harmonization of Planet Dove Imagery.

Note: Analytic bundles are not supported.

{
  "name": "harmonize_example",
  "products": [
    {
      "item_ids": [
        "20211008_002442_03_2456"
      ],
      "item_type": "PSScene",
      "product_bundle": "analytic_sr_udm2"
    }
  ],
  "tools": [
    {
      "harmonize": {
        "target_sensor": "Sentinel-2"
      }
    }
  ]
}

One imagery output file with harmonized band values is delivered for each product bundle. The transformation of each item depends on the instrument used to capture that item and its relationship to the target sensor. Transformed files have _harmonize appended to their file names.

The harmonize tool passes through UDM, RPC, and XML files, and does not update values in those files.