.TH v.in.pdal 1grass "" "GRASS 7.8.5" "GRASS GIS User's Manual"
.SH NAME
\fI\fBv.in.pdal\fR\fR  \- Converts LAS LiDAR point clouds to a GRASS vector map with PDAL.
.SH KEYWORDS
vector, import, LIDAR
.SH SYNOPSIS
\fBv.in.pdal\fR
.br
\fBv.in.pdal \-\-help\fR
.br
\fBv.in.pdal\fR [\-\fBwocrjkhm\fR] \fBinput\fR=\fIname\fR \fBoutput\fR=\fIname\fR  [\fBid_layer\fR=\fIstring\fR]   [\fBreturn_layer\fR=\fIstring\fR]   [\fBclass_layer\fR=\fIstring\fR]   [\fBrgb_layer\fR=\fIstring\fR]   [\fBspatial\fR=\fIxmin,ymin,xmax,ymax\fR]   [\fBzrange\fR=\fImin,max\fR]   [\fBreturn_filter\fR=\fIstring\fR]   [\fBclass_filter\fR=\fIinteger\fR[,\fIinteger\fR,...]]   [\fBinput_srs\fR=\fIstring\fR]   [\fBmax_ground_window_size\fR=\fIfloat\fR]   [\fBground_slope\fR=\fIfloat\fR]   [\fBmax_ground_distance\fR=\fIfloat\fR]   [\fBinitial_ground_distance\fR=\fIfloat\fR]   [\fBground_cell_size\fR=\fIfloat\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBhelp\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR]  [\-\-\fBui\fR]
.SS Flags:
.IP "\fB\-w\fR" 4m
.br
Reproject to location\(cqs coordinate system if needed
.br
Reprojects input dataset to the coordinate system of the GRASS location (by default only datasets with the matching cordinate system can be imported
.IP "\fB\-o\fR" 4m
.br
Override projection check (use current location\(cqs projection)
.br
Assume that the dataset has same projection as the current location
.IP "\fB\-c\fR" 4m
.br
Do not automatically add unique ID as category to each point
.br
Create only requested layers and categories
.IP "\fB\-r\fR" 4m
.br
Limit import to the current region
.IP "\fB\-j\fR" 4m
.br
Classify and extract ground points
.br
This assignes class 2 to the groud points
.IP "\fB\-k\fR" 4m
.br
Classify ground points
.IP "\fB\-h\fR" 4m
.br
Compute height for points as a difference from ground
.br
This requires points to have class 2
.IP "\fB\-m\fR" 4m
.br
Use approximate algorithm in ground filter
.IP "\fB\-\-overwrite\fR" 4m
.br
Allow output files to overwrite existing files
.IP "\fB\-\-help\fR" 4m
.br
Print usage summary
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.IP "\fB\-\-ui\fR" 4m
.br
Force launching GUI dialog
.SS Parameters:
.IP "\fBinput\fR=\fIname\fR \fB[required]\fR" 4m
.br
LAS input file
.br
LiDAR input files in LAS format (*.las or *.laz)
.IP "\fBoutput\fR=\fIname\fR \fB[required]\fR" 4m
.br
Name for output vector map
.IP "\fBid_layer\fR=\fIstring\fR" 4m
.br
Layer number to store generated point ID as category
.br
Set to 1 by default, use \-c to not store it
.IP "\fBreturn_layer\fR=\fIstring\fR" 4m
.br
Layer number to store return information as category
.br
Leave empty to not store it
.IP "\fBclass_layer\fR=\fIstring\fR" 4m
.br
Layer number to store class number as category
.br
Leave empty to not store it
.IP "\fBrgb_layer\fR=\fIstring\fR" 4m
.br
Layer number where RBG colors are stored as category
.br
Leave empty to not store it
.IP "\fBspatial\fR=\fIxmin,ymin,xmax,ymax\fR" 4m
.br
Import subregion only
.br
Format: xmin,ymin,xmax,ymax \- usually W,S,E,N
.IP "\fBzrange\fR=\fImin,max\fR" 4m
.br
Filter range for z data (min,max)
.IP "\fBreturn_filter\fR=\fIstring\fR" 4m
.br
Only import points of selected return type
.br
If not specified, all points are imported
.br
Options: \fIfirst, last, mid\fR
.IP "\fBclass_filter\fR=\fIinteger[,\fIinteger\fR,...]\fR" 4m
.br
Only import points of selected class(es)
.br
Input is comma separated integers. If not specified, all points are imported.
.IP "\fBinput_srs\fR=\fIstring\fR" 4m
.br
Input dataset projection (WKT or EPSG, e.g. EPSG:4326)
.br
Override input dataset coordinate system using EPSG code or WKT definition
.IP "\fBmax_ground_window_size\fR=\fIfloat\fR" 4m
.br
Maximum window size for ground filter
.br
Default: \fI33\fR
.IP "\fBground_slope\fR=\fIfloat\fR" 4m
.br
Slope for ground filter
.br
Default: \fI1.0\fR
.IP "\fBmax_ground_distance\fR=\fIfloat\fR" 4m
.br
Maximum distance for ground filter
.br
Default: \fI2.5\fR
.IP "\fBinitial_ground_distance\fR=\fIfloat\fR" 4m
.br
Initial distance for ground filter
.br
Default: \fI0.15\fR
.IP "\fBground_cell_size\fR=\fIfloat\fR" 4m
.br
Initial distance for ground filter
.br
Default: \fI1\fR
.SH DESCRIPTION
\fIv.in.pdal\fR supports the following PDAL filters:
.RS 4n
.IP \(bu 4n
groud detection with Point Cloud Library (PCL) Progressive Morphological Filter (Zhang 2003)
(filters.ground)
.IP \(bu 4n
filters.height
(requires PCL)
.RE
\fIv.in.pdal\fR supports the following filters natively:
.RS 4n
.IP \(bu 4n
2D region filter
.IP \(bu 4n
Z coordinates filter
.IP \(bu 4n
return filter
.IP \(bu 4n
class filter
.RE
.SH EXAMPLES
Import only XYZ coordinates of points, limit the import to the current
computational region and reproject to the Location projection during
the import:
.br
.nf
\fC
v.in.pdal input=points.las output=points \-c \-r \-w
\fR
.fi
.SH SEE ALSO
\fI
r.in.lidar,
r3.in.lidar,
g.region,
v.vect.stats
v.in.ogr,
\fR
.SH REFERENCES
.RS 4n
.IP \(bu 4n
V. Petras, A. Petrasova, J. Jeziorska, H. Mitasova (2016):
\fIProcessing UAV and lidar point clouds in GRASS GIS\fR.
XXIII ISPRS Congress 2016
[ISPRS Archives,
ResearchGate]
.IP \(bu 4n
Zhang, Keqi, et al.
\fIA progressive morphological filter for removing nonground
measurements from airborne LIDAR data.\fR
Geoscience and Remote Sensing,
IEEE Transactions on 41.4 (2003): 872\-882.
.RE
.SH AUTHOR
Vaclav Petras,
NCSU GeoForAll Lab
.SH SOURCE CODE
.PP
Available at: v.in.pdal source code (history)
.PP
Main index |
Vector index |
Topics index |
Keywords index |
Graphical index |
Full index
.PP
© 2003\-2020
GRASS Development Team,
GRASS GIS 7.8.5 Reference Manual