[GRASS-SVN] r69220 - in grass/branches/releasebranch_7_2: raster/r.in.lidar raster3d/r3.in.lidar scripts/v.what.vect vector/v.in.lidar vector/v.in.pdal vector/v.mkgrid vector/v.vect.stats

svn_grass at osgeo.org svn_grass at osgeo.org
Mon Aug 22 19:07:22 PDT 2016


Author: wenzeslaus
Date: 2016-08-22 19:07:22 -0700 (Mon, 22 Aug 2016)
New Revision: 69220

Added:
   grass/branches/releasebranch_7_2/vector/v.mkgrid/v_mkgrid.png
   grass/branches/releasebranch_7_2/vector/v.vect.stats/v_vect_stats.png
Modified:
   grass/branches/releasebranch_7_2/raster/r.in.lidar/r.in.lidar.html
   grass/branches/releasebranch_7_2/raster3d/r3.in.lidar/r3.in.lidar.html
   grass/branches/releasebranch_7_2/scripts/v.what.vect/v.what.vect.html
   grass/branches/releasebranch_7_2/vector/v.in.lidar/v.in.lidar.html
   grass/branches/releasebranch_7_2/vector/v.in.pdal/v.in.pdal.html
   grass/branches/releasebranch_7_2/vector/v.mkgrid/main.c
   grass/branches/releasebranch_7_2/vector/v.mkgrid/v.mkgrid.html
   grass/branches/releasebranch_7_2/vector/v.vect.stats/v.vect.stats.html
Log:
examples and manual improvements related lidar modules and v.what.vect (backport r69167, r69200, r69219)

Modified: grass/branches/releasebranch_7_2/raster/r.in.lidar/r.in.lidar.html
===================================================================
--- grass/branches/releasebranch_7_2/raster/r.in.lidar/r.in.lidar.html	2016-08-23 02:00:20 UTC (rev 69219)
+++ grass/branches/releasebranch_7_2/raster/r.in.lidar/r.in.lidar.html	2016-08-23 02:07:22 UTC (rev 69220)
@@ -573,7 +573,9 @@
 <a href="r.in.xyz.html">r.in.xyz</a>,
 <a href="r.mapcalc.html">r.mapcalc</a>,
 <a href="r.univar.html">r.univar</a>,
-<a href="v.in.lidar.html">v.in.lidar</a>
+<a href="v.in.lidar.html">v.in.lidar</a>,
+<a href="r3.in.lidar.html">r3.in.lidar</a>,
+<a href="v.vect.stats.html">v.vect.stats</a>
 <br>
 <a href="v.lidar.correction.html">v.lidar.correction</a>,
 <a href="v.lidar.edgedetection.html">v.lidar.edgedetection</a>,
@@ -611,6 +613,6 @@
 <a href="http://geospatial.ncsu.edu/osgeorel/">NCSU GeoForAll Lab</a>
 (base_raster option, documentation)
 <br>
-based on r.in.xyz by Hamish Bowman and Volker Wichmann<br>
+based on <em>r.in.xyz</em> by Hamish Bowman and Volker Wichmann<br>
 
 <p><i>Last changed: $Date$</i>

Modified: grass/branches/releasebranch_7_2/raster3d/r3.in.lidar/r3.in.lidar.html
===================================================================
--- grass/branches/releasebranch_7_2/raster3d/r3.in.lidar/r3.in.lidar.html	2016-08-23 02:00:20 UTC (rev 69219)
+++ grass/branches/releasebranch_7_2/raster3d/r3.in.lidar/r3.in.lidar.html	2016-08-23 02:07:22 UTC (rev 69220)
@@ -92,7 +92,26 @@
 <a href="g.region.html">g.region</a>
 </em>
 
+<h2>REFERENCES</h2>
 
+<ul>
+<li>
+V. Petras, A. Petrasova, J. Jeziorska, H. Mitasova (2016):
+<em>Processing UAV and lidar point clouds in GRASS GIS</em>.
+XXIII ISPRS Congress 2016
+[<a href="http://www.int-arch-photogramm-remote-sens-spatial-inf-sci.net/XLI-B7/945/2016/">ISPRS Archives</a>,
+<a href="https://www.researchgate.net/publication/304340172_Processing_UAV_and_lidar_point_clouds_in_GRASS_GIS">ResearchGate</a>]
+<li>
+<a href="http://www.asprs.org/Committee-General/LASer-LAS-File-Format-Exchange-Activities.html">
+ASPRS LAS format</a>
+<li>
+<a href="http://www.liblas.org/">LAS library</a>
+<li>
+<a href="http://test.liblas.org/doxygen/liblas_8h.htm">LAS library C API</a> documentation
+</ul>
+
 <h2>AUTHOR</h2>
 
-Vaclav Petras, <a href="http://geospatial.ncsu.edu/osgeorel/">NCSU OSGeoREL</a>
+Vaclav Petras, <a href="http://geospatial.ncsu.edu/osgeorel/">NCSU GeoForAll Lab</a>
+
+<p><i>Last changed: $Date$</i>

Modified: grass/branches/releasebranch_7_2/scripts/v.what.vect/v.what.vect.html
===================================================================
--- grass/branches/releasebranch_7_2/scripts/v.what.vect/v.what.vect.html	2016-08-23 02:00:20 UTC (rev 69219)
+++ grass/branches/releasebranch_7_2/scripts/v.what.vect/v.what.vect.html	2016-08-23 02:07:22 UTC (rev 69220)
@@ -62,7 +62,8 @@
 <a href="v.distance.html">v.distance</a>,
 <a href="v.rast.stats.html">v.rast.stats</a>,
 <a href="v.what.rast.html">v.what.rast</a>,
-<a href="v.what.rast3.html">v.what.rast3</a>
+<a href="v.what.rast3.html">v.what.rast3</a>,
+<a href="v.vect.stats.html">v.vect.stats</a>
 </em>
 
 

Modified: grass/branches/releasebranch_7_2/vector/v.in.lidar/v.in.lidar.html
===================================================================
--- grass/branches/releasebranch_7_2/vector/v.in.lidar/v.in.lidar.html	2016-08-23 02:00:20 UTC (rev 69219)
+++ grass/branches/releasebranch_7_2/vector/v.in.lidar/v.in.lidar.html	2016-08-23 02:07:22 UTC (rev 69220)
@@ -114,7 +114,16 @@
   v.in.lidar -tb input="Serpent Mound Model LAS Data.las" output=Serpent_Mound_Model_pts
 </pre></div>
 
+<h2>SEE ALSO</h2>
 
+<em>
+<a href="r.in.lidar.html">r.in.lidar</a>,
+<a href="r3.in.lidar.html">r3.in.lidar</a>,
+<a href="g.region.html">g.region</a>,
+<a href="v.vect.stats.html">v.vect.stats</a>,
+<a href="v.in.ogr.html">v.in.ogr</a>
+</em>
+
 <h2>REFERENCES</h2>
 
 <a href="http://www.asprs.org/Committee-General/LASer-LAS-File-Format-Exchange-Activities.html">
@@ -122,11 +131,14 @@
 <a href="http://www.liblas.org/">LAS library</a> <br>
 <a href="http://test.liblas.org/doxygen/liblas_8h.htm">LAS library C API</a> documentation
 
-
 <h2>AUTHOR</h2>
 
 Markus Metz
 <br>
-based on v.in.ogr
+Vaclav Petras,
+<a href="http://geospatial.ncsu.edu/osgeorel/">NCSU GeoForAll Lab</a>
+(decimation, cats, areas, zrange)
+<br>
+based on <em>v.in.ogr</em> by various authors
 
 <p><i>Last changed: $Date$</i>

Modified: grass/branches/releasebranch_7_2/vector/v.in.pdal/v.in.pdal.html
===================================================================
--- grass/branches/releasebranch_7_2/vector/v.in.pdal/v.in.pdal.html	2016-08-23 02:00:20 UTC (rev 69219)
+++ grass/branches/releasebranch_7_2/vector/v.in.pdal/v.in.pdal.html	2016-08-23 02:07:22 UTC (rev 69220)
@@ -27,13 +27,35 @@
 v.in.pdal input=points.las output=points -c -r -w
 </pre></div>
 
+<h2>SEE ALSO</h2>
 
+<em>
+<a href="r.in.lidar.html">r.in.lidar</a>,
+<a href="r3.in.lidar.html">r3.in.lidar</a>,
+<a href="g.region.html">g.region</a>,
+<a href="v.vect.stats.html">v.vect.stats</a>
+<a href="v.in.ogr.html">v.in.ogr</a>,
+</em>
+
 <h2>REFERENCES</h2>
 
 <ul>
