/

Configuration

Run workflows with an area of interest and configurable parameters.


Once your workflow is created, you may now adjust the parameters to fit your project needs. Simply click on Save & Configure Job.

Click on Save & Configure Job to configure your job
Click on Save & Configure Job to configure your job

You will then be redirected to the job configuration window. On this page, you can configure your job by specifying your area of interest (AOI) and by adjusting the appropriate job parameters.

Job Configuration Page
Job Configuration Page

Geometric Filter

A geometric filter provides the user different methods to select an AOI. There are three geometric filter options available: bounding box, contains, and intersects.

The bounding box filter creates a rigid rectangular AOI with an array of 4 coordinates. Using this filter, click anywhere on the map and drag the cursor and release the mouse to create a box. Images that are returned using the bounding box filter are images that either cover the entire AOI or intersect the AOI.

The contains filter creates a polygon where the boundaries are defined by the vertices you click and choose on the map. This filter can be a cost-effective way to specifically define the portions of the image you need and want to purchase. Images returned using the contains filter are images that only cover the entire AOI.

The intersects filter has the same AOI custimization capabilities as contains, however images that are returned using this filter are images that either cover the entire AOI or intersect the AOI.

Once you close the AOI, the coordinates are automatically shown below in the job parameters.

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 (see screenshot below).

Job Configuration Page
Job Configuration Page

Keep an eye out for the AOI size by checking the grey box located at the bottom of the map. The AOI size will appear once a closed AOI has been created. If you are not happy with your AOI, you can delete your AOI here as well.

AOI size
AOI size

Parameters

The job parameters define how data retrieval and/or data analysis should be performed. The job parameters include variables specific to each data and/or processing block. The variables have to be adjusted by the user according to their preferences.

In order to correctly adjust the variables from the job parameters, it is recommended to read the block descriptions from the article Blocks provided by UP42 and the UP42 marketplace.

BlocksExamples of job parameters
Dataids
Datatime
Datalimit
Datazoom_level
Dataintersects/contains/bbox
Datamax_cloud_cover
Dataorder_ids
Processingclip_to_aoi
Processingtile_width
Processingtile_height

For more information, please consult the filters.

The AOI size and job parameters influence the job runtime and overall costs.

Job parameters can be found in the lower-left hand corner of the job configuration page and are provided in JSON format. The parameters shown below are the default parameters provided for a ship detection workflow:

{
  "oneatlas-spot-aoiclipped:1": {
    "ids": null,
    "time": "2018-01-01T00:00:00+00:00/2021-12-31T23:59:59+00:00",
    "limit": 1,
    "zoom_level": 17,
    "time_series": null,
    "max_cloud_cover": 100,
    "panchromatic_band": false,
    "intersects": null
  },
  "tiling:1": {
    "nodata": null,
    "tile_width": 768,
    "tile_height": 768,
    "match_extents": false,
    "output_prefix": "",
    "augmentation_factor": 1,
    "discard_empty_tiles": true
  },
  "ship-detection:1": {}
}

In this example, the following job parameters were used:

{
  "oneatlas-spot-aoiclipped:1": {
    "ids": null,
    "time": "2018-01-01T00:00:00+00:00/2020-12-31T23:59:59+00:00",
    "limit": 1,
    "zoom_level": 17,
    "time_series": null,
    "max_cloud_cover": 10,
    "panchromatic_band": false,
    "intersects": {
      "type": "Polygon",
      "coordinates": [
        [
          [
            -8.721771,
            41.190281
          ],
          [
            -8.685722,
            41.191573
          ],
          [
            -8.684349,
            41.17271
          ],
          [
            -8.720398,
            41.169351
          ],
          [
            -8.721771,
            41.190281
          ]
        ]
      ]
    }
  },
  "tiling:1": {
    "nodata": null,
    "tile_width": 768,
    "tile_height": 768,
    "match_extents": true,
    "output_prefix": "",
    "augmentation_factor": 1,
    "discard_empty_tiles": true
  },
  "ship-detection:1": {}
}

For this particular job, we changed the parameters intersects to specify our AOI and max_cloud_cover to filter out any SPOT imagery that has cloud coverage of more than 10%.

If you are unsure which parameters to adjust for your job, refer back to the block description page of each data and processing block in your workflow. Each block description page lists in detail the supported parameters with useful notes, tips and even warnings to ensure smooth sailing when you configure your job parameters.

Unsure if your job parameters have an extra bracket or missing comma after editing it? We recommend you proof your job parameters prior to running your job by using the tool JSONLint, an online JSON validator.

Price Estimation

Depending on the your AOI size and the job parameters you have used, the price will be adjusted accordingly. A total price estimation for the job can be found under the job parameters in the lower-right hand corner.

step16 jobConfig price zoom

For this job, the credits which will be consumed range between 4103 and 5359 (the equivalent of approximately 50 euro). If your UP42 credit balance is not sufficient, you can reduce the size of the AOI or tweak the job parameters. The price estimation will change in real time.