/

Running your first job

How to configure and run 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.

job step00

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).

job step01

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

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": {}
}  

If the limit is set to 1, the most recent image is returned by default. For a limit value greater than 1, the images are returned by descending chronological order (i.e. from most recent to least recent).

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.

job step02

In this example, the UP42 credits which will be consumed range between 1029 and 1079 (the equivalent of approximately 10 Euro or Dollars). 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.

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:

job step03

  • 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.

job step04

job step05

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

job step06

job step07

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.

A Live Job consumes credits. We recommend first running a Test Query and making sure the job parameters are correctly set.

job step08

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:

job step09

job step10

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.

job step11

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

job step12

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.

job step13

The Jobs window displays the job status and metadata, as well as multiple actions to perform: Rerun Job, Cancel Job, Job Progress, Parameters.

ActionDescription
Rerun JobRepeats a job that is running or has finished.
Cancel JobCancels a job that is running.
Job ProgressDisplays a log of the running job and the status for each steps.
ParametersDisplays the job parameters in JSON format.

In the Job progress, each step name corresponds to a block in the workflow and it is defined as a task. Clicking on each of these names will display the task overview page and the logs for that task.

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.

job step14

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.

job step15 unzipTarball

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.

output step00

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