Example payload for using the tile tool

The tile tool splits an item or multi-item composite into a regular set of tiles based on a specified tiling system.

The tiling system maps the projected coordinate system coordinates to tiles referenced by an x and y integer offset from the origin (see {tile_x} and {tile_y} in the name_template).

The source_type for this tool is scenes. The tile tool supports all item types and all bundle types except those with non-orthorectified images (basic_* bundles) and NITF images (*_nitf bundles).

  • origin_x (float): Tiling system x origin in projected coordinates. Required.
  • origin_y (float): Tiling system y origin in projected coordinates. Required.
  • pixel_size (float): Tiling system pixel size in projected coordinates. Required.
  • tile_size (integer): Height and width of output tiles in pixels and lines (always square). Required.
  • name_template (string): A naming template for output tile filenames. Required. The {tile_x} and {tile_y} placeholders can take the form {tile_x:06d} to produce a fixed-width field with leading zeros.
  • conformal_x_scaling (boolean): If the coordinate system is conformal (such as WGS84), scaling output tiles in the x direction can minimize shape distortion as the poles are approached. Enabling this option reduces the width of tiles below tile_size as the distance from the equator increases.
{
  "name": "web_mercator_zoom_15_tile_example",
  "products": [
    {
      "item_ids": [
        "20200710_172116_0e19"
      ],
      "item_type": "PSScene",
      "product_bundle": "analytic_udm2"
    }
  ],
  "tools": [
    {
      "tile": {
        "origin_x": -20037508.340,
        "origin_y": -20037508.340,
        "pixel_size": 3,
        "tile_size": 256,
        "name_template": "{tile_x:07d}_{tile_y:07d}.tif"
      }
    }
  ]
}

The tool produces a set of tiled output files for each bundle (or for a composite, if paired with composite). UDM files are also tiled. Each tiled file has a filename defined by the name_template parameter above.

The tool passes through XML files unchanged.

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.