Tasks and Collects
Canopy enables you to request new data from Umbra's constellation of SAR satellites through its automated tasking system. In addition, the interface provides real-time status updates, keeping you informed about each task through its entire lifecycle. The following describes the core concepts and data models that support the Canopy tasking experience.
Tasks
A Task represents a request for new data to be collected by the Umbra constellation. Tasks are composed of the geolocation to be imaged, the desired timeframe, the image collection mode, and geometric view constraints.
Task Status
When a new Task is submitted, the tasking system automatically advances through the tasking lifecycle and updates the status property accordingly. Additionally, the Task model maintains a historical record of status updates.
The table below describes the Task status definitions.
Unused Statuses
Statuses marked with a
*are not currently in use but are planned to support future commercial tasking features
Terminal Statuses
Statuses marked with a
†are considered terminal and Tasks will not transition away from these statuses without human involvement.
| Status | Description |
|---|---|
| RECEIVED | Task input has been validated. |
| REVIEW * | Feasibility has been verified and cost has been calculated. The task is ready to be reviewed by the customer before submission. |
| SUBMITTED | The Task has been submitted to the Umbra scheduling system. In the future, customers will have the option to manually review Task compliance and billing details before submitting Tasks. |
| ACCEPTED | The task has been accepted by the Umbra's scheduling system. It will be queued for scheduling after additional compliance checks. |
| ACTIVE | Task has been queued for scheduling. |
| REJECTED† | Task was not able to be added to the schedule. Please try re-tasking with different parameters or reach out to [email protected] for assistance. |
| SCHEDULED | Task has been added to the mission schedule and Collects have been generated. |
| TASKED | At least one Collect that fulfills the Task has been commanded to the spacecraft. |
| TRANSMITTED | The spacecraft has been commanded to downlink the associated Collect data for the Task. |
| INCOMPLETE | Some of the Collect data for the Task is downlinked, but not enough for processing. The Task will transition back to TRANSMITTED when Umbra's automation attempts to downlink the remaining data on future passes. |
| DOWNLINKED* | All Collects have been downlinked. |
| PROCESSING | The Collects for the Task have been downlinked. The Collect data for this Task is being processed. |
| PROCESSED | All required Collects have been processed and are ready to be delivered. |
| DELIVERED† | All Collects for the Task have been delivered to the customer. All Task data products are available to download via Canopy. |
| CANCEL_REQUESTED | A request to cancel the Task has been submitted. Customers may no longer cancel Tasks once a Task reaches TASKED. |
| CANCELED† | The requested cancellation has been accepted and the Task has been removed from the schedule. |
| ERROR† | An error occurred within the ground system that prevents the completion of the request. |
| ANOMALY† | An anomaly occurred during collection that prevents the completion of the request. |
| EXPIRED*† | We will not be able to fulfill the request within the timeframe of the Task. |
| COMPLETED† | This status exists for legacy reasons. It will not appear on new Tasks. |
Imaging Modes
Spotlight is currently the only imaging mode supported in Canopy.
Spotlight
Spotlight imaging mode is ideal for obtaining high-resolution imagery over a relatively smaller area by keeping the radar beam fixed on the target for the duration of the collect, thus forming a longer synthetic aperture. Umbra spotlight images provide a guaranteed minimum footprint of 4x4 km.
Cancelling a Task
Customers have the ability to cancel Tasks that are in SUBMITTED, ACCEPTED, ACTIVE, and SCHEDULED status. Once the spacecraft has been tasked with a Collect, the associated Task cannot be canceled. When a cancellation is requested, the Task status is updated to CANCEL_REQUESTED. If the Task is able to be canceled the status will be updated to CANCELED, and the task is removed from the mission schedule.
Collects
Collects are objects that describe the radar parameters and geometry of a single imaging operation. Once a Task has reached a SCHEDULED state, one or more Collects are generated and are available to provide a more detailed view of the Task fulfillment as well as a visualization of the footprint.
Collect Status
Similar to Tasks, Canopy provides real-time visibility into the lifecycle of each Collect throughout the fulfillment of a task.
Unused Statuses
Statuses marked with a
*are not currently in use but are planned to support future commercial tasking features
| Status | Description |
|---|---|
| SCHEDULED | The Collect is on the mission schedule. |
| COMMANDED | The Collect has been commanded to the spacecraft. |
| FAILED | The spacecraft did not perform the commanded collect operation. |
| TRANSMITTED | The spacecraft has been commanded to downlink the raw collect data. |
| PARSED | Umbra automation has received and parsed the first transmission containing the raw collect data. |
| ASSEMBLED | The raw collect data has been parsed and is ready to be staged for processing. If not enough data was parsed for processing, the collect will transition to INCOMPLETE. |
| CORRUPT | The data failed Umbra's automated QA and will not be DELIVERED |
| INCOMPLETE | Some of the raw collect data is downlinked, but not enough for processing. The Collect will transition back to TRANSMITTED when Umbra's automation attempts to downlink the remaining data on future passes. |
| STAGED* | We have downlinked 99% of the the raw collect data and staged it for processing. |
| QUEUED | The collect is in the queue for processing. |
| PROCESSING | The collect is processing. |
| PROCESSING_DELAY* | There was an unexpected delay in processing. |
| STALLED* | The collect processing has stalled due to resource constraints. |
| PROCESSED | The collect has been processed into deliverables. |
| DELIVERED | The collect deliverables have been delivered to the customer. |
| CANCELED | The collect was removed from the schedule. |
| UNKNOWN_COLLECT_STATUS | The collect is in an unknown state. Contact Umbra Support for further assistance. |
Updated 5 months ago