NAME

       v.in.pdal  - Converts LAS LiDAR point clouds to a GRASS vector map with PDAL.

KEYWORDS

       vector, import, LIDAR

SYNOPSIS

       v.in.pdal
       v.in.pdal --help
       v.in.pdal     [-wocrjkhm]     input=name     output=name     [id_layer=string]      [return_layer=string]
       [class_layer=string]       [rgb_layer=string]       [spatial=xmin,ymin,xmax,ymax]        [zrange=min,max]
       [return_filter=string]               [class_filter=integer[,integer,...]]              [input_srs=string]
       [max_ground_window_size=float]              [ground_slope=float]              [max_ground_distance=float]
       [initial_ground_distance=float]     [ground_cell_size=float]     [--overwrite]    [--help]    [--verbose]
       [--quiet]  [--ui]

   Flags:
       -w
           Reproject to location’s coordinate system if needed
           Reprojects input dataset to the coordinate system of the GRASS location  (by  default  only  datasets
           with the matching cordinate system can be imported

       -o
           Override projection check (use current location’s projection)
           Assume that the dataset has same projection as the current location

       -c
           Do not automatically add unique ID as category to each point
           Create only requested layers and categories

       -r
           Limit import to the current region

       -j
           Classify and extract ground points
           This assignes class 2 to the groud points

       -k
           Classify ground points

       -h
           Compute height for points as a difference from ground
           This requires points to have class 2

       -m
           Use approximate algorithm in ground filter

       --overwrite
           Allow output files to overwrite existing files

       --help
           Print usage summary

       --verbose
           Verbose module output

       --quiet
           Quiet module output

       --ui
           Force launching GUI dialog

   Parameters:
       input=name [required]
           LAS input file
           LiDAR input files in LAS format (*.las or *.laz)

       output=name [required]
           Name for output vector map

       id_layer=string
           Layer number to store generated point ID as category
           Set to 1 by default, use -c to not store it

       return_layer=string
           Layer number to store return information as category
           Leave empty to not store it

       class_layer=string
           Layer number to store class number as category
           Leave empty to not store it

       rgb_layer=string
           Layer number where RBG colors are stored as category
           Leave empty to not store it

       spatial=xmin,ymin,xmax,ymax
           Import subregion only
           Format: xmin,ymin,xmax,ymax - usually W,S,E,N

       zrange=min,max
           Filter range for z data (min,max)

       return_filter=string
           Only import points of selected return type
           If not specified, all points are imported
           Options: first, last, mid

       class_filter=integer[,integer,...]
           Only import points of selected class(es)
           Input is comma separated integers. If not specified, all points are imported.

       input_srs=string
           Input dataset projection (WKT or EPSG, e.g. EPSG:4326)
           Override input dataset coordinate system using EPSG code or WKT definition

       max_ground_window_size=float
           Maximum window size for ground filter
           Default: 33

       ground_slope=float
           Slope for ground filter
           Default: 1.0

       max_ground_distance=float
           Maximum distance for ground filter
           Default: 2.5

       initial_ground_distance=float
           Initial distance for ground filter
           Default: 0.15

       ground_cell_size=float
           Initial distance for ground filter
           Default: 1

DESCRIPTION

       v.in.pdal supports the following PDAL filters:

           •   groud  detection  with  Point  Cloud  Library (PCL) Progressive Morphological Filter (Zhang 2003)
               (filters.ground)

           •   filters.height (requires PCL)
       v.in.pdal supports the following filters natively:

           •   2D region filter

           •   Z coordinates filter

           •   return filter

           •   class filter

EXAMPLES

       Import only XYZ coordinates of points, limit the import to the current computational region and reproject
       to the Location projection during the import:
       v.in.pdal input=points.las output=points -c -r -w

SEE ALSO

        r.in.lidar, r3.in.lidar, g.region, v.vect.stats v.in.ogr,

REFERENCES

           •   V.  Petras, A. Petrasova, J. Jeziorska, H. Mitasova (2016): Processing UAV and lidar point clouds
               in GRASS GIS.  XXIII ISPRS Congress 2016 [ISPRS Archives, ResearchGate]

           •   Zhang, Keqi, et al.  A progressive morphological filter for removing nonground measurements  from
               airborne LIDAR data.  Geoscience and Remote Sensing, IEEE Transactions on 41.4 (2003): 872-882.

AUTHOR

       Vaclav Petras, NCSU GeoForAll Lab

SOURCE CODE

       Available at: v.in.pdal source code (history)

       Main index | Vector index | Topics index | Keywords index | Graphical index | Full index

       © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual