02SentinelChange carries one Sentinel-1 or Sentinel-2 change study from an area of interest to a reported map inside QGIS, with no account and nothing to install. It searches two public STAC catalogues, reads only the area of interest from the cloud-optimised GeoTIFFs, masks clouds, builds clear before and after composites on one grid in metres, and computes spectral indices, burn severity, radar flood extent, index change and per-pixel break dates. Every layer is a GeoTIFF or GeoPackage that carries its provenance (scene ids, dates, formula, reference and the Copernicus attribution), and the HTML report lists every method with the equations of this manual.
The same steps are available in two forms: the lab dock (section 5), which keeps one study per session and adds styled layers to the map, and the Processing provider (section 6), whose algorithms chain in the Graphical Modeler and in batch mode. Both call the same analysis core; neither re-implements a method.
Only qgis.core, GDAL and numpy are required; SciPy is used for speed when present and gives identical results.
In QGIS: Plugins > Manage and Install Plugins, search 02SentinelChange, Install. The release zip from GitLab installs with Install from ZIP. The plugin adds a toolbar button, a Plugins > 02SentinelChange menu (lab and manual) and the 02SentinelChange group in the Processing Toolbox.
| Source | Collection | Access | Used for |
|---|---|---|---|
| Element 84 Earth Search v1 (default) | sentinel-2-c1-l2a | anonymous; public COGs over HTTPS | Sentinel-2 bands and SCL |
| Microsoft Planetary Computer (fall-back) | sentinel-2-l2a | anonymous SAS token | Sentinel-2 bands and SCL |
| Microsoft Planetary Computer | sentinel-1-grd | anonymous SAS token | VV / VH and calibration tables |
| Microsoft Planetary Computer | sentinel-1-rtc | needs a Planetary Computer subscription key | terrain-corrected backscatter (opt-in) |
| Microsoft Planetary Computer | jrc-gsw occurrence | anonymous SAS token | permanent-water mask |
| Local files | GeoTIFF / COG per band | offline | any analysis (Processing: Scene from local files) |
Sentinel-2 dates are sent in full RFC 3339 form. When one Sentinel-2 source fails, the other is tried and the log says so. Planetary Computer tokens are cached per collection until five minutes before they expire. HTTP goes through the QGIS network manager, so the QGIS proxy and SSL settings apply; pixel reads use GDAL /vsicurl/ range requests with GDAL options set only for the duration of a read and restored afterwards.
Reflectance: scale and offset are taken from the STAC raster:bands when present (Earth Search Collection 1: ); Planetary Computer carries none, so the ESA rule applies (offset from processing baseline 04.00, none before).
Sentinel data are provided under the Copernicus Sentinel Data Legal Notice (free, full and open). Every output carries the line "Contains modified Copernicus Sentinel data [year]". Sentinel-1 RTC is CC-BY-4.0. JRC Global Surface Water is distributed by the EC JRC and cited as Pekel et al. (2016). Demo outputs are labelled "Synthetic demo data (not Sentinel imagery)" instead.
All pixel work of a study happens on one grid: a projected CRS in metres, an origin snapped to whole multiples of the resolution , and a fixed width and height. The CRS is the UTM zone the scenes share (their proj:epsg) when the area lies in it, otherwise the UTM zone of the area centre (EPSG 326xx north, 327xx south); the Area page and the run log state which and why. Each band is warped onto that grid with gdal.Warp: average when coarsening and bilinear when refining reflectance or backscatter, nearest neighbour for SCL and masks. Areas are pixel counts times , never measured in a geographic CRS:
Limits: 40 million pixels per band and date (for example 4 000 km² at 10 m; larger areas are refused with a request for a coarser resolution), at most 120 dates in a time series, and for break detection. Composites, series and break detection run in row blocks of at most 512 rows, so the peak array is dates × 512 × width rather than the full cube. Missing values are NaN (floats) or a declared nodata code, never 0 or −1 standing in for "undefined".
The dock sits on the right of the QGIS window with a dark icon rail; Help is pinned at the bottom. Long steps run as QGIS background tasks with a progress bar and a Cancel button, so QGIS never freezes. Results go to a 02SentinelChange layer group with sub-groups per study step.
Step 1 picks the area: the polygons of a layer (only the selected ones when there is a selection), the canvas extent, or a rectangle dragged on the map; Use this area reads it. Load demo writes the synthetic demo (section 9) and fills everything. Step 2 sets the resolution (10, 20, 30 or 60 m); a badge shows the working CRS and why, a gauge shows the pixel budget, and KPI cards show the area in hectares, the pixel count and the grid size. Step 3 sets the output and cache folders and shows source status chips; Check sources sends one request to each catalogue and turns the chip green, or red with the HTTP status.
Choose Sentinel-2 L2A or Sentinel-1 GRD, the date range, the maximum scene cloud cover (Sentinel-2), the minimum share of the area inside the footprint and the Sentinel-2 source; the optional Planetary Computer key enables Sentinel-1 RTC and is sent only to the token endpoint, never saved. Search scenes fills a timeline strip (one bar per scene) and the scene table. Tick scenes into the Before (B) and After (A) baskets, or use Split at this date. Sentinel-1 rows show orbit direction and relative orbit; flood mapping uses only scenes on the flood scene's orbit.
Method chips: median, maximum NDVI or least cloudy (section 7.2). SCL class chips set the masked classes (defaults 0, 1, 3, 8, 9, 10), a spin box the dilation in pixels, chips the bands kept. Build both composites writes both composites and adds a true-colour and a SWIR false-colour layer for each; KPI cards show scenes used, valid share and median clear count.
A searchable checklist of the 14 indices (the search matches key, label, formula and reference; the tooltip gives formula, bands and reference). Presets: Vegetation (NDVI, EVI, SAVI, NDRE, NDMI), Water (NDWI, MNDWI, AWEIsh), Built-up (NDBI, BSI, UI), Fire (NBR, NBR2, NDMI). Compute on the Before composite, the After composite or both; each index is added with its colour ramp and range, and a chart compares the means.
Pre and post windows (filled from the baskets), the offset mode (unburned ring, fixed value or none), ring width, an optional perimeter layer, the class thresholds (editable; Key & Benson defaults restores −250, −100, 100, 270, 440, 660) and the minimum mapping unit. Map burn severity adds dNBR, RdNBR, RBR, the class map and burned polygons; KPI cards show burned hectares, high-severity share and the offset; a bar chart shows hectares per class in the standard colours.
The reference window and the flood scene (same orbit), polarisation (VV is the usual choice for open water), speckle filter, log-ratio threshold, automatic threshold method or a fixed value, the permanent-water limit and the minimum mapping unit. Map the flood adds the backscatter, log-ratio and flood layers and polygons; a histogram of post-event backscatter shows the threshold line; KPI cards show new flood and permanent water in hectares, the threshold and the tiles used.
Index change uses the baskets: pick the index, difference or relative change, and Otsu or a fixed threshold; Map the change adds the change layer and the decrease / stable / increase classes with their areas. Breaks takes the index, the history and monitoring windows, harmonics, trend, , the number of consecutive anomalies and the direction; Detect breaks adds the break-date map styled by month. Probe a pixel then draws, for a clicked pixel, the clear observations, the fitted harmonic curve, the end of the history and the break date.
Write the report writes the self-contained HTML report of every step run so far (inputs, a per-basket scene summary with the full scene list with dates and ids one click below it, methods with these equations and references, KPI tables, map thumbnails, attribution); Open in browser opens it. GeoPackage of polygons writes burned and flood polygons as tables of one GeoPackage; Folder of GeoTIFFs copies every result raster as a Cloud Optimized GeoTIFF.
A short guide, the method references, the data terms and attribution, and links to this manual and the repository.
The provider 02SentinelChange has ten algorithms. Scenes pass between them as a scene table: a polygon layer in EPSG:4326, one footprint per scene, with the fields item_id, source, datetime, date, platform, cloud_pct (real), orbit, rel_orbit (integer), epsg (integer), aoi_cover (real), assets (JSON: band key → file or URL) and scale_off (JSON: band key → [scale, offset]). A scene table can be saved to a GeoPackage, filtered or edited, and given to any analysis algorithm; date windows select the scenes from it. Dates are written YYYY-MM-DD.
Analysis algorithms write their GeoTIFFs into the output folder (a temporary folder when left empty) and return them as raster outputs, so they chain in models; the main layer of each is added to the project when the run ends. Outputs are not styled by the algorithms. Help for each algorithm in the Toolbox repeats its method, formulas and references.
Processing id zero2sentinelchange:search_scenes, group Scenes.
Searches Sentinel-2 L2A or Sentinel-1 GRD scenes over the area of interest without an account and writes a scene table. Sentinel-2: Element 84 Earth Search (collection sentinel-2-c1-l2a, reflectance scale and offset from raster:bands) or Microsoft Planetary Computer (sentinel-2-l2a, the ESA processing-baseline rule DN x 1e-4 - 0.1 from baseline 04.00); when one source fails the other is tried. Sentinel-1: Planetary Computer sentinel-1-grd with anonymous SAS tokens (the terrain-corrected RTC collection needs a Planetary Computer subscription key).
Scenes are kept when their cloud cover (Sentinel-2) is at most the maximum and their footprint covers at least the given share of the area, measured in the area's UTM zone. The table is sorted oldest first. Data: Copernicus Sentinel Data Legal Notice; outputs carry the attribution 'Contains modified Copernicus Sentinel data [year]'.
| Name | Description | Type | Default |
|---|---|---|---|
AOI | Area of interest (polygons) | vector layer | |
SENSOR | Sensor Choices: Sentinel-2 L2A (optical); Sentinel-1 GRD (radar) | choice | Sentinel-2 L2A (optical) |
START | Start date (YYYY-MM-DD) | text | |
END | End date (YYYY-MM-DD) | text | |
MAX_CLOUD | Maximum scene cloud cover (percent, Sentinel-2) | number | 30.0 |
MIN_COVER | Minimum share of the area covered by the scene (percent) | number | 90.0 |
S2_SOURCE | Sentinel-2 source Choices: Earth Search (Element 84); Planetary Computer | choice (advanced) | Earth Search (Element 84) |
ORBIT | Sentinel-1 orbit direction Choices: Any; Ascending; Descending | choice (advanced) | Any |
REL_ORBIT | Sentinel-1 relative orbit (0: any) | number (advanced) | 0 |
PC_KEY | Planetary Computer subscription key (Sentinel-1 RTC only) | text (optional, advanced) | |
LIMIT | Maximum number of scenes | number (advanced) | 200 |
OUTPUT | Scene table | vector output |
| Name | Description | Type |
|---|---|---|
OUTPUT | Scene table | outputVector |
COUNT | Number of scenes | outputNumber |
Processing id zero2sentinelchange:local_scene, group Scenes.
Adds one scene made of local GeoTIFF or COG files (one file per band) to a scene table, so every analysis also runs offline. Give the Sentinel-2 bands you need (the SCL band enables cloud masking) or the Sentinel-1 VV/VH sigma0 files in linear units on one projected grid.
Scale and offset per band: the file's own GDAL scale/offset when set; for integer reflectance files without it, the product's MTD_MSIL2A.xml when the file sits in a .SAFE folder, else the rule chosen under Integer reflectance files: DN x 1e-4 - 0.1 for processing baseline 04.00 and later (every L2A product since 25 Jan 2022 and the reprocessed collection) or DN x 1e-4 before it. Float files and SCL are used as they are. An existing scene table can be given; its rows are copied and the new scene appended.
| Name | Description | Type | Default |
|---|---|---|---|
SENSOR | Sensor Choices: Sentinel-2 L2A (optical); Sentinel-1 (radar, sigma0) | choice | Sentinel-2 L2A (optical) |
DATE | Acquisition date (YYYY-MM-DD) | text | |
BLUE | Blue (B02) | raster layer (optional) | |
GREEN | Green (B03) | raster layer (optional) | |
RED | Red (B04) | raster layer (optional) | |
REDEDGE1 | Red edge 1 (B05) | raster layer (optional) | |
NIR | Near infrared (B08) | raster layer (optional) | |
SWIR16 | Shortwave infrared 1.6 um (B11) | raster layer (optional) | |
SWIR22 | Shortwave infrared 2.2 um (B12) | raster layer (optional) | |
SCL | Scene Classification (SCL) | raster layer (optional) | |
VV | VV backscatter (linear sigma0) | raster layer (optional) | |
VH | VH backscatter (linear sigma0) | raster layer (optional) | |
ITEM_ID | Scene id (empty: built from the date and file name) | text (optional) | |
ORBIT | Sentinel-1 orbit direction Choices: Unknown; Ascending; Descending | choice (advanced) | Unknown |
REL_ORBIT | Sentinel-1 relative orbit (0: unknown) | number (advanced) | 0 |
DN_RULE | Integer reflectance files without scale metadata Choices: Processing baseline 04.00 or later: DN x 1e-4 - 0.1; Before processing baseline 04.00: DN x 1e-4 | choice (advanced) | Processing baseline 04.00 or later: DN x 1e-4 - 0.1 |
SCENES | Existing scene table to append to (optional) | vector layer (optional) | |
OUTPUT | Scene table | vector output |
| Name | Description | Type |
|---|---|---|
OUTPUT | Scene table | outputVector |
COUNT | Number of scenes | outputNumber |
Processing id zero2sentinelchange:demo_data, group Scenes.
Writes the offline demo: 61 synthetic Sentinel-2 L2A dates (every 12 days from 6 Jan 2024, 200 x 200 pixels at 10 m in EPSG:32635, with clouds, shadows and an SCL band), a planted burn scar on 15 Jul 2025, a lake, and four Sentinel-1 VV/VH dates on one orbit with a planted flood on the last date, plus a JRC-style water-occurrence raster. It is synthetic data, not Sentinel imagery, and is labelled so in every output.
Outputs: the Sentinel-2 and Sentinel-1 scene tables, the area of interest, the occurrence raster and the date windows that fit the planted events.
| Name | Description | Type | Default |
|---|---|---|---|
FOLDER | Folder for the demo GeoTIFFs | folder | |
SEED | Random seed | number (advanced) | 7 |
S2_SCENES | Sentinel-2 scene table | vector output | |
S1_SCENES | Sentinel-1 scene table | vector output | |
AOI | Area of interest | vector output |
| Name | Description | Type |
|---|---|---|
FOLDER | Folder for the demo GeoTIFFs | outputFolder |
S2_SCENES | Sentinel-2 scene table | outputVector |
S1_SCENES | Sentinel-1 scene table | outputVector |
AOI | Area of interest | outputVector |
GSW | Water occurrence (percent) | outputRaster |
S2_COUNT | Sentinel-2 dates | outputNumber |
S1_COUNT | Sentinel-1 dates | outputNumber |
FIRE_PRE | Before window (fire, change) | outputString |
FIRE_POST | After window (fire, change) | outputString |
HISTORY | Break history window | outputString |
MONITOR | Break monitoring window | outputString |
FLOOD_PRE | Flood reference window | outputString |
FLOOD_POST | Flood date | outputString |
Processing id zero2sentinelchange:composites, group Composites and indices.
Builds a cloud-masked composite of the scenes in the before window and another of the scenes in the after window on one snapped UTM grid. Median: the per-pixel median of the clear observations. Maximum NDVI: per pixel, the observation with the highest NDVI. Least cloudy: the scene with the highest clear share over the area, gaps filled from the next. Every band is written as a reflectance GeoTIFF, plus a true-colour and a SWIR false-colour RGB and a clear-observation count (uint16, nodata 65535 outside the area). Work runs in row blocks of at most 512 rows, so memory stays bounded.
Composites mask clouds with the Sentinel-2 Scene Classification (SCL): the ticked classes are masked, and all of them except 'No data' are grown by the dilation in pixels (square element).
Scenes come from a scene table: the output of Search Sentinel scenes, Scene from local files or Demo data. One footprint polygon per scene with its id, date, orbit, band files (JSON) and scale/offset. Rows can be filtered or deleted before a run. Only the area of interest is read from each cloud-optimised GeoTIFF.
All layers are computed on one grid in metres: the UTM zone the scenes share when the area lies in it, else the UTM zone of the area centre, with the origin snapped to whole multiples of the resolution. Areas are pixel counts x resolution squared, never measured in a geographic CRS. Every GeoTIFF carries its provenance (scene ids, dates, formula, reference, Copernicus attribution) in its metadata.
| Name | Description | Type | Default |
|---|---|---|---|
AOI | Area of interest (polygons) | vector layer | |
SCENES | Sentinel-2 scene table | vector layer | |
BEFORE_START | Before window start (YYYY-MM-DD) | text | |
BEFORE_END | Before window end (YYYY-MM-DD) | text | |
AFTER_START | After window start (YYYY-MM-DD) | text | |
AFTER_END | After window end (YYYY-MM-DD) | text | |
RES | Resolution (m) | number | 10.0 |
METHOD | Composite method Choices: Per-pixel median of clear observations; Observation with the highest NDVI (maximum-value composite); Least cloudy scene, filled from the next | choice | Per-pixel median of clear observations |
MASK | SCL classes masked as unusable Choices: 0 - No data; 1 - Saturated or defective; 2 - Dark area pixels (topographic shadow); 3 - Cloud shadows; 4 - Vegetation; 5 - Not vegetated; 6 - Water; 7 - Unclassified; 8 - Cloud medium probability; 9 - Cloud high probability; 10 - Thin cirrus; 11 - Snow or ice | choice (optional) | 0 - No data; 1 - Saturated or defective; 3 - Cloud shadows; 8 - Cloud medium probability; 9 - Cloud high probability; 10 - Thin cirrus |
DILATE | Mask dilation (pixels) | number | 2 |
MIN_CLEAR | Minimum clear observations per pixel | number | 1 |
OUTPUT_DIR | Output folder | folder |
| Name | Description | Type |
|---|---|---|
OUTPUT_DIR | Output folder | outputFolder |
FOLDER | Output folder | outputFolder |
BEFORE_RGB | Before true colour | outputRaster |
BEFORE_SWIR | Before false colour (SWIR2, NIR, red) | outputRaster |
BEFORE_CLEAR | Before clear observation count | outputRaster |
BEFORE_VALID | Before valid share of the area | outputNumber |
BEFORE_SCENES | Before scenes used | outputNumber |
AFTER_RGB | After true colour | outputRaster |
AFTER_SWIR | After false colour (SWIR2, NIR, red) | outputRaster |
AFTER_CLEAR | After clear observation count | outputRaster |
AFTER_VALID | After valid share of the area | outputNumber |
AFTER_SCENES | After scenes used | outputNumber |
Processing id zero2sentinelchange:spectral_indices, group Composites and indices.
Computes spectral indices from surface-reflectance rasters, for example the band GeoTIFFs a composite wrote (before_red.tif, before_nir.tif and so on). All inputs must share one projected grid with square pixels. Values are multiplied by the scale and the offset added first, so digital numbers can be given directly (scale 0.0001, offset -0.1 for Sentinel-2 L2A from baseline 04.00). An index whose bands are missing is refused with a message. Pixels where a band is missing or the denominator is zero are NaN, never 0. Keys and formulas follow the Awesome Spectral Indices catalogue (Montero et al. 2023).
| Name | Description | Type | Default |
|---|---|---|---|
BLUE | Blue reflectance | raster layer (optional) | |
GREEN | Green reflectance | raster layer (optional) | |
RED | Red reflectance | raster layer (optional) | |
REDEDGE1 | Red edge 1 reflectance | raster layer (optional) | |
NIR | Near-infrared (B08) reflectance | raster layer (optional) | |
SWIR16 | SWIR 1.6 um reflectance | raster layer (optional) | |
SWIR22 | SWIR 2.2 um reflectance | raster layer (optional) | |
INDICES | Indices Choices: NDVI - Normalized Difference Vegetation Index; EVI - Enhanced Vegetation Index; SAVI - Soil-Adjusted Vegetation Index; NDRE - Normalized Difference Red Edge; NDWI - Normalized Difference Water Index; MNDWI - Modified Normalized Difference Water Index; AWEIsh - Automated Water Extraction Index (shadow); NDMI - Normalized Difference Moisture Index; NBR - Normalized Burn Ratio; NBR2 - Normalized Burn Ratio 2; NDBI - Normalized Difference Built-up Index; BSI - Bare Soil Index; NDSI - Normalized Difference Snow Index; UI - Urban Index | choice | NDVI - Normalized Difference Vegetation Index; NBR - Normalized Burn Ratio |
SCALE | Scale applied to the input values | number (advanced) | 1.0 |
OFFSET | Offset added after scaling | number (advanced) | 0.0 |
PREFIX | File name prefix | text (advanced) | index |
OUTPUT_DIR | Output folder | folder |
| Name | Description | Type |
|---|---|---|
OUTPUT_DIR | Output folder | outputFolder |
FOLDER | Output folder | outputFolder |
NDVI | NDVI | outputRaster |
EVI | EVI | outputRaster |
SAVI | SAVI | outputRaster |
NDRE | NDRE | outputRaster |
NDWI | NDWI | outputRaster |
MNDWI | MNDWI | outputRaster |
AWEIsh | AWEIsh | outputRaster |
NDMI | NDMI | outputRaster |
NBR | NBR | outputRaster |
NBR2 | NBR2 | outputRaster |
NDBI | NDBI | outputRaster |
BSI | BSI | outputRaster |
NDSI | NDSI | outputRaster |
UI | UI | outputRaster |
COUNT | Indices written | outputNumber |
Processing id zero2sentinelchange:burn_severity, group Fire.
Pre-fire and post-fire composites of NBR = (NIR - SWIR2) / (NIR + SWIR2) give dNBR, RdNBR and RBR on the x1000 scale. The offset removes the change of unburned land between the two windows: the mean dNBR in a ring of the given width outside the burn perimeter (the perimeter layer, or the pixels of moderate-low severity and above when no layer is given), a fixed value, or none. Severity classes follow USGS FIREMON (Key & Benson 2006) and UN-SPIDER: 1 enhanced regrowth high, 2 enhanced regrowth low, 3 unburned, 4 low, 5 moderate-low, 6 moderate-high, 7 high; a value on a threshold goes to the upper class. Burned polygons are the classes low and above, 8-connected, with regions smaller than the minimum mapping unit removed; each polygon carries its class, label, pixel count and area in hectares.
Scenes come from a scene table: the output of Search Sentinel scenes, Scene from local files or Demo data. One footprint polygon per scene with its id, date, orbit, band files (JSON) and scale/offset. Rows can be filtered or deleted before a run. Only the area of interest is read from each cloud-optimised GeoTIFF.
All layers are computed on one grid in metres: the UTM zone the scenes share when the area lies in it, else the UTM zone of the area centre, with the origin snapped to whole multiples of the resolution. Areas are pixel counts x resolution squared, never measured in a geographic CRS. Every GeoTIFF carries its provenance (scene ids, dates, formula, reference, Copernicus attribution) in its metadata.
| Name | Description | Type | Default |
|---|---|---|---|
AOI | Area of interest (polygons) | vector layer | |
SCENES | Sentinel-2 scene table | vector layer | |
PRE_START | Pre-fire window start (YYYY-MM-DD) | text | |
PRE_END | Pre-fire window end (YYYY-MM-DD) | text | |
POST_START | Post-fire window start (YYYY-MM-DD) | text | |
POST_END | Post-fire window end (YYYY-MM-DD) | text | |
RES | Resolution (m) | number | 10.0 |
OFFSET_MODE | dNBR offset Choices: Mean dNBR in an unburned ring around the burn; No offset; Fixed value | choice | Mean dNBR in an unburned ring around the burn |
OFFSET_VALUE | Fixed offset (dNBR x1000) | number | 0.0 |
RING_M | Unburned ring width (m) | number | 500.0 |
PERIMETER | Burn perimeter (optional) | vector layer (optional) | |
THRESHOLDS | Class thresholds, dNBR x1000 lower bounds (6 values) | text (advanced) | -250, -100, 100, 270, 440, 660 |
MMU_HA | Minimum mapping unit (ha) | number | 0.5 |
METHOD | Composite method Choices: Per-pixel median of clear observations; Observation with the highest NDVI (maximum-value composite); Least cloudy scene, filled from the next | choice (advanced) | Per-pixel median of clear observations |
MASK | SCL classes masked as unusable Choices: 0 - No data; 1 - Saturated or defective; 2 - Dark area pixels (topographic shadow); 3 - Cloud shadows; 4 - Vegetation; 5 - Not vegetated; 6 - Water; 7 - Unclassified; 8 - Cloud medium probability; 9 - Cloud high probability; 10 - Thin cirrus; 11 - Snow or ice | choice (optional, advanced) | 0 - No data; 1 - Saturated or defective; 3 - Cloud shadows; 8 - Cloud medium probability; 9 - Cloud high probability; 10 - Thin cirrus |
DILATE | Mask dilation (pixels) | number (advanced) | 2 |
MIN_CLEAR | Minimum clear observations per pixel | number (advanced) | 1 |
OUTPUT_DIR | Output folder | folder | |
BURNED | Burned area polygons | vector output |
| Name | Description | Type |
|---|---|---|
OUTPUT_DIR | Output folder | outputFolder |
FOLDER | Output folder | outputFolder |
DNBR | dNBR | outputRaster |
RDNBR | RdNBR | outputRaster |
RBR | RBR | outputRaster |
CLASSES | Severity classes | outputRaster |
BURNED | Burned area polygons | outputVector |
BURNED_HA | Burned area (ha) | outputNumber |
OFFSET | Offset used (dNBR x1000) | outputNumber |
HIGH_SHARE | High-severity share of the burned area | outputNumber |
Processing id zero2sentinelchange:flood_extent, group Flood.
Maps new open water from Sentinel-1 backscatter. GRD digital numbers are calibrated to sigma0 with the sigmaNought look-up table and warped with the scene GCPs (polynomial order 3; no terrain correction, which the log and metadata state); local files are read as linear sigma0. Speckle is reduced with a Lee filter (equivalent number of looks from the scene, 4.4 by default) or a median filter. The reference is the mean linear sigma0 of the scenes in the reference window on the same orbit direction and relative orbit as the flood scene (others are left out). A pixel is new flood when the log-ratio is below the ratio threshold, its post-event backscatter is below the water threshold, its reference backscatter is not (it was not water before), and its JRC Global Surface Water occurrence is below the permanent-water limit. The water threshold is fixed or automatic: Otsu or Kittler-Illingworth on the merged histogram of at most five bimodal tiles chosen by the split-based rule of Martinis et al. (2009) (coefficient of variation >= 0.7, tile mean / scene mean in 0.4 to 0.9), else on the whole area. Flood codes: 0 dry, 1 new flood, 2 permanent water, 255 nodata. Regions below the minimum mapping unit are removed.
All layers are computed on one grid in metres: the UTM zone the scenes share when the area lies in it, else the UTM zone of the area centre, with the origin snapped to whole multiples of the resolution. Areas are pixel counts x resolution squared, never measured in a geographic CRS. Every GeoTIFF carries its provenance (scene ids, dates, formula, reference, Copernicus attribution) in its metadata.
| Name | Description | Type | Default |
|---|---|---|---|
AOI | Area of interest (polygons) | vector layer | |
SCENES | Sentinel-1 scene table | vector layer | |
PRE_START | Reference window start (YYYY-MM-DD) | text (optional) | |
PRE_END | Reference window end (YYYY-MM-DD) | text (optional) | |
POST_DATE | Flood scene date (YYYY-MM-DD; empty: the latest scene) | text (optional) | |
RES | Resolution (m) | number | 10.0 |
POL | Polarisation Choices: VV; VH | choice | VV |
SPECKLE | Speckle filter Choices: Lee filter; Median filter; None | choice | Lee filter |
SPECKLE_SIZE | Speckle window (pixels, odd) | number (advanced) | 5 |
RATIO_DB | Log-ratio threshold (dB, a pixel must fall below it) | number | -3.0 |
WATER | Water threshold on post-event dB Choices: Otsu (automatic); Kittler-Illingworth (automatic); Fixed value | choice | Otsu (automatic) |
WATER_DB | Fixed water threshold (dB) | number | -15.0 |
TILE_PX | Split-based tile size (pixels) | number (advanced) | 200 |
GSW | Permanent-water mask Choices: Planetary Computer JRC GSW for remote scenes, none for local; No permanent-water mask; Occurrence raster given below | choice | Planetary Computer JRC GSW for remote scenes, none for local |
GSW_RASTER | Water occurrence raster (percent, optional) | raster layer (optional) | |
GSW_OCC | Permanent water above this occurrence (percent) | number | 80.0 |
MMU_HA | Minimum mapping unit (ha) | number | 0.3 |
OUTPUT_DIR | Output folder | folder | |
POLYGONS | Flood polygons | vector output |
| Name | Description | Type |
|---|---|---|
OUTPUT_DIR | Output folder | outputFolder |
FOLDER | Output folder | outputFolder |
PRE_DB | Reference backscatter (dB) | outputRaster |
POST_DB | Flood-date backscatter (dB) | outputRaster |
LOG_RATIO | Log-ratio (dB) | outputRaster |
FLOOD | Flood extent (0 dry, 1 flood, 2 permanent) | outputRaster |
POLYGONS | Flood polygons | outputVector |
FLOODED_HA | New flood (ha) | outputNumber |
PERMANENT_HA | Permanent water (ha) | outputNumber |
THRESHOLD_DB | Water threshold (dB) | outputNumber |
TILES | Tiles used for the threshold | outputNumber |
Processing id zero2sentinelchange:index_change, group Change.
Builds before and after composites with the bands the index needs, computes the index on each and its change: the difference post - pre, or the relative change (post - pre) / |pre|. Pixels whose |change| exceeds the threshold are classed as decrease (-1) or increase (1), the rest stable (0); -128 is nodata. The threshold is a fixed value or Otsu's threshold on |change|. Areas of the three classes are returned in hectares.
Scenes come from a scene table: the output of Search Sentinel scenes, Scene from local files or Demo data. One footprint polygon per scene with its id, date, orbit, band files (JSON) and scale/offset. Rows can be filtered or deleted before a run. Only the area of interest is read from each cloud-optimised GeoTIFF.
All layers are computed on one grid in metres: the UTM zone the scenes share when the area lies in it, else the UTM zone of the area centre, with the origin snapped to whole multiples of the resolution. Areas are pixel counts x resolution squared, never measured in a geographic CRS. Every GeoTIFF carries its provenance (scene ids, dates, formula, reference, Copernicus attribution) in its metadata.
| Name | Description | Type | Default |
|---|---|---|---|
AOI | Area of interest (polygons) | vector layer | |
SCENES | Sentinel-2 scene table | vector layer | |
BEFORE_START | Before window start (YYYY-MM-DD) | text | |
BEFORE_END | Before window end (YYYY-MM-DD) | text | |
AFTER_START | After window start (YYYY-MM-DD) | text | |
AFTER_END | After window end (YYYY-MM-DD) | text | |
INDEX | Index Choices: NDVI - Normalized Difference Vegetation Index; EVI - Enhanced Vegetation Index; SAVI - Soil-Adjusted Vegetation Index; NDRE - Normalized Difference Red Edge; NDWI - Normalized Difference Water Index; MNDWI - Modified Normalized Difference Water Index; AWEIsh - Automated Water Extraction Index (shadow); NDMI - Normalized Difference Moisture Index; NBR - Normalized Burn Ratio; NBR2 - Normalized Burn Ratio 2; NDBI - Normalized Difference Built-up Index; BSI - Bare Soil Index; NDSI - Normalized Difference Snow Index; UI - Urban Index | choice | NDVI - Normalized Difference Vegetation Index |
MODE | Change Choices: Difference: post - pre; Relative: (post - pre) / |pre| | choice | Difference: post - pre |
THRESHOLD_MODE | Threshold on |change| Choices: Otsu (automatic); Fixed value | choice | Otsu (automatic) |
THRESHOLD | Fixed threshold | number | 0.1 |
RES | Resolution (m) | number | 10.0 |
METHOD | Composite method Choices: Per-pixel median of clear observations; Observation with the highest NDVI (maximum-value composite); Least cloudy scene, filled from the next | choice (advanced) | Per-pixel median of clear observations |
MASK | SCL classes masked as unusable Choices: 0 - No data; 1 - Saturated or defective; 2 - Dark area pixels (topographic shadow); 3 - Cloud shadows; 4 - Vegetation; 5 - Not vegetated; 6 - Water; 7 - Unclassified; 8 - Cloud medium probability; 9 - Cloud high probability; 10 - Thin cirrus; 11 - Snow or ice | choice (optional, advanced) | 0 - No data; 1 - Saturated or defective; 3 - Cloud shadows; 8 - Cloud medium probability; 9 - Cloud high probability; 10 - Thin cirrus |
DILATE | Mask dilation (pixels) | number (advanced) | 2 |
MIN_CLEAR | Minimum clear observations per pixel | number (advanced) | 1 |
OUTPUT_DIR | Output folder | folder |
| Name | Description | Type |
|---|---|---|
OUTPUT_DIR | Output folder | outputFolder |
FOLDER | Output folder | outputFolder |
DELTA | Index change | outputRaster |
CLASSES | Change classes (-1, 0, 1) | outputRaster |
THRESHOLD_USED | Threshold used | outputNumber |
DECREASE_HA | Decrease (ha) | outputNumber |
STABLE_HA | Stable (ha) | outputNumber |
INCREASE_HA | Increase (ha) | outputNumber |
Processing id zero2sentinelchange:break_detection, group Change.
Per pixel, the clear-observation index series of every scene from the history start to the monitoring end is modelled on the history period by ordinary least squares: an intercept, an optional linear trend and 0 to 3 harmonic pairs per year, solved for all pixels at once. sigma is the history RMSE. In the monitoring period an observation is an anomaly when its residual exceeds z sigma in the chosen direction; a break is confirmed at the first of the given number of consecutive anomalies (CCDC-style monitoring after Zhu & Woodcock 2014, framing after BFAST Monitor, Verbesselt et al. 2012; MOSUM/CUSUM boundaries are not used). Outputs: break flag (1/0, 255 nodata), break date (decimal year), magnitude (median residual of the confirming run), history RMSE, and the series as a multi-band GeoTIFF (one band per date). Pixels with fewer clear history observations than the minimum are nodata. With a trend term, a history shorter than about 18 months cannot separate trend from season and gives false breaks; use at least 18 to 24 months.
Scenes come from a scene table: the output of Search Sentinel scenes, Scene from local files or Demo data. One footprint polygon per scene with its id, date, orbit, band files (JSON) and scale/offset. Rows can be filtered or deleted before a run. Only the area of interest is read from each cloud-optimised GeoTIFF.
All layers are computed on one grid in metres: the UTM zone the scenes share when the area lies in it, else the UTM zone of the area centre, with the origin snapped to whole multiples of the resolution. Areas are pixel counts x resolution squared, never measured in a geographic CRS. Every GeoTIFF carries its provenance (scene ids, dates, formula, reference, Copernicus attribution) in its metadata.
| Name | Description | Type | Default |
|---|---|---|---|
AOI | Area of interest (polygons) | vector layer | |
SCENES | Sentinel-2 scene table | vector layer | |
INDEX | Index Choices: NDVI - Normalized Difference Vegetation Index; EVI - Enhanced Vegetation Index; SAVI - Soil-Adjusted Vegetation Index; NDRE - Normalized Difference Red Edge; NDWI - Normalized Difference Water Index; MNDWI - Modified Normalized Difference Water Index; AWEIsh - Automated Water Extraction Index (shadow); NDMI - Normalized Difference Moisture Index; NBR - Normalized Burn Ratio; NBR2 - Normalized Burn Ratio 2; NDBI - Normalized Difference Built-up Index; BSI - Bare Soil Index; NDSI - Normalized Difference Snow Index; UI - Urban Index | choice | NDVI - Normalized Difference Vegetation Index |
HISTORY_START | History window start (YYYY-MM-DD) | text | |
HISTORY_END | History window end (YYYY-MM-DD) | text | |
MONITOR_START | Monitoring window start (YYYY-MM-DD) | text | |
MONITOR_END | Monitoring window end (YYYY-MM-DD) | text | |
HARMONICS | Harmonic pairs per year | number | 1 |
TREND | Linear trend term | yes/no | True |
Z | Anomaly threshold (residual sigmas) | number | 3.0 |
CONSECUTIVE | Consecutive anomalies to confirm a break | number | 3 |
MIN_HISTORY | Minimum clear history observations | number (advanced) | 12 |
DIRECTION | Direction Choices: Negative (index drops); Positive (index rises); Both | choice | Both |
RES | Resolution (m) | number | 10.0 |
METHOD | Composite method Choices: Per-pixel median of clear observations; Observation with the highest NDVI (maximum-value composite); Least cloudy scene, filled from the next | choice (advanced) | Per-pixel median of clear observations |
MASK | SCL classes masked as unusable Choices: 0 - No data; 1 - Saturated or defective; 2 - Dark area pixels (topographic shadow); 3 - Cloud shadows; 4 - Vegetation; 5 - Not vegetated; 6 - Water; 7 - Unclassified; 8 - Cloud medium probability; 9 - Cloud high probability; 10 - Thin cirrus; 11 - Snow or ice | choice (optional, advanced) | 0 - No data; 1 - Saturated or defective; 3 - Cloud shadows; 8 - Cloud medium probability; 9 - Cloud high probability; 10 - Thin cirrus |
DILATE | Mask dilation (pixels) | number (advanced) | 2 |
MIN_CLEAR | Minimum clear observations per pixel | number (advanced) | 1 |
OUTPUT_DIR | Output folder | folder |
| Name | Description | Type |
|---|---|---|
OUTPUT_DIR | Output folder | outputFolder |
FOLDER | Output folder | outputFolder |
HAS_BREAK | Break flag | outputRaster |
BREAK_DATE | Break date (decimal year) | outputRaster |
MAGNITUDE | Break magnitude | outputRaster |
RMSE | History RMSE | outputRaster |
SERIES | Index series (one band per date) | outputRaster |
BREAK_SHARE | Share of evaluated pixels with a break | outputNumber |
DATES | Dates in the series | outputNumber |
Processing id zero2sentinelchange:change_study, group Study and report.
Runs a whole change study with the same staged pipeline as the dock and writes the self-contained HTML report (inputs, scene list, methods with typeset formulas and references, KPI tables, map thumbnails, attribution). Steps: before and after composites with the chosen indices; burn severity (dNBR, RdNBR, RBR with a ring offset and USGS/UN-SPIDER classes); index change; break detection over the history and monitoring windows; Sentinel-1 flood extent. Each step is described in its own algorithm in this provider; this one uses their default settings for anything not listed here. All layers are written to the output folder, polygons to polygons.gpkg.
Scenes come from a scene table: the output of Search Sentinel scenes, Scene from local files or Demo data. One footprint polygon per scene with its id, date, orbit, band files (JSON) and scale/offset. Rows can be filtered or deleted before a run. Only the area of interest is read from each cloud-optimised GeoTIFF.
All layers are computed on one grid in metres: the UTM zone the scenes share when the area lies in it, else the UTM zone of the area centre, with the origin snapped to whole multiples of the resolution. Areas are pixel counts x resolution squared, never measured in a geographic CRS. Every GeoTIFF carries its provenance (scene ids, dates, formula, reference, Copernicus attribution) in its metadata.
| Name | Description | Type | Default |
|---|---|---|---|
AOI | Area of interest (polygons) | vector layer | |
S2_SCENES | Sentinel-2 scene table (optional) | vector layer (optional) | |
S1_SCENES | Sentinel-1 scene table (optional) | vector layer (optional) | |
STEPS | Steps Choices: Composites and indices; Burn severity; Index change; Break detection; Flood extent (Sentinel-1) | choice | Composites and indices; Burn severity; Index change |
BEFORE_START | Before window start (YYYY-MM-DD) | text (optional) | |
BEFORE_END | Before window end (YYYY-MM-DD) | text (optional) | |
AFTER_START | After window start (YYYY-MM-DD) | text (optional) | |
AFTER_END | After window end (YYYY-MM-DD) | text (optional) | |
INDICES | Indices on the composites Choices: NDVI - Normalized Difference Vegetation Index; EVI - Enhanced Vegetation Index; SAVI - Soil-Adjusted Vegetation Index; NDRE - Normalized Difference Red Edge; NDWI - Normalized Difference Water Index; MNDWI - Modified Normalized Difference Water Index; AWEIsh - Automated Water Extraction Index (shadow); NDMI - Normalized Difference Moisture Index; NBR - Normalized Burn Ratio; NBR2 - Normalized Burn Ratio 2; NDBI - Normalized Difference Built-up Index; BSI - Bare Soil Index; NDSI - Normalized Difference Snow Index; UI - Urban Index | choice (optional) | NDVI - Normalized Difference Vegetation Index; NBR - Normalized Burn Ratio; MNDWI - Modified Normalized Difference Water Index |
CHANGE_INDEX | Index for the change step Choices: NDVI - Normalized Difference Vegetation Index; EVI - Enhanced Vegetation Index; SAVI - Soil-Adjusted Vegetation Index; NDRE - Normalized Difference Red Edge; NDWI - Normalized Difference Water Index; MNDWI - Modified Normalized Difference Water Index; AWEIsh - Automated Water Extraction Index (shadow); NDMI - Normalized Difference Moisture Index; NBR - Normalized Burn Ratio; NBR2 - Normalized Burn Ratio 2; NDBI - Normalized Difference Built-up Index; BSI - Bare Soil Index; NDSI - Normalized Difference Snow Index; UI - Urban Index | choice | NDVI - Normalized Difference Vegetation Index |
BREAK_INDEX | Index for break detection Choices: NDVI - Normalized Difference Vegetation Index; EVI - Enhanced Vegetation Index; SAVI - Soil-Adjusted Vegetation Index; NDRE - Normalized Difference Red Edge; NDWI - Normalized Difference Water Index; MNDWI - Modified Normalized Difference Water Index; AWEIsh - Automated Water Extraction Index (shadow); NDMI - Normalized Difference Moisture Index; NBR - Normalized Burn Ratio; NBR2 - Normalized Burn Ratio 2; NDBI - Normalized Difference Built-up Index; BSI - Bare Soil Index; NDSI - Normalized Difference Snow Index; UI - Urban Index | choice | NDVI - Normalized Difference Vegetation Index |
HISTORY_START | Break history window start (YYYY-MM-DD) | text (optional) | |
HISTORY_END | Break history window end (YYYY-MM-DD) | text (optional) | |
MONITOR_START | Break monitoring window start (YYYY-MM-DD) | text (optional) | |
MONITOR_END | Break monitoring window end (YYYY-MM-DD) | text (optional) | |
FLOOD_PRE_START | Flood reference window start (YYYY-MM-DD) | text (optional) | |
FLOOD_PRE_END | Flood reference window end (YYYY-MM-DD) | text (optional) | |
FLOOD_DATE | Flood scene date (YYYY-MM-DD; empty: the latest scene) | text (optional) | |
RES | Resolution (m) | number | 10.0 |
METHOD | Composite method Choices: Per-pixel median of clear observations; Observation with the highest NDVI (maximum-value composite); Least cloudy scene, filled from the next | choice (advanced) | Per-pixel median of clear observations |
MASK | SCL classes masked as unusable Choices: 0 - No data; 1 - Saturated or defective; 2 - Dark area pixels (topographic shadow); 3 - Cloud shadows; 4 - Vegetation; 5 - Not vegetated; 6 - Water; 7 - Unclassified; 8 - Cloud medium probability; 9 - Cloud high probability; 10 - Thin cirrus; 11 - Snow or ice | choice (optional, advanced) | 0 - No data; 1 - Saturated or defective; 3 - Cloud shadows; 8 - Cloud medium probability; 9 - Cloud high probability; 10 - Thin cirrus |
DILATE | Mask dilation (pixels) | number (advanced) | 2 |
MIN_CLEAR | Minimum clear observations per pixel | number (advanced) | 1 |
OUTPUT_DIR | Output folder | folder | |
REPORT | HTML report | file |
| Name | Description | Type |
|---|---|---|
OUTPUT_DIR | Output folder | outputFolder |
FOLDER | Output folder | outputFolder |
REPORT | HTML report | outputHtml |
POLYGONS | Burned and flood polygons (GeoPackage) | outputVector |
BURNED_HA | Burned area (ha) | outputNumber |
FLOODED_HA | New flood (ha) | outputNumber |
BREAK_SHARE | Share of pixels with a break | outputNumber |
STEPS_RUN | Steps run | outputNumber |
Equation numbers are the same in the HTML report.
Sentinel-2 L2A Scene Classification (SCL, 20 m, nearest-neighbour resampling). An observation of pixel is clear, , when its SCL class is not in the masked set . The masked classes other than "no data" are grown by the dilation pixels with a square structuring element (one cloud pixel becomes a block); class 0 is masked but not grown, so swath edges keep their pixels (Main-Knorn et al. 2017).
| SCL | Class | Default |
|---|---|---|
| 0 | No data | masked |
| 1 | Saturated or defective | masked |
| 2 | Dark area pixels (topographic shadow) | kept |
| 3 | Cloud shadows | masked |
| 4 | Vegetation | kept |
| 5 | Not vegetated | kept |
| 6 | Water | kept |
| 7 | Unclassified | kept |
| 8 | Cloud medium probability | masked |
| 9 | Cloud high probability | masked |
| 10 | Thin cirrus | masked |
| 11 | Snow or ice | kept |
For a window of scenes, the median composite of band and the clear count are
Maximum NDVI takes, per pixel, the clear observation with the highest NDVI (Holben 1986). Least cloudy takes the scene with the highest clear share over the area and fills its gaps from the next one. Pixels with fewer clear observations than the minimum are NaN; the clear count is 65535 outside the area.
Band symbols: blue (B02), green (B03), red (B04), red edge 1 (B05, 20 m), near infrared (B08, 10 m), SWIR 1.6 µm (B11), SWIR 2.2 µm (B12). Keys follow Awesome Spectral Indices (Montero et al. 2023). A pixel where a band is missing or the denominator is zero is NaN.
| Key | Name | Formula | Bands | Reference |
|---|---|---|---|---|
| NDVI | Normalized Difference Vegetation Index | nir, red | Rouse, J.W., Haas, R.H., Schell, J.A., Deering, D.W. (1974) | |
| EVI | Enhanced Vegetation Index | nir, red, blue | Huete, A., Didan, K., Miura, T., Rodriguez, E.P., Gao, X., Ferreira, L.G. (2002) | |
| SAVI | Soil-Adjusted Vegetation Index | nir, red | Huete, A.R. (1988) | |
| NDRE | Normalized Difference Red Edge | nir, rededge1 | Gitelson, A., Merzlyak, M.N. (1994) | |
| NDWI | Normalized Difference Water Index | green, nir | McFeeters, S.K. (1996) | |
| MNDWI | Modified Normalized Difference Water Index | green, swir16 | Xu, H. (2006) | |
| AWEIsh | Automated Water Extraction Index (shadow) | blue, green, nir, swir16, swir22 | Feyisa, G.L., Meilby, H., Fensholt, R., Proud, S.R. (2014) | |
| NDMI | Normalized Difference Moisture Index | nir, swir16 | Gao, B.-C. (1996) | |
| NBR | Normalized Burn Ratio | nir, swir22 | Key, C.H., Benson, N.C. (2006) | |
| NBR2 | Normalized Burn Ratio 2 | swir16, swir22 | Key, C.H., Benson, N.C. (2006) | |
| NDBI | Normalized Difference Built-up Index | swir16, nir | Zha, Y., Gao, J., Ni, S. (2003) | |
| BSI | Bare Soil Index | swir16, red, nir, blue | Rikimaru, A., Roy, P.S., Miyatake, S. (2002) | |
| NDSI | Normalized Difference Snow Index | green, swir16 | Hall, D.K., Riggs, G.A., Salomonson, V.V. (1995) | |
| UI | Urban Index | swir22, nir | Kawamura, M., Jayamanna, S., Tsujiko, Y. (1996) |
With from the pre-fire and post-fire composites:
The ring is the band of width ring metres outside the perimeter (the perimeter layer, or the pixels of moderate-low severity and above before the offset when no layer is given), Chebyshev distance on the grid (Key 2006; Miller & Thode 2007).
Classes (USGS FIREMON, Key & Benson 2006; UN-SPIDER Recommended Practice); a value on a bound goes to the upper class, 0 is nodata:
| Class | Label | dNBR (×1000) |
|---|---|---|
| 1 | Enhanced regrowth, high | dNBR < −250 |
| 2 | Enhanced regrowth, low | −250 ≤ dNBR < −100 |
| 3 | Unburned | −100 ≤ dNBR < 100 |
| 4 | Low severity | 100 ≤ dNBR < 270 |
| 5 | Moderate-low severity | 270 ≤ dNBR < 440 |
| 6 | Moderate-high severity | 440 ≤ dNBR < 660 |
| 7 | High severity | dNBR ≥ 660 |
Burned polygons are the classes 4 to 7, 8-connected, with regions below the minimum mapping unit removed; each polygon carries class, label, pixels and area_ha.
GRD digital numbers are read in radar geometry for the window the scene GCPs give for the area, calibrated with the sigmaNought look-up table interpolated bilinearly (ESA-EOPG-CSCOP-TN-0002), then warped to the grid with a GCP polynomial of order 3. There is no thermal-noise removal or terrain correction. Local radar files are read as linear .
is the equivalent number of looks (sar:looks_equivalent_number, 4.4 by default); the median filter is the alternative (Lee 1980). The reference is the mean linear backscatter of the reference scenes on the same orbit direction and relative orbit as the flood scene.
The water threshold on post-event dB is fixed or automatic. Automatic thresholds use the split-based rule of Martinis et al. (2009): the area is cut into tiles of tile pixels; a tile is a candidate when its coefficient of variation is at least 0.7 and its mean over the scene mean lies in 0.4 to 0.9; at most five candidates closest to the mean are kept and the threshold is found on their merged histogram, or on the whole area when no tile qualifies.
Here is the share of values below , their partial mean, the total mean (Otsu 1979), and , the share and standard deviation of each side (Kittler & Illingworth 1986). When the histogram has an empty gap between the modes, the centre of the flat optimum is returned.
is the log-ratio threshold (−3 dB by default) and the JRC occurrence with limit (80 %). Pixels that are water after the event and either above the occurrence limit or already water in the reference are permanent water (code 2), reported separately. Regions below the minimum mapping unit are removed. Framing: Twele et al. (2016); UN-SPIDER Recommended Practice for Sentinel-1 flood mapping.
Per pixel, on the clear-observation index series with in decimal years, the model is fitted on the history period by ordinary least squares, solved for all pixels at once with per-pixel masked normal equations:
is the number of harmonic pairs (0 to 3), the number of coefficients, and the trend term is optional. In the monitoring period:
The direction setting keeps only negative residuals (index drops), only positive ones, or both. The break date is the first of the consecutive anomalies; the magnitude is the median residual of that run. Pixels with fewer clear history observations than the minimum are nodata (Zhu & Woodcock 2014, CCDC; monitoring framing after Verbesselt et al. 2012, BFAST Monitor). MOSUM / CUSUM significance boundaries are not used.
With a trend term, a history shorter than about 18 months cannot separate trend from season. In testing, one year of history gave 16 % false breaks and 21 months gave none. Use 18 to 24 months of history, or switch the trend off.
A pixel is a decrease () when , an increase () when and stable () otherwise; is fixed or Otsu's threshold on .
| File | Content | Nodata |
|---|---|---|
before_<band>.tif, after_<band>.tif | composite surface reflectance, Float32 | NaN |
before_rgb.tif, before_swir.tif (and after) | true colour (red, green, blue); false colour (SWIR2, NIR, red) | NaN |
before_clear_count.tif (and after) | clear observations, UInt16 | 65535 |
<tag>_<INDEX>.tif | spectral index, Float32 | NaN |
fire_dnbr.tif, fire_rdnbr.tif, fire_rbr.tif | ×1000 scale, Float32 | NaN |
fire_severity_classes.tif | classes 1 to 7, Byte | 0 |
flood_pre_db.tif, flood_post_db.tif, flood_log_ratio.tif | dB, Float32 | NaN |
flood_extent.tif | 0 dry, 1 new flood, 2 permanent water, Byte | 255 |
change_<INDEX>_<mode>.tif, change_<INDEX>_classes.tif | change; classes −1 / 0 / 1 (Int8) | NaN; −128 |
series_<INDEX>.tif | index series, one band per date (band description = date) | NaN |
breaks_has_break.tif | 1 break, 0 none, Byte | 255 |
breaks_break_date.tif, breaks_magnitude.tif, breaks_rmse.tif | decimal year; median residual; history RMSE | NaN |
polygons.gpkg | tables burned_area and flood_extent: class, label, pixels, area_ha | |
report.html | self-contained HTML report (KaTeX bundled, no external request) |
Every GeoTIFF is a Cloud Optimized GeoTIFF (DEFLATE) whose metadata hold product, software, scenes, dates, sources, formula, reference, attribution and the step settings (thresholds, offset, windows), readable with gdalinfo or the QGIS layer properties.
The demo is synthetic data, not Sentinel imagery: a 200 × 200 pixel grid at 10 m in EPSG:32635 whose top-left corner is at (500 000, 4 252 000), far from the projection origin. It holds 61 Sentinel-2 dates every 12 days from 6 January 2024, with a seasonal red-band cycle, sensor noise, cloud blobs with shadows and a few fully cloudy dates (all coded in SCL), a lake, and a burn scar on 15 July 2025 whose NBR drop is largest at its centre. Unburned land is given a planted NBR bias of 0.04 after the fire, that is 40 dNBR units, which the ring offset must recover. Four Sentinel-1 VV/VH dates on ascending orbit 131 (2, 14 and 26 July, 7 August 2025) have dry land at −8 dB and water at −20 dB with gamma speckle (); the last date adds a flood rectangle and two 2-pixel specks. A water-occurrence raster gives the lake 95 %.
FIRE_PRE 2025-05-01/2025-07-14, FIRE_POST 2025-07-16/2025-09-30, HISTORY, MONITOR, FLOOD_PRE and FLOOD_POST.OFFSET 39.98, BURNED_HA 37.61.FLOODED_HA 23.91, PERMANENT_HA 7.47.The figures above are those the test suites assert on QGIS 3.44 LTR and 4.2.
Eminoğlu, Y. (2026). 02SentinelChange - Sentinel Change Lab (version 0.1.1) [QGIS plugin]. https://gitlab.com/geophilo1/zero2sentinelchange. https://doi.org/10.5281/zenodo.24263656. The DOI 10.5281/zenodo.24263656 always resolves to the latest version; version 0.1.1 has DOI https://doi.org/10.5281/zenodo.24263657. ORCID 0009-0005-6000-2934, Dokuz Eylül University. Machine-readable metadata: CITATION.cff.
Licence: GPL-2.0-or-later. KaTeX 0.16.21 (MIT) typesets the equations of this manual and of the report.
Repository: gitlab.com/geophilo1/zero2sentinelchange · Issues: work items · Homepage: geophilo.com/zero2sentinelchange