Jobs

Generate geospatial outputs from your workflows.


Overview

A job is an instance of a workflow. It delivers geospatial outputs defined by job parameters.

A workflow can have several jobs. It can be configured differently for different results and run multiple times — for example, for different AOIs.

Jobs dashboard

Configure and run a job

After you've created a workflow, click Update & Configure Job or Save & Configure Job.

Follow these steps to configure and run a job:

  1. Select a job type.
  2. Configure an AOI.
  3. Adjust JSON parameters.
  4. Check price and run a job.

Select a job type

Select a Test Query or a Live Job. If possible, run a job as a test query first. After it is successful, rerun it as a live job.

Job typeDescriptionOutputCredit consumption
Test querySearches for available data based on your parameters.Provides JSON metadata and low resolution quicklooks of available images.0 credits
Live jobDelivers downloaded and processed data in the Tar GZip format.Runs the job with the adjusted parameters.As stated in the job estimation.

Configure an AOI

If you use storage data as a data source, skip this step.

  1. Select a geometric filter.

    • Intersects

      Returns images that intersect with a defined polygon and may not fully cover it. Returned scenes may have different acquisition times. Use to maximize the number of returned images — for example, with big AOIs that can't be captured in one full scene.

    • Bounding box

      Returns images that intersect with a defined rectangle and may not fully cover it. Returned scenes may have different acquisition times. Use it if your AOI is a rectangle and you want to maximize the number of returned images — for example, with big AOIs that can't be captured in one full scene.

    • Contains

      Returns images that entirely overlap a defined polygon. Use to ensure one acquisition time for the entire AOI.

  2. Create an AOI. The minimum AOI size is 0.1 km2.

Adjust JSON parameters

Define how data retrieval and analysis will be performed during a job run.

For more information on parameters for chosen blocks, see the following articles:

Check price and run a job

Jobs with Processing from Storage won't have price estimation.

  1. Check job estimation for total processing time and price. To reduce them, make the AOI smaller or change some of the adjusted JSON parameters.
  2. Click Run job for a test query or Confirm & Job Run for a live job.

For more information on credit consumption, see Pricing.

Download job outputs

A successful job run generates the geospatial outputs defined in the job parameters.

  1. Go to Projects icon Projects and select a project.

  2. Go to Jobs. Find and select a completed job.

    • Live jobs are shown in the upper part of the dashboard.
    • Test query jobs are shown in the lower part of the dashboard.
  3. Download the outputs in one of the following ways:

    • To download the final output (the output of the last job task), click Download in the Summary pane.
    • To download an individual output of a job task, click Results in the line of the chosen task.
  4. The output is downloaded as a Tar GZip archive. Learn how to unpack it in Windows.

After that you can visualize your geospatial outputs.

Find a job ID

  1. Go to Projects icon Projects and select a project.
  2. Go to Jobs and select a job.
  3. Copy the ID under the job's name. Job ID example: 6d7c1025-2915-40e9-88a1-264763b22a7e

Video tutorials


How to configure and estimate a job

How to run a job and download outputs

Troubleshooting

I have a problem with a job. How can I ask for help?

Contact support and include the job ID to speed up the process.

How can I view the images?

UP42 doesn't support direct visualization of geospatial outputs, and you'll need to use QGIS for that. For more information, see Visualize geospatial data.

Is there a way to get notified when my job is completed?

Use webhooks to get notifications when a job changes its status.

You can set it up in one of the following ways: