---
updatedAt: 2025-11-07T19:28:38.000Z
agentTools:
  projectIndex: https://docs.canopy.umbra.space/llms.txt
---

# Scan Tasking

## Overview

When Tasking in Canopy, you can select Scan as your Imaging Mode, available through both the API and UI, to request and configure Scan Tasks that meet your specific requirements. When your Scan Task is scheduled, it triggers a Dynamic Stripmap Collect, which provides the detailed data required to fulfill your Task. This data is then processed into one or more deliverable Assets.

<ImageCard
  data={[
    {
      img: "https://files.readme.io/f874247964bedba2025b3c0a00692ff1901c34716b1b40e166ac33bf3faf5458-2025-08-20-08-15-33_UMBRA-05_MM.png",
      header: "Waimanalo Beach, Hawaii, United States - 2m, 54x8 km",
			alt:"Waimanalo Beach, Hawaii, United States",
    },
 

  ]}
/>

***

## How Scan Mode Works

A Scan can be oriented in any direction across the Earth’s surface. To define a Scan footprint, you must specify two geographic points spaced from 25 up to 100 km apart. These points determine the coverage of the Scan using an 8 km swath width.

<Image align="center" border={true} width="600px" src="https://files.readme.io/0d50149684c874b88b5eba36febbfde56521e3bcdf4bcd9a151532ecdd275b72-scan-diagram.png" className="border" />

***

## Parameters

Canopy allows users to select from various resolution options. The selected resolution directly affects the maximum possible length of your Scan footprint.

For advanced users, additional parameters - such as Polarization and Grazing Angle - can be configured to further refine your Tasking parameters.

| Resolution (m) | Length (km) | Swath Width (km) | Polarization | Suggested Grazing Angle Range |
| -------------- | ----------- | ---------------- | ------------ | ----------------------------- |
| 2              | 25 - 100    | 8                | VV or HH     | 30° - 60°                     |
| 1              | 25 - 75     | 8                | VV or HH     | 30° - 60°                     |
| 0.5            | 25 - 50     | 8                | VV or HH     | 30° - 60°                     |

***

## Available Product Types

During Task creation, you can specify one or more product types to define the deliverables you want. The following product types are supported (availability depends on your organization’s configuration):

* **SICD:** Standard Imagery Complex Data (NITF format).
* **SIDD:** Sensor Independent Derived Data (NITF format).
* **CPHD:** Compensated Phase History Data (raw radar data).
* **GeoTIFF:** Cloud‑optimized GeoTIFF imagery.

<Callout icon="📘" theme="info">
  For more details on each format, see [Delivered Product Types](https://docs.canopy.umbra.space/docs/delivered-product-types#/).
</Callout>

***

## Configuring Scan Tasks

<Tabs>
  <Tab title="API Users">
    ### API Users

    The Scan tasking workflow follows the same process as the Task Lifecycle Tutorial. The only difference is in the Feasibility request, where you provide a LineString geometry and scanConstraints.

    #### Requesting Feasibility

    Use the Create Feasibility endpoint with `imagingMode: "SCAN"`. Provide:

    * Geometry: a LineString defining your scan path (10–100 km).
    * Constraints: polarization, resolution, grazing angle, etc.
    * Time window: start and end in ISO8601 format.

    ```curl
    curl --request POST \
      --url https://api.canopy.umbra.space/tasking/feasibilities \
      --header 'accept: application/json' \
      --header 'authorization: Bearer ' \
      --header 'content-type: application/json' \
      --data '{
        "imagingMode": "SCAN",
        "scanConstraints": {
          "geometry": {
            "type": "LineString",
            "coordinates": [
              [, ],
              [, ]
            ]
          },
          "polarization": "VV",
          "rangeResolutionMinMeters": 1
        },
        "windowStartAt": "2023-02-02T00:00:00Z",
        "windowEndAt": "2023-02-10T00:00:00Z"
      }'
    ```

    The response includes a Feasibility ID which can be used to create a feasibility request.

    <Callout icon="📘" theme="info">
      For details on next steps, including: reviewing opportunities, creating a task, and retrieving data, please see the [Task Lifecycle Tutorial](https://docs.canopy.umbra.space/docs/task-lifecycle-tutorial#/).
    </Callout>
  </Tab>

  <Tab title="UI Users">
    ### UI Users

    #### Configuring a Scan in the Tasking UI

    * Head to the “Schedule a Task” page
    * Select “Scan” as imaging mode.
    * Select your desired resolution. This will change your allowed scan length based on the specified lengths outline above.
    * You can add your area of interest by using the map to add the first and second point. Click once to start drawing and then again to complete your footprint.
    * As you make your footprint larger or smaller, you’ll see the footprint change color to indicate whether your footprint is the allowed size for the chosen resolution.
    * You can also click edit to move your footprint or change the position of a point.
    * When you are happy with your footprint, click the search button to check the feasibility schedule for available opportunities.

    <Callout icon="📘" theme="info">
      From here, you are able to proceed through the standard tasking workflow as outlined in the [Task Lifecycle Tutorial](https://docs.canopy.umbra.space/docs/task-lifecycle-tutorial#/).
    </Callout>
  </Tab>
</Tabs>

<br />

<br />

<br />

<br />