Once your workflow is created, you may now adjust the parameters to fit your project needs. Simply click on Save & Configure 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.
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).
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.
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.
| Blocks | Examples of job parameters |
|---|---|
| Data | ids |
| Data | time |
| Data | limit |
| Data | zoom_level |
| Data | intersects/contains/bbox |
| Data | max_cloud_cover |
| Data | order_ids |
| Processing | clip_to_aoi |
| Processing | tile_width |
| Processing | tile_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.
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.