Skip to content

IRIS tutorial


image

This service performs a Change Detection using a pair of calibrated optical single band assets from the same or different EO missions, or a pair of SAR single band assets acquired from the same sensor. The output consists of multiple change detection products derived from the Structural Similarity Index that show intensity, extent, and contours of the detected changes in the region of interest.

đź“• IRIS service description and specifications are available in this section.


Select the processing service

After the opening of the activation workspace, in the right panel of the interface, open the Processing Services tab.

Image-001

Select the processing service Change Detection Analysis (IRIS).

Image-002

The "Change Detection Analysis (IRIS)" panel is displayed with parameters values to be filled-in.

Image-003


Use case 1: change detection analysis using a pair of reflectance single band assets

Abstract

This first use case explains how to make change detection analysis with IRIS using a pair of NIR BOA reflectance single band assets from Optical Calibrated Datasets acquired by the same sensor before and after a wildfire event.

Find the data using multiple filter criteria

Select the area for which you want to do an analysis, e.g over South-eastern France. From the Navigation and Search toolbar (located in the upper left side of the map), click on the Spatial Filter and draw a square AOI over the Riviera resort of Saint Tropez in the Var Department, France. This spatial filter allows you to select only the EO data acquired over this area.

Now it is possible to choose a pair of pre- and post-event reflectance images from Optical Calibrated Datasets to be used for the change detection analysis. This pair must come from the same sensor.

From the top of the left panel, use Filter Criteria to search for Optical and sentinel-2 data collections from the list.

In this example the selected pair of calibrated datasets are:

  • Pre-event calibrated dataset: [CD] SENTINEL-2B MSI L2A 108 2021/08/02 10:25:59

  • Post-event calibrated dataset: [CD] SENTINEL-2A MSI L2A 108 2021/08/27 10:30:21


Fill the parameters

After the definition of spatial and time filters, you can employ IRIS, by using a suitable pair of Calibrated Datasets from Sentinel-2 data.

To do so you can fill the parameters as described in the following sections.

Job name

  • Insert as job name:
IRIS Sentinel-2 02/08 - 27/08 2021 Wildfire Var France 

Input pair of single-band geophysical assets

First two mandatory parameters are input "Reference" and "Secondary" single band assets from Optical/Radar Calibrated Datasets, or Results from on-demand processing. This parameter is required to specify both the reference to the Calibrated Dataset and the single band asset (e.g. nir) to be used for the change detection analysis.

Hint

To consults the bands of a Calibrated Dataset just Click on Show assets button available near the feature title. After the click a list with all single-band assets (CBNs) included within the Calibrated Dataset will appear under the feature title.

Image-note-001

Thus, drag and Drop the selected assets:

  1. single band reflectance asset from a pre-event Calibrated Dataset for CBN = nir

  2. single band reflectance asset from a post-event Calibrated Dataset for CBN = nir

in the Pre-event single band asset and Post-event single band asset fields respectively.

Image-005

Warning

Users must drag and drop the single-band asset (e.g. red) into both Optical calibrated pre-event single band asset and Optical calibrated post-event single band asset fields. The drag and drop of the Calibrated Dataset (e.g. [CD] SENTINEL-2A MSI L2A 46 2021/12/11 02:31:11) is not enough.

Optional mask

If needed a single band asset representing a binary mask can be employed here to mask out IRIS results (e.g. a cloud mask to make IRIS change detection only over cloud free pixels). In this use case this parameter is not employed. Before using this parameter see this section of the IRIS service specifications

Window size

Insert as a value for the window size the value of 39.

Note

This value defines the size of the sliding window in pixels, this parameter can highly influence the result of the analysis. The higher this parameter is set, the more averaged the change map will be, while the smaller and the more detailed changes can be identified at the cost of potentially noisier results. This is due to the SSIM value for each pixel being computed using the information present in the whole sliding window, thus obtaining a more localized value of the index in case of a smaller window.

Warning

The dimension of the window should be set in a range between 9 and 71. Inserted value must be odd. If the inserted value is even or is outside this range, a warning will be given to the user.

Threshold

Insert as a threshold the value of 0.4. This value will be used by the processor in the binarization of SSI to estimate the binary change mask and generate the contours overview.

Co-registration method