+<li>
+    V. Petras, A. Petrasova, J. Jeziorska, H. Mitasova (2016):
+    <em>Processing UAV and lidar point clouds in GRASS GIS</em>.
+    XXIII ISPRS Congress 2016
+    [<a href="http://www.int-arch-photogramm-remote-sens-spatial-inf-sci.net/XLI-B7/945/2016/">ISPRS Archives</a>,
+    <a href="https://www.researchgate.net/publication/304340172_Processing_UAV_and_lidar_point_clouds_in_GRASS_GIS">ResearchGate</a>]
 <li>Zhang, Keqi, et al.
     <em>A progressive morphological filter for removing nonground
     measurements from airborne LIDAR data.</em>
     Geoscience and Remote Sensing,
     IEEE Transactions on 41.4 (2003): 872-882.
 </ul>
+
+<h2>AUTHOR</h2>
+
+Vaclav Petras,
+<a href="http://geospatial.ncsu.edu/osgeorel/">NCSU GeoForAll Lab</a>
+
+<p><i>Last changed: $Date$</i>

Modified: grass/branches/releasebranch_7_2/vector/v.mkgrid/main.c
===================================================================
--- grass/branches/releasebranch_7_2/vector/v.mkgrid/main.c	2016-08-23 02:00:20 UTC (rev 69219)
+++ grass/branches/releasebranch_7_2/vector/v.mkgrid/main.c	2016-08-23 02:07:22 UTC (rev 69220)
@@ -71,6 +71,7 @@
     G_add_keyword(_("geometry"));
     G_add_keyword(_("grid"));
     G_add_keyword(_("point pattern"));
+    G_add_keyword(_("hexagon"));
     module->description = _("Creates a vector map of a user-defined grid.");
 
     vectname = G_define_standard_option(G_OPT_V_OUTPUT);

Modified: grass/branches/releasebranch_7_2/vector/v.mkgrid/v.mkgrid.html
===================================================================
--- grass/branches/releasebranch_7_2/vector/v.mkgrid/v.mkgrid.html	2016-08-23 02:00:20 UTC (rev 69219)
+++ grass/branches/releasebranch_7_2/vector/v.mkgrid/v.mkgrid.html	2016-08-23 02:07:22 UTC (rev 69220)
@@ -129,12 +129,59 @@
 Hexagon map
 </center>
 
+<h3>Using hexagons for point density</h3>
+
+To compute point density in a hexagonal grid for the vector map
+<em>points_of_interest</em> in the basic North Carolina sample dataset,
+the vector map itself is used to set extent of the computational region.
+The resolution is based on the desired size of hexagons.
+
+<div class="code"><pre>
+g.region vector=points_of_interest res=2000 -pa
+</pre></div>
+
+The hexagonal grid is created as a vector map based on the previously
+selected extent and size of the grid.
+
+<div class="code"><pre>
+v.mkgrid map=hexagons -h
+</pre></div>
+
+The following counts the number of points per hexagon using the
+<em><a href="v.vect.stats.html">v.vect.stats</a></em> module.
+
+<div class="code"><pre>
+v.vect.stats points=points_of_interest areas=hexagons count_column=count
+</pre></div>
+
+User should note that some of the points may be outside the grid
+since the hexagons cannot cover all the area around the edges
+(the computational region extent needs to be enlarged if all points
+should be considered).
+The last command sets the vector map color table to <tt>viridis</tt>
+based on the <tt>count</tt> column.
+
+<div class="code"><pre>
+v.colors map=hexagons use=attr column=count color=viridis
+</pre></div>
+
+<!--
+d.erase 77:77:77
+mogrify -trim .png
+-->
+
+<center>
+<img src="v_mkgrid.png"><br>
+Point density in a hexagonal grid
+</center>
+
 <h2>SEE ALSO</h2>
 
 <em>
 <a href="d.grid.html">d.grid</a>,
 <a href="v.in.region.html">v.in.region</a>,
-<a href="v.patch.html">v.patch</a>
+<a href="v.patch.html">v.patch</a>,
+<a href="v.vect.stats.html">v.vect.stats</a>
 </em>
 
 <h2>AUTHORS</h2>

Copied: grass/branches/releasebranch_7_2/vector/v.mkgrid/v_mkgrid.png (from rev 69167, grass/trunk/vector/v.mkgrid/v_mkgrid.png)
===================================================================
(Binary files differ)

