r.in.vect: new heatmap (count overlapping features) added

Author: ecodiv

src/raster/r.in.vect/r.in.vect.html

@@ -24,20 +24,28 @@ <h2>DESCRIPTION</h2>
 used as raster values in the output raster map.
 
 <p>
-Optionally, only features selected with the <b>where</b> option can be
-imported.
+Setting the <b>-c</b> flag counts the number of overlapping features per pixel
+and assigns that count as the raster value, effectively creating a heatmap.
+
+<p>
+Optionally, only features selected with the <b>where</b> or <b>sql</b> option
+can be imported.
 
 <h2>Notes</h2>
 
 By default, <em>r.in.vect</em> will only affect data in areas lying
 inside the boundaries of the current computational region. Before
 running the function, users should therefore ensure that the
 computational region is correctly set, and that the region's resolution
-is at the desired level. Alternatively, users can use the <b>-v</b>
-flag to set the exent of the raster layer to that of the vector layer.
-To ensure that the resulting raster map cleanly aligns with the
-computational region, the extent may be slightly larger than that of
-the vector layer.
+is at the desired level.
+
+<p>
+Alternatively, use the <b>-v</b> flag to import the entire vector extent,
+ignoring the current region boundaries. By default, this produces a full-map
+raster without modifying the current computational region. To update the region
+to match the imported raster, include the <b>-r</b> flag. This extends the
+region bounds to encompass the new layer while ensuring the grid remains aligned
+with the existing resolution.
 
 <p>
 If the coordinate reference system (CRS) of the vector file differs
@@ -117,13 +125,14 @@ <h3>Example 2</h3>
 r.in.vect input=geology.gpkg \
 output=geology_rast2 \
 attribute_column=GEOL250_ \
-rat_column=GEO_NAME
+label_column=GEO_NAME
 memory=2000
 
 # Assign random colors
 r.colors map=geology_rast2 color=random
 </pre></div>
 
+<p>
 <div align="left" style="margin: 10px"> <a href="r_in_vect_im02.png">
 <img src="r_in_vect_im02.png" alt="The geology vector file converted
 to, and imported as raster in GRASS GIS. Example 2" border="0">
@@ -157,6 +166,7 @@ <h3>Example 3</h3>
 memory=2000
 </pre></div>
 
+<p>
 <div align="left" style="margin: 10px"> <a href="r_in_vect_im03.png">
 <img src="r_in_vect_im03.png" alt="The busroute6 vector file converted
 to raster and imported into GRASS GIS. Example 3" border="0">
@@ -178,6 +188,7 @@ <h3>Example 4</h3>
 memory=2000
 </pre></div>
 
+<p>
 <div align="left" style="margin: 10px"> <a href="r_in_vect_im04.png">
 <img src="r_in_vect_im04.png" alt="The busroute6 vector file converted
 to raster and imported into GRASS GIS. Example 4" border="0">
@@ -194,6 +205,9 @@ <h2>SEE ALSO</h2>
 
 <h2>AUTHORS</h2>
 
-Paulo van Breugel (<a href="https://ecodiv.earth">ecodiv.earth</a>)<br>
-Applied Geo-information Sciences<br> <a href="https://www.has.nl/">HAS
-green academy, University of Applied Sciences</a><br>
+Paulo van Breugel  |  <a href="https://has.nl">HAS green academy</a>,
+University of Applied Sciences  |  <a
+href="https://www.has.nl/en/research/professorships/climate-robust-landscapes-professorship/">Climate-robust
+Landscapes research group</a>  |
+<a href="https://www.has.nl/en/research/professorships/innovative-bio-monitoring-professorship/">Innovative Bio-Monitoring research group</a>  |
+Contact: <a href="https://ecodiv.earth">Ecodiv.earth</a>

src/raster/r.in.vect/r.in.vect.md