In this mandatory parameter the user shall choose the co-registration method to employ. Under Co-registration type a list of selectable options are available. Find specifications of each option here.

Insert, for example, the value Rigid to employ a rigid co-registration of secondary and reference input assets. The full-field displacement measured is used to estimate an Affine transformation matrix which is then applied to the secondary image.

Area of interest expressed as Well-known text (optional)

The “Area of interest as Well Known Text” can be defined by using the drawn polygon defined with the area filter.

Image-006

Tip

In the definition of “Area of interest as Well Known Text” it is possible to apply as AOI the drawn polygon defined with the area filter. To do so, click on the button in the left side of the "Area of interest expressed as Well-known text" box and select the option AOI from the list. The platform will automatically fill the parameter value with the rectangular bounding box taken the from current search area in WKT format.

Note

This parameter is optional.


Run the job

Click on the button Run Job and see the Running Job

Image-007

You can monitor job progress through the progress bar.

Image-008


Results: download and visualization

Once the job is completed, click on the Show results button located at the bottom of the processing service panel.

Image-009

Tip

You can also save the parameters employed in this job by clicking on the Export params button in the right panel. This allows you to copy all your entries to the clipboard. This is meant to be used for a quick re-submission of a similar job after a fine tuning of the parameters (e.g. to add a color formula later).

Below is reported the syntax which includes all the parameters employed in this example.

{
   "pre_event": "https://catalog.disasterscharter.org//charter/cat/[chartercalibrateddataset,!excluded,{callid932}]/search?format=json&uid=call932_S2B_MSIL2A_20210802T102559_N0301_R108_T31TGJ_20210802T133728-calibrated#nir",
   "post_event": "https://catalog.disasterscharter.org//charter/cat/[chartercalibrateddataset,!excluded,{callid932}]/search?format=json&uid=call932_S2A_MSIL2A_20210827T103021_N0301_R108_T31TGJ_20210827T151224-calibrated#nir",
   "win_size": "39",
   "threshold": "0.4",
   "coreg_type": "Rigid",   
   "aoi": "POLYGON((6.31 43.232,6.31 43.44,6.633 43.44,6.633 43.232,6.31 43.232))"
}

Visualization

See the result on the map. The preview appears within the area defined in the spatial filter.

Image-010

To get more information about the product just click on the preview in the map, a bubble showing the name of the layer IRIS Change detection for S2B_MSIL2A_20210802T102559_N0301_R108_T31TGJ_20210802T133728-calibrated and S2A_MSIL2A_20210827T103021_N0301_R108_T31TGJ_20210827T151224-calibrated will appear and then click on the Show details button.

Tip

To quickly access Product Details double click on the layer from the Results list.

In the left panel of the interface, the details of Job Result will appear with Product metadata. Furthermore by clicking on Layer styling you can also access to the View options.

Image-011

In here it is possible to see histogram/s of the Product which is visible in the map, set color formula, change Filters (e.g. Brightness, Opacity).

Tip

To visually compare the SSI overview product with the underlying base layer (e.g. Natural Earth or Dark map) you can set the Opacity filter under View options as 40%.

Image-012

In the left panel under the result Details is possible to switch from the default asset to another one included into the IRIS results by clicking on Layer Styling and Select Assets. To visualize another asset on the map just select another asset:

ssi asset

Image-013

iris-change-mask asset

Image-014

contours asset

Image-015

In the left panel under the result Details is possible to create customized overview on the fly by clicking on Layer Styling and Combine Assets. As an example under Combine Assets you can create on the fly a Red-Cyan band composite by setting the nir_pre single-band asset in the RED channel, and the co-registered nir_post one in the GREEN and BLUE channels.

Image-016

This Red-Cyan band composite highlights vegetation changes derived from Sentinel-2 data. In red is shown the loss of vegetation due to wildfires.


Download

