Learn R Programming

⚠️There's a newer version (4.1.2) of this package.Take me there.

lidR

R package for Airborne LiDAR Data Manipulation and Visualization for Forestry Applications

The lidR package provides functions to read and write .las and .laz files, plot point clouds, compute metrics using an area-based approach, compute digital canopy models, thin lidar data, manage a catalog of datasets, automatically extract ground inventories, process a set of tiles using multicore processing, individual tree segmentation, classify data from geographic data, and provides other tools to manipulate LiDAR data in a research and development context.

  • Development of the lidR package between 2015 and 2018 was made possible thanks to the financial support of the AWARE project (NSERC CRDPJ 462973-14); grantee Prof Nicholas Coops.
  • Development of the lidR package between 2018 and 2019 was made possible thanks to the financial support of the Ministère des Forêts, de la Faune et des Parcs of Québec.

:book: Read the Wiki pages to get started with the lidR package.

Key features

Read and display a las file

In R-fashion style the function plot, based on rgl, enables the user to display, rotate and zoom a point cloud. Because rgl has limited capabilities with respect to large datasets, we also made a package PointCloudViewer with greater display capabilities.

las <- readLAS("<file.las>")
plot(las)

Compute a canopy height model

lidR has several algorithms from the literature to compute canopy height models either point-to-raster based or triangulation based. This allows testing and comparison of some methods that rely on a CHM, such as individual tree segmentation or the computation of a canopy roughness index.

las <- readLAS("<file.las>")

# Khosravipour et al. pitfree algorithm
thr <- c(0,2,5,10,15)
edg <- c(0, 1.5)
chm <- grid_canopy(las, 1, pitfree(thr, edg))

plot(chm)

Read and display a catalog of las files

lidR enables the user to manage, use and process a catalog of las files. The function catalog builds a LAScatalog object from a folder. The function plot displays this catalog on an interactive map using the mapview package (if installed).

ctg <- catalog("<folder/>")
plot(ctg, map = TRUE)

From a LAScatalog object the user can (for example) extract some regions of interest (ROI) with lasclip. Using a catalog for the extraction of the ROI guarantees fast and memory-efficient clipping. LAScatalog objects allow many other manipulations that can be done with multicore processing, where possible.

Individual tree segmentation

The lastrees function has several algorithms from the literature for individual tree segmentation, based either on the digital canopy model or on the point-cloud. Each algorithm has been coded from the source article to be as close as possible to what was written in the peer-reviewed papers. Our goal is to make published algorithms usable, testable and comparable.

las <- readLAS("<file.las>")

las <- lastrees(las, li2012())
col <- random.colors(200)
plot(las, color = "treeID", colorPalette = col)

Wall-to-wall dataset processing

Most of the lidR functions can process seamlessly a set of tiles and return a continuous output. Users can create their own methods using the LAScatalog processing engine via the catalog_apply function. Among other features the engine takes advantage of point indexation with lax files, takes care of processing tiles with a buffer and allows for processing big files that do not fit in memory.

# Load a LAScatalog instead of a LAS file
ctg <- catalog("<path/to/folder/>")

# Process it like a LAS file
chm <- grid_canopy(ctg, 2, p2r())
col <- random.colors(50)
plot(chm, col = col)

Other tools

lidR has many other tools and is a continuously improved package. If it does not exist in lidR please ask us for a new feature, and depending on the feasibility we will be glad to implement your requested feature.

Install lidR

  • The latest released version from CRAN with
install.packages("lidR")
  • The latest stable development version from github with
devtools::install_github("Jean-Romain/rlas")
devtools::install_github("Jean-Romain/lidR")

To install the package from github make sure you have a working development environment.

  • Windows: Install Rtools.exe.
  • Mac: Install Xcode from the Mac App Store.
  • Linux: Install the following libraries:
sudo apt-get install libgdal-dev libgeos++-dev libudunits2-dev libproj-dev libx11-dev libgl-dev libglu-dev libfreetype6-dev libv8-3.14-dev libcairo2-dev 

Changelog

See changelogs on NEW.md

Copy Link

Version

Install

install.packages('lidR')

Monthly Downloads

4,374

Version

2.1.1

License

GPL-3

Issues

Pull Requests

Stars

Forks

Maintainer

Jean-Romain Roussel