Modified: grass/branches/releasebranch_7_2/vector/v.vect.stats/v.vect.stats.html
===================================================================
--- grass/branches/releasebranch_7_2/vector/v.vect.stats/v.vect.stats.html	2016-08-23 02:00:20 UTC (rev 69219)
+++ grass/branches/releasebranch_7_2/vector/v.vect.stats/v.vect.stats.html	2016-08-23 02:07:22 UTC (rev 69220)
@@ -145,14 +145,100 @@
 v.db.select myzipcodes_wake column=ZIPCODE_,ZIPNAME,avg_elev
 </pre></div>
 
+<h3>Point statistics in a hexagonal grid</h3>
 
+The grid extent and size is influenced by the current computational
+region. The extent is based on the vector map
+<em>points_of_interest</em> from the basic North Carolina sample dataset.
+
+<div class="code"><pre>
+g.region vector=points_of_interest res=2000 -pa
+</pre></div>
+
+The hexagonal grid is created using
+the <em><a href="v.mkgrid.html">v.mkgrid</a></em> module
+as a vector map based on the previously
+selected extent and size of the grid.
+
+<div class="code"><pre>
+v.mkgrid map=hexagons -h
+</pre></div>
+
+The <em>v.vect.stats</em> module
+counts the number of points and does one statistics on a selected
+column (here: <em>elev_m</em>).
+
+<div class="code"><pre>
+v.vect.stats points=points_of_interest areas=hexagons method=average \
+  points_column=elev_m count_column=count stats_column=average
+</pre></div>
+
+User should note that some of the points may be outside the grid
+since the hexagons cannot cover all the area around the edges
+(the computational region extent needs to be enlarged if all points
+should be considered).
+The last command sets the vector map color table to <tt>viridis</tt>
+based on the <tt>count</tt> column.
+
+<div class="code"><pre>
+v.colors map=hexagons use=attr column=average color=viridis
+</pre></div>
+
+<!--
+v.vect.stats points=points_of_interest areas=hexagons method=average \
+  points_column=elev_m count_column=count stats_column=average
+v.vect.stats points=points_of_interest areas=hexagons method=range \
+  points_column=elev_m count_column=count stats_column=range
+v.vect.stats points=points_of_interest areas=hexagons method=stddev \
+  points_column=elev_m count_column=count stats_column=stddev
+
+export GRASS_FONT=LiberationSans-Regular
+
+FILE=v_vect_stats.png
+
+rm $FILE
+
+d.mon cairo out=$FILE
+
+d.frame frame=f1 at=50,100,0,50 -c
+v.colors map=hexagons use=attr column=range color=viridis
+d.vect map=points_of_interest color=black fill_color=black width=1 icon=basic/point size=3
+d.text text="points" at=60,5 size=10 color=black
+
+d.frame frame=f2 at=50,100,50,100 -c
+v.colors map=hexagons use=attr column=count color=viridis
+d.vect map=hexagons where="count > 0"
+d.text text="count" at=60,5 size=10 color=black
+
+d.frame frame=f3 at=0,50,0,50 -c
+v.colors map=hexagons use=attr column=average color=viridis
+d.vect map=hexagons where="count > 0"
+d.text text="average" at=60,5 size=10 color=black
+
+d.frame frame=f4 at=0,50,50,100 -c
+v.colors map=hexagons use=attr column=stddev color=viridis
+d.vect map=hexagons where="count > 0"
+d.text text="stddev" at=60,5 size=10 color=black
+
+d.mon stop=cairo
+mogrify -trim $FILE
+-->
+
+<center>
+<img src="v_vect_stats.png"><br>
+Point statistics in a hexagonal grid (count of points, average of values
+associated with point, standard deviation)
+</center>
+
+
 <h2>SEE ALSO</h2>
 
 <em>
 <a href="v.distance.html">v.distance</a>,
 <a href="r.distance.html">r.distance</a>,
 <a href="v.rast.stats.html">v.rast.stats</a>,
-<a href="v.what.vect.html">v.what.vect</a>
+<a href="v.what.vect.html">v.what.vect</a>,
+<a href="v.mkgrid.html">v.mkgrid</a>
 </em>
 
 

Copied: grass/branches/releasebranch_7_2/vector/v.vect.stats/v_vect_stats.png (from rev 69167, grass/trunk/vector/v.vect.stats/v_vect_stats.png)
===================================================================
(Binary files differ)



More information about the grass-commit mailing list