Jobs

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.

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.

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 km².

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:

• JSON parameters
• Data blocks
• Processing blocks

Check price and run a job

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

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:

• In the console
• By using the API