Running your first job

Introduction

This guide assumes that you created a workflow and added data and/or processing blocks. For more details, please go to Building your first workflow. The next step is generating the outputs defined by the workflow. To do this, users have to configure and run a job. The expected output is a flood mask near the Victoria Falls.

Configure job

1] Now that the workflow is created, it needs to be run as a job. To continue, click Save & Configure Job.

2] You will be redirected to the job configuration window. In this window, you can draw the Area of Interest (AOI), select the Geometric Filter (bounding box, intersects or contains) and adjust the parameters in JavaScript Object Notation (JSON) format. On the left side, you can adjust various parameters, such as the time or the limit. On the lower left side, the price estimation is displayed (for more information, proceed to Price estimation).

In this example, the following job parameters were used:

{
"oneatlas-pleiades-fullscene:1": {
 "ids": null,
 "time": "2019-03-01T00:00:00+00:00/2020-01-01T23:59:59+00:00",
 "limit": 2,
 "asset_ids": null,
 "time_series": null,
 "max_cloud_cover": 10,
 "contains": {
   "type": "Polygon",
   "coordinates": [
     [
       [
         25.852646,
         -17.923386
       ],
       [
         25.860644,
         -17.923764
       ],
       [
         25.860577,
         -17.929624
       ],
       [
         25.852211,
         -17.929519
       ],
       [
         25.852646,
         -17.923386
       ]
     ]
   ]
 }
},
"pansharpen:1": {
 "bbox": null,
 "method": "SFIM",
 "contains": {
   "type": "Polygon",
   "coordinates": [
     [
       [
         25.852646,
         -17.923386
       ],
       [
         25.860644,
         -17.923764
       ],
       [
         25.860577,
         -17.929624
       ],
       [
         25.852211,
         -17.929519
       ],
       [
         25.852646,
         -17.923386
       ]
     ]
   ]
 },
 "intersects": null,
 "clip_to_aoi": true,
 "include_pan": false
},
"up42-waterfinder-flood:1": {}
}  

Price estimation

3] Depending on the size of the AOI and the parameters you previously adjusted, the total price is estimated in the lower left side of the job configuration window. It is recommended to scroll down, in order to view the total estimated price.

Run job

4] After drawing the AOI and configuring the parameters, you can run the job in two ways:

• run a Test Query to first check image availability and then run a Live Job (also defined as Real Job)
• run a Live Job

4.1] Test Query

If you first run a Test Query, this will only query for available images for your selected parameters and it will not consume credits. Only the quicklooks and metadata of the available images are generated. To access this information, follow the steps below:

• In order to view the quicklooks and examine the cloud cover and image availability, click on Quick Looks. Please note that quicklooks are a low-resolution version of the original images. If you have more quicklooks, you can scroll from left to right and view each quicklook individually.

• In order to view the metadata (e.g. acquisition date, snow cover, sensor type), click on Preview.

4.2] Live Job

If you are satisfied with the quicklooks and metadata, you can run a Live Job by clicking Run as real job. For more information, proceed to step 5.

5] If you wish to skip the Test Query and proceed with directly generating the geospatial outputs, launch a Live Job (also defined as Real Job). This will consume credits and generate the following outputs:

• the Pléiades satellite image(s) from the Pléiades Reflectance (Download) data block
• the pan-sharpened Pléiades image from the Pan-sharpening processing block
• the flood masks from the Flood Finder Pléiades/SPOT processing block

6] After launching the real job, a new window appears and informs the user about the minimum amount of credits that will be held from the beginning of the job run until its completion. This amount of credits will be deducted from the user's account. If you agree, click Confirm & Job Run.

7] A new window informs the user that the job run starts.

8] The job status is displayed in grey as Running. The credit holds are displayed for each block, so that the user knows how the credit consumption is distributed.

Download job results

9] After the job run is finished, the status is displayed in green as Successful. You can now download the outputs in more ways:

9.1] Last Output

If you want to access the output from the last block, click Download.

9.2] Individual Outputs

If you want to access the output from each block, click Results.

10] The outputs will be downloaded by default in the folder Downloads as TAR archives. The TAR archives need to be unzipped. For Windows OS, it is recommended to unpack them with third-party tools. For more information, please read this article: How to unpack a tar file in Windows. Once the TAR archives are unpacked, you will have a collection of results stored in folders named output. After opening the contents of these folders, various files will be displayed. Please note that the outputs are available in either raster or vector file formats.

Visualize job results

11] UP42 does not support the visualization of these geospatial results. It is recommended to download the free GIS software QGIS, where you can display and further analyze the results. For this example, the result is displayed in the screenshot below.

Congratulations, you successfully configured and ran a job of your first workflow!