deploy: e915495

Author: XavierCLL

_images/example_step1.webp

@@ -6,7 +6,5 @@ We identified the need for a dedicated tool that could support systematic and ri
 
 ThRasE is an official component of our Digital Image Processing Protocol for Quantifying Deforestation in Colombia {cite}`galindo:2014`, where it plays a central role in our quality assurance workflows. We use ThRasE to conduct systematic reviews of land cover classifications, correct misclassifications through expert visual interpretation of satellite imagery, and ensure our forest monitoring products meet the accuracy standards required for national reporting.
 
-ThRasE has been adopted by research teams, monitoring programs, and mapping projects worldwide for diverse applications including manual post-processing to correct land-use/land-cover misclassifications via photo-interpretation of satellite image mosaics {cite}`vallet:2024,rayner:2022`; knowledge-based manual correction of misclassifications and residual errors {cite}`rayner:2021effects,senterre:2023,bladh:2024`; manual classification/reclassification of pixels for land-cover reconstruction to reconcile multi-date imagery {cite}`gunawan:2023`; annotation of historical aerial imagery for model calibration and fine-tuning {cite}`eyster:2024`; as a validation/visual QA step {cite}`hariyanto:2024`; refinement of agricultural maps {cite}`gandharum:2025,rayner:2021historical`; among other applications {cite}`hariyanto:2022,dupuy:2024,queiroga:2020,nunes:2024`.
-
 Author and developer: *Xavier C. Llano* *<xavier.corredor.llano@gmail.com>*  
 Theoretical support, testing, and product verification: SMByC-PDI group

_images/example_step2.webp

@@ -15,19 +15,88 @@ ThRasE is available from the official QGIS Plugin Repository. To install it:
 :align: center
 ```
 
-This example provides a sample dataset to demonstrate the capabilities of ThRasE using a demo of a scenario. The data covers the Tinigua National Natural Park in Colombia, an area with a high rate of deforestation, and showcases forest land change between 2019 and 2020.
+This example provides a sample dataset to demonstrate the capabilities of ThRasE. The data covers the Tinigua National Natural Park in Colombia, an area with a high rate of deforestation, and showcases forest land change between 2019 and 2020.
 
 The thematic map includes the following classes:
 *   Stable Forest (class 1)
 *   Non-Stable Forest (class 5)
 *   Deforestation (class 2)
 
-The example also includes mean composite maps for each year as a reference data.
+The example also includes mean composite maps for each year as reference data.
 
-[Download the ThRasE Example ZIP file](https://github.com/SMByC/ThRasE/raw/refs/heads/main/docs/ThRasE%20Example.zip)
+### Step 1: Download the demo
 
-Unzip the file and load the ThRasE session file (`.yaml`) in the init ThRasE dialog.
+[Download the ThRasE Example ZIP file](https://github.com/SMByC/ThRasE/raw/refs/heads/main/docs/ThRasE%20Example.zip)
 
 ```{important}
 All files in this example are for demonstration purposes only and do not represent official data.
 ```
+
+### Step 2: Load the demo
+
+Unzip the file and load the ThRasE session file (`.yaml`) in the ThRasE initialization dialog.
+
+```{image} images/example_step1.webp
+:width: 40%
+:align: center
+```
+
+### Step 3: Build and explore the navigation
+
+Enable/disable the navigation tool (1) and open the navigation dialog (2). The demo has already built the navigation tiles using a user-defined area of interest (AOI). You can explore the navigation options with the different navigation types (3) and other settings.
+
+```{image} images/example_step2.webp
+:width: 80%
+:align: center
+```
+
+### Step 4: Layers and Edit tools
+
+You can show/hide the Layers and Edit tool toolbars. In the Layers toolbar (1) you can add or change an image layer to visualize in the multi-view panels. The Edit toolbar (2) is available in every view to edit the thematic map.
+
+```{image} images/example_step3.webp
+:width: 80%
+:align: center
+```
+
+```{note}
+Thematic map can be edited in any view, even if thematic map is not displayed in the view.
+```
+
+### Step 5: Recode pixel table
+
+You can edit the thematic map with the Recode pixel table. The demo configuration (this is just an example and not an official configuration) shows a recode pixel table to change class 2 (Deforestation) to class 1 (Stable Forest) and class 5 (Non-Stable Forest) to class 2 (Deforestation). This means you can change multiple classes at once in a single operation.
+
+```{image} images/example_step4.webp
+:width: 30%
+:align: center
+```
+
+### Step 6: Editing - Apply the recode pixel table
+
+You can apply the recode pixel table with the editing tools based on your needs and in specific areas of the thematic map. First, optionally, you can disable or adjust the transparency of a layer that is covering the thematic map to better visualize the editing areas (1). Then, pick an editing tool (2) and start editing the thematic map (3). The functionality and options depend on the editing tool you choose (see the tooltips for controls). Each editing tool has its own undo and redo history, so you can edit safely and step back if something is not right.
+
+```{image} images/example_step5.webp
+:width: 80%
+:align: center
+```
+
+You can see the entry and the number of pixels edited in the Registry widget and in the notification bar.
+
+```{image} images/example_step6.webp
+:width: 80%
+:align: center
+```
+
+### Step 7: Registry
+
+You can see the registry of the edits in the Registry widget. The registry is a list of the edits made to the thematic map. You can highlight the edited areas in the thematic map stored in the registry (1) and navigate through the edits with the slider (2). You can also export the registry to a vector file with all pixel modifications, including original and new pixel values, and timestamps (3).
+
+```{image} images/example_step7.webp
+:width: 80%
+:align: center
+```
+
+```{note}
+This example is just a basic demonstration of the capabilities of ThRasE. ThRasE has many more features and options to explore and use. Read the documentation to learn more about its full capabilities.
+```

_images/example_step3.webp

@@ -25,3 +25,5 @@ ThRasE is designed for anyone who needs to review, correct, or validate thematic
 - **GIS specialists** responsible for quality control of thematic products, ensuring that final maps meet accuracy requirements before publication or delivery
 - **Environmental monitoring teams** conducting systematic reviews of forest maps or other environmental datasets where accuracy is critical for decision-making
 - **Research teams** who need to manually refine classification results, annotate training data, or validate model outputs with expert knowledge
+
+ThRasE has been adopted by research teams, monitoring programs, and mapping projects worldwide for diverse applications including manual post-processing to correct land-use/land-cover misclassifications via photo-interpretation of satellite image mosaics {cite}`vallet:2024,rayner:2022`; knowledge-based manual correction of misclassifications and residual errors {cite}`rayner:2021effects,senterre:2023,bladh:2024`; manual classification/reclassification of pixels for land-cover reconstruction to reconcile multi-date imagery {cite}`gunawan:2023`; annotation of historical aerial imagery for model calibration and fine-tuning {cite}`eyster:2024`; as a validation/visual QA step {cite}`hariyanto:2024`; refinement of agricultural maps {cite}`gandharum:2025,rayner:2021historical`; among other applications {cite}`hariyanto:2022,dupuy:2024,queiroga:2020,nunes:2024`.