Download the outputs

How to download the geospatial outputs generated after running jobs.


Introduction

In this guide, you will learn how to download the outputs generated after creating a workflow from scratch and running a job. Currently, UP42 does not support the direct visualization of geospatial outputs and users need to download and save the outputs separately for further rendering in third-party GIS software. The steps below will be based on downloading a Pléiades satellite image and viewing the contents of the product folder.

To get familiar with the Pléiades file format, please refer to The DIMAP Format.

Steps

Create a workflow

The first step is to create a workflow and add the data and processing blocks. To proceed, please follow the steps below:

  1. Create a new workflow.

  2. In this example, we add the data block Pléiades Reflectance (Download) and the processing block Pansharpening.

  3. Click Save & Configure Job.

create workflow pansharpening
Create a workflow

Run a job

The second step is to configure and run a job. To proceed, please follow the steps below:

  1. You are redirected to the job configuration window. After configuring the JSON parameters, select the job type Live Job and click on Run Job.

run job pansharpening
Configure and run a job

  1. You are redirected to the dashboard of your job that is currently running. Wait until the job run is successful.

Download the outputs

After successfully running the job, you can download the outputs, examine the files and visualize them in third-party GIS software. To proceed, please follow the steps below:

  1. You can download either the output of the last block (final output) or the outputs of each block (individual outputs).

download final output
Download the final output

download individual output
Download the individual outputs

  1. In this case, we will download the individual output of the data block Pléiades Reflectance (Download), which is the first line of the results panel. On the left side, the corresponding Docker name is oneatlas-pleiades-fullscene.

  2. The output is downloaded as a TAR archive (TGZ) that needs to be unpacked. To perform this action on Windows OS, please refer to the tutorial How to unpack a tar file in Windows.

output TGZ
TAR archive

output unpack
Unpacked TAR archive

  1. The folder (output) contains 3 files: the product folder, a JSON file with the dataset metadata (data.json) and an additional JSON file (usage.json).

  2. Click on the product folder (DS_PHR*).

output product folder
The product folder

  1. Another folder displays the order ID of the Pléiades dataset. Click on the folder and examine the contents.

output product folder orderId subfolder
The folder with the order ID

  1. A collection of folders and files are displayed. The most important folders are the two folders that contain the low-resolution multiband images (IMG_PHR1B_MS_002) and the higher-resolution panchromatic image of the same scene (IMG_PHR1B_P_001).

output product folder multispectral
The multispectral folder

output product folder panchromatic
The panchromatic folder

  1. Click on each folder and examine the contents. To visualize each image, we recommend using the XML files (DIM*).

output product folder multispectral dim
The multispectral XML file

output product folder panchromatic dim
The panchromatic XML file

Visualize the outputs

Currently, UP42 does not support the visualization of geospatial outputs. To visualize the output, we recommend downloading the free software QGIS and following the steps below:

  1. Open QGIS.

We expect users to be familiar with opening geospatial data. To get started with QGIS, we recommend reading the QGIS documentation.

  1. Create a new project.

qgis new project
Create new project

  1. Drag and drop the previous XML files (DIM*).

qgis multispectral band
Multispectral band

qgis panchromatic band
Panchromatic band

To proceed with pansharpening, please go to Pansharpen images.