In this first use case the Change Detection Analysis (IRIS) service offers the following products:

  • nir_pre: single band asset product from pre-event nir reflectance given as single band raster in COG format,
  • nir_post: single band asset product from post-event nir reflectance given as single band raster in COG format,
  • ssi: single band asset for the SSI index given as single band raster in COG format,
  • ssi-no-water: single band asset for the SSI index, after the masking of permanent waters, given as single band raster in COG format,
  • overview-iris: default overview (RGBA) derived from the ssi asset given as 4-band raster in COG format,
  • overview-iris-no-water: overview (RGBA) derived from the ssi asset, after the masking of permanent waters, given as 4-band raster in COG format,
  • iris-change-mask: single band asset from thresholding of the SSI index given as UInt8 single band raster in COG format,
  • iris-change-mask-no-water: single band asset from thresholding of the SSI index, after the masking of permanent waters, given as UInt8 single band raster in COG format,
  • contours: overview (RGBA) showing the pre-event single band asset in gray scale and superimposed detected change contours in yellow given as 4-band raster in COG format,
  • contours-no-water: overview (RGBA) showing the pre-event single band asset in gray scale and superimposed detected change contours in yellow, after the masking of permanent waters, given as 4-band raster in COG format.

These products can be downloaded by clicking on the Download button located at the bottom of the Product Details tab in the left panel.

Image-017


Use case 2: change detection analysis using a pair of backscatter single band assets from the same mission

Abstract

This second use case explains how to make change detection analysis with IRIS using a pair of co-pol Sigma Nought single band assets from Radar Calibrated Datasets acquired by the same sensor before and after a flood event.

Find the data using multiple filter criteria

Select the area for which you want to do an analysis, e.g over Makurdi, Nigeria. From the Navigation and Search toolbar (located in the upper left side of the map), click on the Spatial Filter and draw a square AOI over Makurdi area along the Benue river, Nigeria. This spatial filter allows you to select only the EO data acquired over this area.

Now it is possible to choose a pair of pre- and post-event reflectance images from Radar Calibrated Datasets to be used for the change detection analysis. This pair must come from the same sensor.

From the top of the left panel, use Filter Criteria to search for Radar and sentinel-1 data collections from the list.

In this example the selected pair of calibrated datasets are:

  • Pre-event calibrated dataset: [CD] SENTINEL-1A GRD IW VV/VH 132 2022-08-21 17:37:53

  • Post-event calibrated dataset: [CD] SENTINEL-1A GRD IW VV/VH 132 2022-09-26 17:37:54

Image-018


Fill the parameters

After the definition of spatial and time filters, you can employ IRIS, by using a suitable pair of Calibrated Datasets from Sentinel-1 data.

To do so you can fill the parameters as described in the following sections.

Job name

  • Insert as job name:
IRIS Sentinel-1 21/08 - 26/09 2022 Flood Makurdi Nigeria 

Input pair of single-band geophysical assets

First two mandatory parameters are input "Reference" and "Secondary" single band assets from Optical or Radar Calibrated Datasets, or Results from on-demand processing. This parameter is required to specify both the reference to the Calibrated Dataset and the single band asset (e.g. s0_db_c_vv) to be used for the change detection analysis.

Hint

To consults the bands of a Calibrated Dataset just Click on Show assets button available near the feature title. After the click a list with all single-band assets (CBNs) included within the Calibrated Dataset will appear under the feature title.

Image-note-002

Thus, drag and Drop the selected assets:

  1. single band backscatter asset from a pre-event Calibrated Dataset for CBN = s0_db_c_vv

  2. single band backscatter asset from a post-event Calibrated Dataset for CBN = s0_db_c_vv

in the Pre-event single band asset and Post-event single band asset fields respectively.

Image-019

Warning

Users must drag and drop the single-band asset (e.g. s0_db_c_vv) into both Pre-event calibrated single band asset and Post-event calibrated single band asset fields. The drag and drop of the Calibrated Dataset (e.g. [CD] SENTINEL-1A GRD IW VV/VH 132 2022-08-21 17:37:53) is not enough.

Window size

Insert as a value for the window size the value of 41.

Threshold

Insert as a threshold the value of 0.9. This value will be used by the processor in the binarization of SSI to estimate the binary change mask and generate the contours overview.

Co-registration method

In this mandatory parameter the user shall choose the co-registration method to employ. Under Co-registration type a list of selectable options are available. Find specifications of each option here. Insert, for example, the default value Rigid to employ a rigid co-registration of secondary and reference input assets. The full-field displacement measured is used to estimate an Affine transformation matrix which is then applied to the secondary image.


Run the job

Click on the button Run Job and see the Running Job. You can monitor job progress through the progress bar.

Image-020


Results: download and visualization

Once the job is completed, click on the Show results button located at the bottom of the processing service panel.

Image-021

Tip

You can also save the parameters employed in this job by clicking on the Export params button in the right panel. This allows you to copy all your entries to the clipboard. This is meant to be used for a quick re-submission of a similar job after a fine tuning of the parameters (e.g. to add a color formula later).

Below is reported the syntax which includes all the parameters employed in this example.

{
   "pre_event": "https://catalog.disasterscharter.org//charter/cat/[chartercalibrateddataset,{callid895}]/search?format=json&uid=call895_S1A_IW_GRDH_1SDV_20220821T173753_20220821T173818_044654_0554AF_7A67-calibrated#s0_db_c_vv",
   "post_event": "https://catalog.disasterscharter.org//charter/cat/[chartercalibrateddataset,{callid895}]/search?format=json&uid=call895_S1A_IW_GRDH_1SDV_20220926T173754_20220926T173819_045179_05665D_A9D3-calibrated#s0_db_c_vv",
   "win_size": "41",
   "threshold": "0.9",
   "coreg_type": "Rigid"
}

Visualization

See the result on the map. The preview appears within the area defined in the spatial filter.

Image-022

To get more information about the product just click on the preview in the map, a bubble showing the name of the layer IRIS Change detection for S1A_IW_GRDH_1SDV_20220821T173753_20220821T173818_044654_0554AF_7A67-calibrated and S1A_IW_GRDH_1SDV_20220926T173754_20220926T173819_045179_05665D_A9D3-calibrated will appear and then click on the Show details button.

Tip

To quickly access Product Details double click on the layer from the Results list.

In the left panel of the interface, the details of Job Result will appear with Product metadata. Furthermore by clicking on Layer styling you can also access to the View options.

In here it is possible to see histogram/s of the Product which is visible in the map, set color formula, change Filters (e.g. Brightness, Opacity).

overview-iris asset

Image-023

In the left panel under the result Details is possible to switch from the default asset to another one included into the IRIS results by clicking on Layer Styling and Select Assets. To visualize another asset on the map just select another asset:

ssi asset

Image-024

iris-change-mask asset

Image-025

contours asset

Image-026

In the left panel under the result Details is possible to create customized overview on the fly by clicking on Layer Styling and Combine Assets. As an example under Combine Assets you can create on the fly a Red-Cyan band composite by setting the s0_db_c_vv_pre single-band asset in the RED channel, and the co-registered s0_db_c_vv_post one in the GREEN and BLUE channels.

Image-027

This Red-Cyan band composite highlights backscatter changes derived from Sentinel-1 data. In red are highlighted flood areas.

To better visualize the iris-change-mask asset in the map, under Layer Styling and Select Assets set the Color map as Blue-Red No Data value equal to 0 and set Brightness to 300%.

Image-028


Download

In this second use case the Change Detection Analysis (IRIS) service offers the following products:

  • s0_db_c_vv_pre: single band asset product from pre-event C-band Sigma Nought (dB) in VV polarization given as single band raster in COG format,
  • s0_db_c_vv_post: single band asset product from post-event C-band Sigma Nought (dB) in VV polarization given as single band raster in COG format,
  • ssi: single band asset for the SSI index given as single band raster in COG format,
  • ssi-no-water: single band asset for the SSI index, after the masking of permanent waters, given as single band raster in COG format,
  • overview-iris: default overview (RGBA) derived from the ssi asset given as 4-band raster in COG format,
  • overview-iris-no-water: overview (RGBA) derived from the ssi asset, after the masking of permanent waters, given as 4-band raster in COG format,
  • iris-change-mask: single band asset from thresholding of the SSI index given as UInt8 single band raster in COG format,
  • iris-change-mask-no-water: single band asset from thresholding of the SSI index, after the masking of permanent waters, given as UInt8 single band raster in COG format,
  • contours: overview (RGBA) showing the pre-event single band asset in gray scale and superimposed detected change contours in yellow given as 4-band raster in COG format,
  • contours-no-water: overview (RGBA) showing the pre-event single band asset in gray scale and superimposed detected change contours in yellow, after the masking of permanent waters, given as 4-band raster in COG format.

