kinesIS 3D Decomposition service tutorial
Find kinesIS 3Decomp service description and specifications here.
Select the processing service
After the opening of the Geohazards workspace of the CopernicusLAC Platform open the Processing Services panel by clicking on the button located on the top right of the map.
The Processing panel will be displayed with the list of on-demand services available for this workspace.
Find the kinesIS 3D Decomposition service from the list and click on the button next to it.
This tab provides a quick description of the service. In the upper part of the tab are shown:
-
service full name,
-
service caption,
-
hyperlink to the online documentation,
-
version of the service.
Below that are listed all mandatory and optional parameters that the user must define when submitting the on-demand processing. Each parameter is described with:
-
a grey circle on the left indicating the format of input value required for the parameter. As an example if the parameter is a string (e.g. catalog reference) or a number (e.g. a threshold),
-
the identifier of the parameter,
-
a brief description of the parameter.
At the bottom of the tab is located the GO TO SERVICE FORM button. Click on it to move to the next tab where the user can fill-in all service parameters and submit the on-demand job.
Hint
To go back to the service panel click on the BACK TO ALL SERVICES button.
Fill the parameters
To start the kinesIS 3D Decomposition service, you need to define input parameters. Access the kinesIS 3D Decomposition service form and then fill-in the parameters as described in the following sections.
Hint
In case you can’t find anymore the kinesIS 3D Decomposition service form:
- open the Processing panel by clicking on the button on the top right of the map,
- find the kinesIS 3Decomp service from the list of services,
- click on the button next to it,
- and then click on the GO TO SERVICE FORM button.
Job Title
First of all, you can assign a name to the on-demand job you are launching. A predefined title is generated by the platform. Modify this title and assign the title you prefer. For instance, insert as Job title:
kinesIS_3D_decomposition_panama_s1_202401_202412
Note
If you don’t specify a name, the system automatically assigns one using the service name and the date and time of job creation.
Ascending LoS input
In this parameter you shall insert the path to the kinesIS ascending measurements corresponding to the ascending Sentinel-1 satellite track.
Descending LoS input
In this parameter you shall insert the path to the kinesIS descending measurements corresponding to the descending Sentinel-1 satellite track.
To insert the paths of previously generated kinesIS results, you first need to detach the kinesIS 3Decomp processing panel by clicking the button on the right side of the panel.
Now you have two panels, one for the kinesIS 3Decomp processing service form and another where you can navigate to previously submitted and successfully completed kinesIS processing jobs.
You need to locate the required job from the list (e.g. the ascending kinesIS job) and access it by clicking the button next to it.
Then you need to click on the button SHOW RESULTS ON MAP located in the JOBS tab of the specific panel.
Now, under the JOB RESULTS tab in the left panel, the job results appear. You need to drag and drop the into the service form field so that the path of the ascending kinesIS job is automatically populated.
You need to repeat the same procedure for the descending kinesIS job to populate the second required path.
Hint
To ensure robust decomposition, both ascending and descending jobs should correspond to the same observation period and be processed using the same reference area during the execution of the kinesIS service.
Output pixel size
In this parameter you shall insert desired pixel size (in meters) of the output raster files. The default value is 20 meters.
Run the job
After filling in all the required parameters, click SUBMIT JOB to start the service.
Once submitted, you will be automatically redirected to the JOBS tab, where you can view the list of all previously submitted jobs. Your newly created job will appear at the top of the list.
From this tab, you can monitor the progress of your job, which can have one of the following statuses: running, succeeded or failed.
Note
Typically, the service execution is ranging approximately between half and one hour depending on the size /spatial coverage of the input LoS measurements.
Results
Once the job is successfully accomplished, under the job details click on the button SHOW RESULTS ON MAP located in the JOBS tab of the left panel.
After that all the products generated by the service will be displayed on the map.
From the JOBS tab of the right panel, you can consult the input parameters employed in this job by clicking on the Input dropdown list button. Consult the Metadata available, regarding the input Sentinel-1 products employed by the service, the utilized DEM, extend of bounding box, etc.
From the DETAILS tab in the left panel it is also possible to:
-
set the opacity of the layer,
-
visualize the legend of the product,
-
under view options consult the render applied to the layer and, its histogram (when available), and apply a custom render,
-
download the product.
Hint
Do you want to see both the result and the underneath satellite imagery baselayer? Try using the Layers opacity (global) bar and set the opacity as 50% to better see for instance also the basemap layer.
Note
Aren’t you satisfied with the default render of the product available under Layers in the View options? You can customize it by clicking on Customize under View options in the left panel.
To download the product from the left panel click on the Downloads dropdown button and then on the hyperlink of the single asset.