@@ -14,43 +14,49 @@ intermediate geoTIF file (using
 [gdal.rasterize](https://gdal.org/api/python/utilities.html#osgeo.gdal.Rasterize))
 and imports it into GRASS GIS.
 
-The objects in the vector map will be assigned an user-defined value
-using the **value** parameter. Alternatively, the user can use the
-**attribute\_column** to specify the name of an existing column from the
-vector map's attribute table. The values in that column will be used as
-raster values in the output raster map.
+The objects in the vector map will be assigned an user-defined value using the
+**value** parameter. Alternatively, the user can use the **attribute_column** to
+specify the name of an existing column from the vector map's attribute table.
+The values in that column will be used as raster values in the output raster
+map.
 
-Optionally, the only features selected with the **where** option can be
+Setting the **-c** flag counts the number of overlapping features per pixel and
+assigns that count as the raster value, effectively creating a heatmap.
+
+Optionally, only features selected with the **where** or **sql** option can be
 imported.
 
 ## Notes
 
 By default, *r.in.vect* will only affect data in areas lying inside the
-boundaries of the current computational region. Before running the
-function, users should therefore ensure that the computational region is
-correctly set, and that the region's resolution is at the desired level.
-Alternatively, users can use the **-v** flag to set the exent of the
-raster layer to that of the vector layer. To ensure that the resulting
-raster map cleanly aligns with the computational region, the extent may
-be slightly larger than that of the vector layer.
-
-If the coordinate reference system (CRS) of the vector file differs from
-that of the mapset in which users want to import the raster, the vector
-file will be first reprojected using *ogr2ogr*.
-
-The **label\_column** parameter can be used to assign raster category
-labels. Users should check if each unique value from the category column
-has one corresponding label in the label column. If there are categories
-with more than one label, the first from the label column will be used
-(and a warning will be printed).
-
-With the **-d** flag, all pixels touched by lines or polygons will be
-updated, not just those on the line render path, or which center point
-is within the polygon. For lines, this is similar to setting the **-d**
-flag in *v.to.rast*.
-
-For simple and small vector layers, it is probably faster to
-import the vector layer first and converting it to a raster in GRASS.
+boundaries of the current computational region. Before running the function,
+users should therefore ensure that the computational region is correctly set,
+and that the region's resolution is at the desired level.
+
+Alternatively, use the **-v** flag to import the entire vector extent, ignoring
+the current region boundaries. By default, this produces a full-map raster
+without modifying the current computational region. To update the region to
+match the imported raster, include the **-r** flag. This extends the region
+bounds to encompass the new layer while ensuring the grid remains aligned with
+the existing resolution.
+
+If the coordinate reference system (CRS) of the vector file differs from that of
+the mapset in which users want to import the raster, the vector file will be
+first reprojected using *ogr2ogr*.
+
+The **label_column** parameter can be used to assign raster category labels.
+Users should check if each unique value from the category column has one
+corresponding label in the label column. If there are categories with more than
+one label, the first from the label column will be used (and a warning will be
+printed).
+
+With the **-d** flag, all pixels touched by lines or polygons will be updated,
+not just those on the line render path, or which center point is within the
+polygon. For lines, this is similar to setting the **-d** flag in *v.to.rast*.
+
+For simple and small vector layers, it is probably faster to import the vector
+layer first and converting it to a raster in GRASS.
+
 
 ## EXAMPLE
 
@@ -101,7 +107,7 @@ values.
 r.in.vect input=geology.gpkg \
 output=geology_rast2 \
 attribute_column=GEOL250_ \
-rat_column=GEO_NAME
+label_column=GEO_NAME
 memory=2000
 
 # Assign random colors
@@ -166,7 +172,10 @@ gaps or lines that consist of cells that are only diagonally connected.*
 
 ## AUTHORS
 
-Paulo van Breugel ([ecodiv.earth](https://ecodiv.earth))
-Applied Geo-information Sciences
-[HAS green academy, University of Applied
-Sciences](https://www.has.nl/)
+Paulo van Breugel | [HAS green academy](https://has.nl), University of
+Applied Sciences | [Climate-robust Landscapes research
+group](https://www.has.nl/en/research/professorships/climate-robust-landscapes-professorship/)
+| [Innovative Bio-Monitoring research
+group](https://www.has.nl/en/research/professorships/innovative-bio-monitoring-professorship/)
+| Contact: [Ecodiv.earth](https://ecodiv.earth)
+