v.out.lidar.html 8.19 KB
Newer Older
xuebingbing's avatar
xuebingbing committed
1 2 3
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
xuebingbing's avatar
xuebingbing committed
4
<title>v.out.lidar - GRASS GIS manual</title>
xuebingbing's avatar
xuebingbing committed
5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">
<div id="container">

<a href="index.html"><img src="grass_logo.png" alt="GRASS logo"></a>
<hr class="header">

<h2>NAME</h2>
<em><b>v.out.lidar</b></em>  - Exports vector points as LAS point cloud<BR>
Converts LAS LiDAR point clouds to a GRASS vector map with libLAS
<h2>KEYWORDS</h2>
<a href="vector.html">vector</a>, <a href="topic_export.html">export</a>, <a href="keywords.html#output">output</a>, <a href="keywords.html#LIDAR">LIDAR</a>, <a href="keywords.html#points">points</a>
<h2>SYNOPSIS</h2>
<div id="name"><b>v.out.lidar</b><br></div>
<b>v.out.lidar --help</b><br>
<div id="synopsis"><b>v.out.lidar</b> [-<b>rw</b>] <b>input</b>=<em>name</em>  [<b>layer</b>=<em>string</em>]  <b>output</b>=<em>name</em>  [<b>cats</b>=<em>range</em>]   [<b>where</b>=<em>sql_query</em>]   [<b>id_layer</b>=<em>string</em>]   [<b>return_layer</b>=<em>string</em>]   [<b>class_layer</b>=<em>string</em>]   [<b>rgb_layer</b>=<em>string</em>]   [<b>return_column</b>=<em>name</em>]   [<b>n_returns_column</b>=<em>name</em>]   [<b>class_column</b>=<em>name</em>]   [<b>rgb_column</b>=<em>name</em>]   [<b>red_column</b>=<em>name</em>]   [<b>green_column</b>=<em>name</em>]   [<b>blue_column</b>=<em>name</em>]  <b>las_xyscale</b>=<em>float</em> <b>las_zscale</b>=<em>float</em>  [--<b>overwrite</b>]  [--<b>help</b>]  [--<b>verbose</b>]  [--<b>quiet</b>]  [--<b>ui</b>] 
</div>

<div id="flags">
<h3>Flags:</h3>
<dl>
<dt><b>-r</b></dt>
<dd>Limit export to the current region</dd>

<dt><b>-w</b></dt>
<dd>Ignore color table</dd>
<dd>Ignore color table even when set and not other options are present</dd>

<dt><b>--overwrite</b></dt>
<dd>Allow output files to overwrite existing files</dd>
<dt><b>--help</b></dt>
<dd>Print usage summary</dd>
<dt><b>--verbose</b></dt>
<dd>Verbose module output</dd>
<dt><b>--quiet</b></dt>
<dd>Quiet module output</dd>
<dt><b>--ui</b></dt>
<dd>Force launching GUI dialog</dd>
</dl>
</div>

<div id="parameters">
<h3>Parameters:</h3>
<dl>
<dt><b>input</b>=<em>name</em>&nbsp;<b>[required]</b></dt>
<dd>Name of input vector map</dd>
<dd>Or data source for direct OGR access</dd>

<dt><b>layer</b>=<em>string</em></dt>
<dd>Layer number or name ('-1' for all layers)</dd>
<dd>A single vector map can be connected to multiple database tables. This number determines which table to use. When used with direct OGR access this is the layer name.</dd>
<dd>Default: <em>-1</em></dd>

<dt><b>output</b>=<em>name</em>&nbsp;<b>[required]</b></dt>
<dd>Name for output file</dd>

<dt><b>cats</b>=<em>range</em></dt>
<dd>Category values</dd>
<dd>Example: 1,3,7-9,13</dd>

<dt><b>where</b>=<em>sql_query</em></dt>
<dd>WHERE conditions of SQL statement without 'where' keyword</dd>
<dd>Example: income &lt; 1000 and population &gt;= 10000</dd>

<dt><b>id_layer</b>=<em>string</em></dt>
<dd>Layer number to store generated point ID as category</dd>
<dd>Vector features can have category values in different layers. This number determines which layer to use. When used with direct OGR access this is the layer name.</dd>

<dt><b>return_layer</b>=<em>string</em></dt>
<dd>Layer number to store return number as category</dd>
<dd>Vector features can have category values in different layers. This number determines which layer to use. When used with direct OGR access this is the layer name.</dd>

<dt><b>class_layer</b>=<em>string</em></dt>
<dd>Layer number to store class number as category</dd>
<dd>Vector features can have category values in different layers. This number determines which layer to use. When used with direct OGR access this is the layer name.</dd>

<dt><b>rgb_layer</b>=<em>string</em></dt>
<dd>Layer number where RGB color is stored as category</dd>
<dd>Vector features can have category values in different layers. This number determines which layer to use. When used with direct OGR access this is the layer name.</dd>

<dt><b>return_column</b>=<em>name</em></dt>
<dd>Column with return number</dd>
<dd>Name of attribute column</dd>

