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:
Create a new workflow.
In this example, we add the data block Pléiades Reflectance (Download) and the processing block Pan-sharpening.
Click Save & Configure Job.
Run a Job
The second step is to configure and run a job. To proceed, please follow the steps below:
- You are redirected to the job configuration window. After configuring the JSON parameters, select the job type Live Job and click on Run Job.
- 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:
- You can download either the output of the last block (final output) or the outputs of each block (individual outputs).
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
.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.
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
).Click on the product folder (
DS_PHR*
).
- Another folder displays the order ID of the Pléiades dataset. Click on the folder and examine the contents.
- 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
).
- Click on each folder and examine the contents. To visualize each image, we recommend using the XML files (
DIM*
).
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:
- Open QGIS.
We expect users to be familiar with opening geospatial data. To get started with QGIS, we recommend reading the QGIS documentation.
- Create a new project.
- Drag and drop the previous XML files (
DIM*
).
To proceed with pan-sharpening, please go to How to Pan-sharpen Images.