/

Configure job

Configure the job parameters and get the job estimation.


What is a job?

A job is a unique instance of a pre-configured workflow that delivers the outputs defined by the JSON parameters shown in the job configuration window.

A workflow can have one or more jobs. For instance, a user builds a workflow based on the processing block Aircraft Detection, in order to detect planes from high-resolution satellite images. This workflow can be configured and run as a job multiple times. The examples below show the same workflow that has been run as 2 separate jobs: one job for Kuwait and one job for Great Britain.

Aircraft detection in Kuwait
Aircraft detection in Kuwait

Aircraft detection in Great Britain
Aircraft detection in Great Britain

Configure job

This guide assumes that you already created a workflow. For more information: Create a workflow.

Once the workflow is created, click Save & Configure Job. You will be redirected to the job configuration window. On the left side, the job type, geometric filter, JSON parameters and job estimation are shown. On the right side, the basemap is shown.

Save and configure job
Save and configure job

Select job type

Select one of the following job types: Test Query or Live Job. The difference between the 2 job types is shown in the table below.

Job typeDescription
Test querySearches for available data and provides information about the available
images (metadata and quicklooks). A test query (or dry run)
does not download or process data and it does not consume credits.
It is always recommended to run a test query before running a live job.
Live jobRuns the job with the adjusted JSON parameters and consumes credits.
A live job (or real job) generates real outputs (data and/or algorithm
results) delivered in TGZ archive format.

Select geometric filter

A geometric filter represents the spatial relation between the data to be retrieved and the Area of Interest. There are three geometric filter options available: bounding box, contains, and intersects. The difference between the 3 geometric filters is shown in the table below.

Geometric filterDescription
Bounding boxCreates a rectangular AOI with an array of 4 coordinates. The images
returned intersect this bounding box and it is not guaranteed that they
will fully cover this AOI.
ContainsCreates a polygon AOI. The images returned are 100% overlapped on this AOI.
IntersectsCreates a polygon AOI. The images returned are intersecting this AOI and
it is not guaranteed that they will fully cover this AOI.

Job configuration window: Job Type and Geometric Filter
Job configuration window: Job Type and Geometric Filter

Configure JSON parameters

The JSON parameters define how the data retrieval and analysis will be performed during a job run. Before adjusting the JSON parameters, it is recommended to check the requirements of each data block and processing block.

Examples of JSON parametersValues
max_cloud_cover20
mission_codeS1A
limit5
ids["DS_PHR1A_201006181052297_FR1_PX_E001N43_0612_06488"]
Tip 1

To validate the JSON parameters and make sure the brackets are correct, we recommend using the external tool JSONLint.

Job configuration window: JSON parameters
Job configuration window: JSON parameters

Example JSON parameters:

Loading...

Draw or upload an area of interest

On the basemap, you can draw or upload an AOI. To draw an AOI, click anywhere on the basemap, then start creating a polygon by selecting the geometric filter. The table below shows the accepted file formats for uploading the AOI.

Accepted vector file formats for uploading an AOI
JSON
GeoJSON
KML
WKT

Job configuration window: draw or upload AOI
Job configuration window: draw or upload AOI

Multi-polygons or polygons with self-intersecting vertices will generate a job failure.

Tip 2

The coordinates of the AOI can also be copied and pasted from other sources as a GeoJSON geometry. We recommend using the online GIS tool GeoJSON.io.

Tip 3

The AOI size is displayed on the bottom of the basemap, after closing the polygon with the last vertex. You can change the AOI by deleting the current one.

Job estimation

Before running the job, users can view the job estimation, which includes the total processing time and price. Please note that the AOI size and the adjusted JSON parameters directly influence the processing time and credit costs.

Tip 4

To reduce the credit costs, you can reduce the AOI size.

Tip 5

If the job estimation is displayed, then the JSON parameters are correctly configured.

Job configuration window: job estimation
Job configuration window: job estimation

After you configured the JSON parameters and viewed the job estimation, you can run the job. To proceed, go to Run job.