These products can be downloaded by clicking on the Download button located at the bottom of the Product Details tab in the left panel.

Image-029


Use case 3: change detection analysis using a multi-sensor pair of reflectance single band assets

Abstract

This second use case explains how to make change detection analysis with IRIS using a pair of reflectance single band assets from Optical Calibrated Datasets acquired by different sensors before and after a flood event.

Find the data using multiple filter criteria

Select the area for which you want to do an analysis (e.g. post-earthquake damage assessment), e.g over Gaziantep Province in southeastern Turkey. From the Navigation and Search toolbar (located in the upper left side of the map), click on the Spatial Filter and draw a square AOI over the Islahiye town, Gaziantep Province in southeastern Turkey. This spatial filter allows you to select only the EO data acquired over this area.

Now it is possible to choose a pair of pre- and post-event reflectance images from Optical Calibrated Datasets to be used for the change detection analysis. This pair must come from the same sensor.

From the top of the left panel, use Filter Criteria to search for Optical data collections from the list. Employ as satellite filter worldview-2 and worldview-3. Set as a temporal filter the time range from 01/12/2022 to 07/02/2023.

After the query the list will be updated as the one shown in the next image.

Image-030

In this example the selected pair of calibrated datasets are:

  • Reference calibrated dataset (before earthquake): [CD] WORLDVIEW-2 MSI LV1B 2022-12-27 08:40:06

  • Secondary calibrated dataset (after the event): [CD] WORLDVIEW-3 MSI LV1B 2023-02-07 08:27:05


Fill the parameters

After the definition of spatial and time filters, you can employ IRIS, by using a suitable pair of single band assets (e.g. red assets) from WorldView-2 and 3 Calibrated Datasets. To do so you can fill the parameters as described in the following sections.

Job name

  • Insert as job name:
IRIS - Red - WV2 27/12/2022 WV3 07/02/2023 Earthquake in Turkey

Input pair of single-band geophysical assets

First two mandatory parameters are input "Reference" and "Secondary" single band assets from Calibrated Datasets or Results of on-demand processing. This parameter is required to specify both the reference to the Calibrated Dataset and the single band asset (e.g. red) to be used for the image co-registration.

Hint

To consults the bands of a Calibrated Dataset just Click on Show assets button available near the feature title. After the click a list with all single-band assets (CBNs) included within the Calibrated Dataset will appear under the feature title.

Image-note-001

Thus, drag and Drop the selected assets:

  1. single band reflectance asset from reference Calibrated Dataset for CBN = red

  2. single band reflectance asset from secondary Calibrated Dataset for CBN = red

in the Pre-event single band asset and Post-event single band asset fields respectively.

Area of interest expressed as Well-known text (optional)

The “Area of interest as Well Known Text” can be defined by using the drawn polygon defined with the area filter.

Window size

Insert as a value for the window size the value of 41.

Threshold

Insert as a threshold the value of 0.4. This value will be used by the processor in the binarization of SSI to estimate the binary change mask and generate the contours overview.

Co-registration method

In this mandatory parameter the user shall choose the co-registration method to employ. Under Co-registration type a list of selectable options are available. Find specifications of each option here. Insert, for example, the default value Rigid to employ a rigid co-registration of secondary and reference input assets. The full-field displacement measured is used to estimate an Affine transformation matrix which is then applied to the secondary image.

Image-031


Run the job

Click on the button Run Job and see the Running Job. You can monitor job progress through the progress bar.


Results: download and visualization

Once the job is completed, click on the Show results button located at the bottom of the processing service panel. Below is reported the syntax which includes all the parameters employed in this example.

{
   "pre_event": "https://catalog.disasterscharter.org//charter/cat/[chartercalibrateddataset,!excluded,{callid932}]/search?format=json&uid=call919_WV02N37_000277E036_6277772022122700000000MS00-calibrated#red",
   "post_event": "https://catalog.disasterscharter.org//charter/cat/[chartercalibrateddataset,!excluded,{callid932}]/search?format=json&uid=call919_WV03N37_066527E036_6394442023020700000000MS00-calibrated#red",
   "win_size": "9",
   "threshold": "0.4",
   "coreg_type": "Rigid",
   "aoi": "POLYGON((36.625 37.017,36.625 37.03,36.647 37.03,36.647 37.017,36.625 37.017))"
}