<dt><b>n_returns_column</b>=<em>name</em></dt>
<dd>Column with return number</dd>
<dd>Name of attribute column</dd>

<dt><b>class_column</b>=<em>name</em></dt>
<dd>Column with return number</dd>
<dd>Name of attribute column</dd>

<dt><b>rgb_column</b>=<em>name</em></dt>
<dd>RGB color definition column</dd>
<dd>Color definition in R:G:B form</dd>

<dt><b>red_column</b>=<em>name</em></dt>
<dd>Column with red color</dd>
<dd>Name of attribute column</dd>

<dt><b>green_column</b>=<em>name</em></dt>
<dd>Column with green color</dd>
<dd>Name of attribute column</dd>

<dt><b>blue_column</b>=<em>name</em></dt>
<dd>Column with blue color</dd>
<dd>Name of attribute column</dd>

<dt><b>las_xyscale</b>=<em>float</em>&nbsp;<b>[required]</b></dt>
<dd>Internal scale to apply to X and Y values</dd>
<dd>This scale does not change the values itself but only how precisely they are stored, for example 0.01 will preserve two decimal places</dd>
<dd>Default: <em>0.01</em></dd>

<dt><b>las_zscale</b>=<em>float</em>&nbsp;<b>[required]</b></dt>
<dd>Internal scale to apply to z values</dd>
<dd>This scale does not change the values itself but only how precisely they are stored, for example 0.01 will preserve two decimal places</dd>
<dd>Default: <em>0.01</em></dd>

</dl>
</div>
<div class="toc">
<h4 class="toc">Table of contents</h4>
<ul class="toc">
    <li class="toc"><a href="#description" class="toc">DESCRIPTION</a></li>
    <li class="toc"><a href="#notes" class="toc">NOTES</a></li>
    <li class="toc"><a href="#example" class="toc">EXAMPLE</a></li>
    <li class="toc"><a href="#references" class="toc">REFERENCES</a></li>
    <li class="toc"><a href="#author" class="toc">AUTHOR</a></li>
</ul>
</div>
<h2><a name="description">DESCRIPTION</a></h2>

<em>v.out.lidar</em> converts GRASS vector map to a LiDAR point clouds
in LAS format using the <a href="http://www.liblas.org">libLAS</a> library.

<p>
The <b>-r</b> flag limits the export to the current computational region
extent (see <em><a href="g.region.html">g.region</a></em>).
The <b>where</b> option limits the export by attributes (applied only
when the columns are used for export).

<p>
LAS format stores the coordinates as integers rounding the decimal places.
Before that a scale is applied to preserve a certain number of decimal
places. This scale can be set using <b>las_xyscale</b> and <b>las_xscale</b>
options. For example, the scale value 0.01 will preserve two decimal
places while the value 1.0 will preserve none.


<h2><a name="notes">NOTES</a></h2>

The typical file extensions for the LAS format are .las and .laz (compressed).
The compressed LAS (.laz) format can be exported only if libLAS has been
compiled with <a href="http://www.laszip.org/">LASzip</a> support.
It is also good when libLAS was compiled with GDAL. This is needed when
working with projections.


<h2><a name="example">EXAMPLE</a></h2>

Generate fractal surface and export is as point in LAS format:

<div class="code"><pre>
g.region raster=elevation res=100
r.surf.fractal output=fractals
r.to.vect input=fractals output=fractals type=point -z
v.out.lidar input=fractals output=fractals.las
</pre></div>


<h2><a name="references">REFERENCES</a></h2>

xuebingbing's avatar
xuebingbing committed
179
<a href="https://www.asprs.org/committee-general/laser-las-file-format-exchange-activities.html">
xuebingbing's avatar
xuebingbing committed
180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202
ASPRS LAS format</a><br>
<a href="http://www.liblas.org/">LAS library</a> <br>


<h2><a name="author">AUTHOR</a></h2>

Vaclav Petras

<!--
<p>
<i>Last changed: $Date$</i>
--><h2>SOURCE CODE</h2>
<p>Available at: <a href="https://github.com/OSGeo/grass/tree/master/vector/v.out.lidar">v.out.lidar source code</a> (<a href="https://github.com/OSGeo/grass/commits/master/vector/v.out.lidar">history</a>)</p>
<hr class="header">
<p>
<a href="index.html">Main index</a> |
<a href="vector.html">Vector index</a> |
<a href="topics.html">Topics index</a> |
<a href="keywords.html">Keywords index</a> |
<a href="graphical_index.html">Graphical index</a> |
<a href="full_index.html">Full index</a>
</p>
<p>
xuebingbing's avatar
xuebingbing committed
203
&copy; 2003-2020
xuebingbing's avatar
xuebingbing committed
204
<a href="http://grass.osgeo.org">GRASS Development Team</a>,
xuebingbing's avatar
xuebingbing committed
205
GRASS GIS 7.8.5 Reference Manual
xuebingbing's avatar
xuebingbing committed
206 207 208 209 210
</p>

</div>
</body>
</html>