chore: Update readme and add example image

Author: Daniel

README.md

@@ -15,21 +15,36 @@ QGIS Plugin
 
 This provider functions as a QGIS plugin (for QGIS >= 3.28) and is available via the standard QGIS plugins repository, so you can install it directly from within QGIS itself.
 
-The plugin adds a new group to the Processing Toolbox for "Geovita", containing sub-groups with tools and algorithms to perform different geotechnical tasks.
+The plugin adds a new group to the Processing Toolbox for "Geovita", containing sub-groups with tools and algorithms to perform different tasks.
 
 If you enconter bugs of any sort, PLEASE consider reporting them through [the bugtracker at GitHub](https://github.com/danpejobo/geovita_processing_plugin/issues). Everyone benefits!
 
 Check it out [here!](/geovita_processing_plugin/)
 
 Overview
 ========
-- Implemented [REMEDY GIS RiskTool](https://github.com/norwegian-geotechnical-institute/REMEDY_GIS_RiskTool) to run from QGIS processing
+### REMEDY GIS RiskTool-subgroup
 
-  - REMEDY_GIS_RiskTool is an open-source GIS-based tool using the GIBV method to quantify building damage risks from deep excavation, analyzing settlements due to wall deformation and groundwater drawdown, developed under the REMEDY/Begrens Skade 2 research project (2017–2022).
+  - [REMEDY_GIS_RiskTool](https://github.com/norwegian-geotechnical-institute/REMEDY_GIS_RiskTool) is an open-source GIS-based tool using the GIBV method to quantify building damage risks from deep excavation, analyzing settlements due to wall deformation and groundwater drawdown, developed under the REMEDY/Begrens Skade 2 research project (2017–2022).
 
 ## Example results from the REMEDY GIS RiskTool
 The following images show some example results. Both the excavation and the tunnel algorithm produces results for short and/or longterm settlements, but uses different calculation methods. The impact map calculates and illustrate total settlements in the impaced soil around the excavation.
 
 | Loaded Layers | Short term | Long term | Impact map |
 |---------------|------------|-----------|------------|
 | ![Loaded layers](resources/example-short-term-layers.png) <br><br> The symbology of the loaded layers | ![Short term](resources/example-short-term.png) <br><br> Blue hatch is the excavation. Status of corners, walls and buildings | ![Long term](resources/example-long-short-term.png) <br><br> Blue hatch is the excavation. Dark background is the depth to bedrock raster used for long term settlements. | ![Impact map](resources/example-impact-map.png) <br><br> Red hatch is the excavation. The impact map for total settlements around the excavation. |
+
+---
+
+### Geovita-subgroup
+
+#### Create Atlas Coverage
+This algorithm automates the creation of a coverage layer for use with the QGIS Atlas feature, which is ideal for generating multi-page "strip maps" along a route (like a road or tunnel).
+
+The tool takes a single line (e.g., a road centerline), your desired map scale, and your paper dimensions to generate two key output layers:
+
+   - Atlas Points: A point layer where each point represents the center of a map sheet. This layer contains a crucial angle field, which is automatically calculated to ensure the "long axis" of your paper is aligned with the road.
+
+   - Atlas Coverage Polygons: A polygon layer that shows the footprint (the exact rectangular coverage) of each map sheet. This is perfect for creating an index or key map.
+
+<img src="resources\example-create-atlas-coverage.png" alt="Atlas Coverage" width="800"/>

geovita_processing_plugin/README.md

@@ -2,8 +2,12 @@ Introduction
 =====
 Processing providers and algorithms overview
 
-Status and Limitations
+
+REMEDY GIS RiskTool group
 =====
+---
+
+### Status and limitations
 - [REMEDY GIS RiskTool](https://github.com/norwegian-geotechnical-institute/REMEDY_GIS_RiskTool)
   - REMEDY_GIS_RiskTool is an open-source GIS-based tool using the GIBV method to quantify building damage risks from deep excavation, analyzing settlements due to wall deformation and groundwater drawdown, developed under the REMEDY/Begrens Skade 2 research project (2017–2022).
 
@@ -13,15 +17,14 @@ Status and Limitations
   - Projection of layers:
     - All layers `are reprojected on the fly` as they need the same projection
 
-Tools
-=====
+### Tools
+
 - **REMEDY GIS RiskTool** - These algorithms create a log directory in this location `%user%/Downloads/REMEDY`. For the moment this is hardcoded.
   - `Begrens Skade - Excavation` Analyzes building settlement risks in soft clays caused by deep excavation wall deformation, using the GIBV method to calculate vertical greenfield settlements based on empirical data from retaining wall behavior (developed under the REMEDY/Begrens Skade 2 project).
   - `Begrens Skade - ImpactMap` Quantifies short- and long-term consolidation settlements from groundwater drawdown during construction pit establishment, employing the GIBV method and empirical datasets to model spatiotemporal risk distribution in soft clays (part of the NFR-funded REMEDY initiative).
   - `Begrens Skade - Tunnel` Evaluates subsidence and inclination risks in buildings adjacent to tunnel excavations, leveraging the GIBV framework to predict settlements induced by tunneling activities in soft clay environments (developed through the REMEDY/Begrens Skade 2 research collaboration).
 
-Specifications
-==============
+### Specifications
 
 It is crucial to understand the limitations of the [REMEDY GIS RiskTool](https://github.com/norwegian-geotechnical-institute/REMEDY_GIS_RiskTool) calculation methods. I would highly suggest reading the paper and the manual within the REMEDY repository.
 
@@ -44,3 +47,41 @@ If you want to enable `vulnerability analysis` you will need some information on
 | D     | Wooden piles                                            | Masonry                          | Bad                    |
 | D     | Trepeler                                                | D - Murstein eller spesiell type | D - Dårlig             |
 | D     | D - På løsmasser - Punkt- og trefundamenter (banketter) | -                                | -                      |
+
+---
+
+Geovita group
+===
+
+---
+
+### `Create Atlas Coverage`
+
+This algorithm automates the creation of a coverage layer for use with the QGIS Atlas feature, which is ideal for generating multi-page "strip maps" along a route (like a road or tunnel).
+
+The tool takes a single line (e.g., a road centerline), your desired map scale, and your paper dimensions to generate two key output layers:
+
+1.  **`Atlas Points`**: A point layer where each point represents the center of a map sheet. This layer contains a crucial **`angle`** field, which is automatically calculated to ensure the "long axis" of your paper is aligned with the road.
+2.  **`Atlas Coverage Polygons`**: A polygon layer that shows the footprint (the exact rectangular coverage) of each map sheet. This is perfect for creating an index or key map.
+
+#### How to use the output:
+
+1.  In your QGIS Print Layout, open the **Atlas** panel.
+2.  Set the **Coverage layer** to the **`Atlas Points`** layer generated by this tool.
+3.  In your map item's **Item Properties**:
+    * Check **Controlled by atlas**.
+    * Set **Scale** to a **Fixed scale** (e.g., `1000` to match the tool input).
+    * Click the **Data-defined override** icon (ε) for **Rotation** and set it to the field `angle` (or `"angle" + 90` to make the road horizontal).
+
+#### Parameters:
+
+* **`Input Centerline`**: The line layer (e.g., road, rail, tunnel) to follow.
+* **`Map Scale`**: The denominator of your desired output scale (e.g., `1000` for 1:1000).
+* **`Paper Long Axis (Usable mm)`**: The *usable* length of your paper's long side (in mm). For A3 (420 mm) with 5mm margins, you would enter `410`. This side will be aligned with the road.
+* **`Paper Short Axis (Usable mm)`**: The *usable* length of your paper's short side (in mm). For A3 (297 mm) with 5mm margins, you would enter `287`.
+* **`Overlap (in meters)`**: The real-world distance you want each map sheet to overlap the previous one (e.g., `50`).
+
+#### Outputs:
+
+* **`Atlas Points`**: The point layer to use as your atlas coverage layer.
+* **`Atlas Coverage Polygons`**: The polygon footprints of each map, for use in an index map.