Visualization

See the result on the map. The preview appears within the area defined in the spatial filter.

To get more information about the product just click on the preview in the map, a bubble showing the name of the layer IRIS Change detection for WV02N37_000277E036_6277772022122700000000MS00-calibrated and WV03N37_066527E036_6394442023020700000000MS00-calibrated will appear and then click on the Show details button.

In the left panel of the interface, the details of Job Result will appear with Product metadata. Furthermore by clicking on Layer styling you can also access to the View options.

In here it is possible to see histogram/s of the Product which is visible in the map, set color formula, change Filters (e.g. Brightness, Opacity).

overview-iris asset

Image-032

In the left panel under the result Details is possible to switch from the default asset to another one included into the IRIS results by clicking on Layer Styling and Select Assets. To visualize another asset on the map just select another asset. In the left panel under the result Details is possible to create customized overview on the fly by clicking on Layer Styling and Combine Assets.


Download

In this third use case the Change Detection Analysis (IRIS) service offers the following products:

  • red_pre: single band asset product from pre-event red reflectance given as single band raster in COG format,
  • red_post: single band asset product from post-event red reflectance given as single band raster in COG format,
  • ssi: single band asset for the SSI index given as single band raster in COG format,
  • ssi-no-water: single band asset for the SSI index, after the masking of permanent waters, given as single band raster in COG format,
  • overview-iris: default overview (RGBA) derived from the ssi asset given as 4-band raster in COG format,
  • overview-iris-no-water: overview (RGBA) derived from the ssi asset, after the masking of permanent waters, given as 4-band raster in COG format,
  • iris-change-mask: single band asset from thresholding of the SSI index given as UInt8 single band raster in COG format,
  • iris-change-mask-no-water: single band asset from thresholding of the SSI index, after the masking of permanent waters, given as UInt8 single band raster in COG format,
  • contours: overview (RGBA) showing the pre-event single band asset in gray scale and superimposed detected change contours in yellow given as 4-band raster in COG format,
  • contours-no-water: overview (RGBA) showing the pre-event single band asset in gray scale and superimposed detected change contours in yellow, after the masking of permanent waters, given as 4-band raster in COG format.

These products can be downloaded by clicking on the Download button located at the bottom of the Product Details tab in the left panel.


Use case 4: change detection analysis using a pair of single band assets taken from results of other services

Abstract

This fourth use case explains how to make change detection analysis with IRIS using a pair of NDVI single band assets from Results of the OPT-Index service. Input NDVI assets are derived from EO data acquired from the same sensors before and after a wildfire event.

Find and access a Result from other on-demand services

Select the area for which you want to do an analysis e.g. over Northern California in the US. In this use case two Results from the OPT-Index are used to assess the NDVI change occurred during the Dixie Fire event of 2021.

Access two successful OPT-Index jobs in the Right Panel Processing Services under the Jobs tab by clicking on the Show results button. Same OPT-Index processing results can also be listed in the left panel under theResults tab by clicking on My results or Shared results under the Results data context.

Image-033

When selecting the pair of Results to be used for the Change Detection drag ang drop the Results into the feature basket.

Image-034

In this example the selected pair of OPT-Index results derived from Sentinel-2 L1C Calibrated Datasets are:

  • Reference OPT-Index Result (before Dixie wildfire): OPT-Index - S2 13/07/2021 Dixie Fire, US

  • Secondary OPT-Index Result (after Dixie wildfire): OPT-Index - S2 01/09/2021 Dixie Fire, US

Image-035


Fill the parameters

After the identification of input OPT-Index Results, you can employ IRIS, by using a suitable pair of normalized difference single band assets (e.g. ndvi assets) from the two OPT-Index Results derived with Sentinel-2 data. To do so you can fill the parameters as described in the following sections.

Job name

  • Insert as job name:
IRIS - NDVI change Dixie wildfire 13/07-01/09 2021

Image-036

Input pair of single-band geophysical assets

First two mandatory parameters are input "Reference" and "Secondary" single band assets from Calibrated Datasets or Results of on-demand processing. This parameter is required to specify both the reference to the Result and the single band asset (e.g. ndvi) to be used for the IRIS Change detection.

Hint

