From 0ab46d1d47b3e7c0515b9c91d15d4e701440d941 Mon Sep 17 00:00:00 2001
From: jfbourdon <jean.francois.bourdon@gmail.com>
Date: Fri, 16 Jul 2021 17:04:54 -0400
Subject: [PATCH 1/3] vector overlap limitation

---
 scripts/v.rast.stats/v.rast.stats.html | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/scripts/v.rast.stats/v.rast.stats.html b/scripts/v.rast.stats/v.rast.stats.html
index 835ebda0c98..e86e10dacd5 100644
--- a/scripts/v.rast.stats/v.rast.stats.html
+++ b/scripts/v.rast.stats/v.rast.stats.html
@@ -31,6 +31,8 @@ <h2>NOTES</h2>
 will be chopped off.
 <p>If a MASK is present, it will be restored after the script finished.
 The script changes temporarily to the resolution of the given raster map.
+<p>If some vectors overlap, only one category will be kept during the
+rasterization process. Statistics for these vectors will thus be partial.
 <p><!-- r.univar limitation -->
 Large amounts of system memory can be used when extended statistics
 (<em>first_quartile,median,third_quartile,percentile </em>) are being requested

From a56ad0928dae51feed96240b0168141850b237cf Mon Sep 17 00:00:00 2001
From: Markus Metz <33666869+metzm@users.noreply.github.com>
Date: Wed, 12 Jan 2022 14:05:07 +0100
Subject: [PATCH 2/3] v.rast.stats: use topological terminology in manual

---
 scripts/v.rast.stats/v.rast.stats.html | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/scripts/v.rast.stats/v.rast.stats.html b/scripts/v.rast.stats/v.rast.stats.html
index e86e10dacd5..08ed2843a1c 100644
--- a/scripts/v.rast.stats/v.rast.stats.html
+++ b/scripts/v.rast.stats/v.rast.stats.html
@@ -31,8 +31,10 @@ <h2>NOTES</h2>
 will be chopped off.
 <p>If a MASK is present, it will be restored after the script finished.
 The script changes temporarily to the resolution of the given raster map.
-<p>If some vectors overlap, only one category will be kept during the
-rasterization process. Statistics for these vectors will thus be partial.
+<p>If an area has several categories in the selected layer (equivalent
+to overlapping polygons in Simple Features), only one category will be
+kept during the rasterization process. Statistics for the skipped
+categories will thus be partial.
 <p><!-- r.univar limitation -->
 Large amounts of system memory can be used when extended statistics
 (<em>first_quartile,median,third_quartile,percentile </em>) are being requested

From 4a7ba151aafe916911c6e740241d9e7f5998c67e Mon Sep 17 00:00:00 2001
From: Markus Metz <33666869+metzm@users.noreply.github.com>
Date: Thu, 13 Jan 2022 11:01:59 +0100
Subject: [PATCH 3/3] v.rast.stats: example for areas with multiple cats

---
 scripts/v.rast.stats/v.rast.stats.html | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/scripts/v.rast.stats/v.rast.stats.html b/scripts/v.rast.stats/v.rast.stats.html
index 08ed2843a1c..641e58e4143 100644
--- a/scripts/v.rast.stats/v.rast.stats.html
+++ b/scripts/v.rast.stats/v.rast.stats.html
@@ -35,6 +35,12 @@ <h2>NOTES</h2>
 to overlapping polygons in Simple Features), only one category will be
 kept during the rasterization process. Statistics for the skipped
 categories will thus be partial.
+<p>
+For example, if there are three areas: area 1 with cat 1, area 2 with
+cat 2, area 3 with cats 1, 2. Only one category value of area 3 will be
+used for rasterization, the other category value will be skipped. Thus
+statistics for the used category value will be complete, while
+statistics for the skipped category value will be incomplete.
 <p><!-- r.univar limitation -->
 Large amounts of system memory can be used when extended statistics
 (<em>first_quartile,median,third_quartile,percentile </em>) are being requested