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 {tilex} and {tiley} in the name_template).

If your workflow does not depend on the tiling coordinate system and you simply need imagery broken into regular chunks, set tile_size to the tile size in pixels and accept the default for all other tile parameters.

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. Default: zero.
• origin_y (float): Tiling system y origin in projected coordinates. Default: zero.
• pixel_size (float): Tiling system pixel size in projected coordinates. Defaults to the pixel_size of the input raster.
• 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. The default is {tilex}_{tiley}.tif, which produces filenames like 128_200.tif. The {tilex} and {tiley} parameters can take the form {tilex: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": "{tilex:07d}_{tiley:07d}.tif"
      }
    }
  ]
}

A set of tiled output files is produced 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.