To consult the single band assets contained in a Result just Click on the Show assets button available near the feature title. After the click a list with all single band assets included within the Result will appear under the feature title.

Image-note-001

Thus, drag and Drop the selected assets:

  1. single band asset from reference Result for ndvi

  2. single band asset from secondary Result for ndvi

in the Pre-event single band asset and Post-event single band asset fields respectively.

Image-037

Area of interest expressed as Well-known text (optional)

The “Area of interest as Well Known Text” can be defined by using the drawn polygon defined with the area filter.

Window size

Insert as a value for the window size the value of 41.

Threshold

Insert as a threshold the value of 0.4. This value will be used by the processor in the binarization of SSI to estimate the binary change mask and generate the contours overview.

Co-registration method

In this mandatory parameter the user shall choose the co-registration method to employ. Under Co-registration type a list of selectable options are available. Find specifications of each option here. Insert, for example, the default value Rigid to employ a rigid co-registration of secondary and reference input assets. The full-field displacement measured is used to estimate an Affine transformation matrix which is then applied to the secondary image.

Image-038


Run the job

Click on the button Run Job and see the Running Job. You can monitor job progress through the progress bar.


Results: download and visualization

Once the job is completed, click on the Show results button located at the bottom of the processing service panel. Below is reported the syntax which includes all the parameters employed in this example.

{
   "pre_event": "https://catalog.disasterscharter.org//VA_ESA_MArcorace/cat/fb580c88451af031265f132f655fd9f329413c3d2d2c50d134ca21f27d3c42a2/search?format=json&uid=fb580c88-spectral-index#ndvi",
   "post_event": "https://catalog.disasterscharter.org//VA_ESA_MArcorace/cat/df366920cbe6bc2a2bb0e3392b30bdea12ea76ffacd4a98f270adbcee7d96a43/search?format=json&uid=df366920-spectral-index#ndvi",
   "win_size": "41",
   "threshold": "0.4",
   "coreg_type": "Rigid",
   "aoi": "POLYGON((-121.553 39.855,-121.553 40.491,-120.789 40.491,-120.789 39.855,-121.553 39.855))"
}

Visualization

See the result on the map. The preview appears within the area defined in the spatial filter.

To get more information about the product just click on the preview in the map, a bubble showing the name of the layer IRIS Change detection for spectral-index and spectral-index will appear and then click on the Show details button.

In the left panel of the interface, the details of Job Result will appear with Product metadata. Furthermore by clicking on Layer styling you can also access to the View options.

In here it is possible to see histogram/s of the Product which is visible in the map, set color formula, change Filters (e.g. Brightness, Opacity).

overview-iris asset

Image-039

In the left panel under the result Details is possible to switch from the default asset to another one included into the IRIS results by clicking on Layer Styling and Select Assets. To visualize another asset on the map just select another asset. In the left panel under the result Details is possible to create customized overview on the fly by clicking on Layer Styling and Combine Assets.


Download

In this third use case the Change Detection Analysis (IRIS) service offers the following products:

  • ndvi_pre: single band asset product from pre-event ndvi asset given as single band raster in COG format,
  • ndvi_post: single band asset product from post-event ndvi asset given as single band raster in COG format,
  • ssi: single band asset for the SSI index given as single band raster in COG format,
  • ssi-no-water: single band asset for the SSI index, after the masking of permanent waters, given as single band raster in COG format,
  • overview-iris: default overview (RGBA) derived from the ssi asset given as 4-band raster in COG format,
  • overview-iris-no-water: overview (RGBA) derived from the ssi asset, after the masking of permanent waters, given as 4-band raster in COG format,
  • iris-change-mask: single band asset from thresholding of the SSI index given as UInt8 single band raster in COG format,
  • iris-change-mask-no-water: single band asset from thresholding of the SSI index, after the masking of permanent waters, given as UInt8 single band raster in COG format,
  • contours: overview (RGBA) showing the pre-event single band asset in gray scale and superimposed detected change contours in yellow given as 4-band raster in COG format,
  • contours-no-water: overview (RGBA) showing the pre-event single band asset in gray scale and superimposed detected change contours in yellow, after the masking of permanent waters, given as 4-band raster in COG format.

These products can be downloaded by clicking on the Download button located at the bottom of the Product Details tab in the left panel.