Last Published

August 6th, 2019

Functions in lidR (2.1.1)

lasfilterduplicates

Filter duplicated points
lasground

Classify points as 'ground' or 'not ground'
readLAS

Read .las or .laz files
readLAScatalog

Create an object of class LAScatalog
rbind.LAS

Merge LAS objects
readLASheader

Read a .las or .laz file header
writeLAS

Write a .las or .laz file
grid_terrain

Digital Terrain Model
lascheck

Inspect a LAS object
lasclip

Clip LiDAR points
homogenize

Point Cloud Decimation Algorithm
LAD

Leaf area density
entropy

Normalized Shannon diversity index
dsmtin

Digital Surface Model Algorithm
VCI

Vertical Complexity Index
lidR-package

lidR: airborne LiDAR for forestry applications
LASheader

Create a LASheader object
lidR-parallelism

Parallel computation in lidR
tree_metrics

Compute metrics for each tree
lasdetectshape

Estimation of the shape of the points neighborhood
lasfilter

Return points with matching conditions
random

Point Cloud Decimation Algorithm
util_makeZhangParam

Parameters for progressive morphological filter
highest

Point Cloud Decimation Algorithm
stdmetrics

Predefined standard metrics functions
rOverlay

RasterLayer tools
tin

Spatial Interpolation Algorithm
pitfree

Digital Surface Model Algorithm
extent,LAS-method

Extent
grid_metrics3d

Voxelize the space and compute metrics for each voxel
LAS-class

An S4 class to represent a .las or .laz file
plot

Plot a LAS* object
gap_fraction_profile

Gap fraction profile
lastrees

Individual tree segmentation
plot.lasmetrics3d

Plot voxelized LiDAR data
set.colors

Automatic colorization
lasvoxelize

Voxelize a point cloud
is

A set of boolean tests on objects
p2r

Digital Surface Model Algorithm
set_lidr_threads

Set or get number of threads that lidR should use
tree_detection

Individual tree detection
knnidw

Spatial Interpolation Algorithm
LAScatalog-class

An S4 class to represent a catalog of .las or .laz files
LASheader-class

An S4 class to represent the header of .las or .laz files
plot_3d

Add a spatial object to a point cloud scene
lmfauto

Individual Tree Detection Algorithm
lassnags

Snag classification
lastransform

Datum transformation for LAS objects
manual

Individual Tree Detection Algorithm
tree_hulls

Compute the hull of each tree.
pmf

Ground Segmentation Algorithm
lidrpalettes

Palettes
csf

Ground Segmentation Algorithm
print

Summary and Print for LAS* objects
li2012

Individual Tree Segmentation Algorithm
lasmetrics

Compute metrics for a cloud of points
lasfilters

Predefined filters
watershed

Individual Tree Segmentation Algorithm
area

Surface covered by a LAS* object
as.list.LASheader

Transform to a list
kriging

Spatial Interpolation Algorithm
lasaddattribute

Add attributes into a LAS object
shape_detection

Algorithms for shape detection of the local point neighborhood
dalponte2016

Individual Tree Segmentation Algorithm
lasnormalize

Remove the topography from a point cloud
catalog_retile

Retile a LAScatalog
projection

Get or set the projection of a LAS* object
lassmooth

Smooth a point cloud
silva2016

Individual Tree Segmentation Algorithm
lmf

Individual Tree Detection Algorithm
lidR-LAScatalog-drivers

LAScatalog drivers
catalog_select

Select LAS files manually from a LAScatalog
lasmergespatial

Merge a point cloud with a source of spatial data
grid_hexametrics

Area-Based Approach in hexagonal cells.
lasfiltersurfacepoints

Filter the surface points
grid_metrics

Area-Based Approach
$<-,LAS-method

Inherited but modified methods from sp
wing2015

Snags Segmentation Algorithm
rumple_index

Rumple index of roughness
as.spatial

Transform a LAS* object into an sp object
catalog_apply

LAScatalog processing engine
catalog_options_tools

Get or set LAScatalog processing engine options
catalog_intersect

Subset a LAScatalog with a Spatial* object
lasfilterdecimate

Decimate a LAS object
laspulse

Retrieve individual pulses, flightlines or scanlines
grid_canopy

Digital Surface Model
grid_density

Map the pulse or point density