Learn R Programming

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

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.

Content

  1. Key features
  2. Some examples
  3. Install lidR
  4. Changelog

Key features

Some examples

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 capabilites.

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 (grid_canopy) or triangulation based (grid_tincanopy). 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
th = c(0,2,5,10,15)
edge = c(0, 1.5)
chm = grid_tincanopy(las, thresholds = th, max_edge = edge)

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.

ctg = catalog("<folder/>")
ctg@crs = sp::CRS("+proj=utm +zone=17")

# CRS set: will be displayed on an interactive map
plot(ctg)

From a LAScatalog object the user can (for example) extract some regions of interest (ROI) with lasclip or catalog_queries. Using a catalog for the extraction of the ROI guarantees fast and memory-efficient clipping. LAScatalog objects allow many other manipulations that are usually 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-reviwed papers. Our goal is to make published algorithms usable, testable and comparable.

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

lastrees(las, algorithm = "li2012")

col = random.colors(200)
plot(las, color = "treeID", colorPalette = col)

Other tools

lidR has many other tools and is a continuouly improved package. If it does not exist in lidR please ask us for a new feature, and depending on the feasability 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", dependencies=TRUE)
devtools::install_github("Jean-Romain/lidR", dependencies=TRUE)
  • The latest unstable development version from github with
devtools::install_github("Jean-Romain/rlas", dependencies=TRUE, ref="devel")
devtools::install_github("Jean-Romain/lidR", dependencies=TRUE, ref="devel")

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 R development package, usually called r-devel or r-base-dev

Changelog

See changelogs on NEW.md

Copy Link

Version

Install

install.packages('lidR')

Monthly Downloads

4,376

Version

1.5.1

License

GPL-3

Issues

Pull Requests

Stars

Forks

Maintainer

Jean-Romain Roussel

Last Published

June 14th, 2018

Functions in lidR (1.5.1)

grid_metrics

Rasterize the space and compute metrics for each cell
catalog_reshape

Reshape (retile) a catalog
lasclip

Clip LiDAR points
grid_metrics3d

Voxelize the space and compute metrics for each voxel
as.raster.lasmetrics

Transform a lasmetrics object into a spatial RasterLayer object
lasfiltersurfacepoints

Filter the surface points
extent,LAS-method

Extent
as.spatial

Transform a lidR object into sp object
lasfilters

Predefined filters
lasfilterdecimate

Thin LiDAR data
gap_fraction_profile

Gap fraction profile
entropy

Normalized Shannon diversity index
catalog_select

Select LAS files interactively
lassnags

Snag classification
lastrees

Individual tree segmentation
grid_canopy

Canopy surface model
lastrees_li2

Individual tree segmentation
lasfilter

Return points with matching conditions
grid_terrain

Digital Terrain Model
grid_tincanopy

Canopy height model based on a triangulation.
grid_catalog

Apply a grid function over a catalog
lasmetrics

Compute metrics for a cloud of points
lastrees_silva

Individual tree segmentation
lasflightline

Retrieve individual flightlines
lascolor

Compute the color from RGB fields
grid_hexametrics

Compute metrics for hexagonal cells
lasadddata

Add data into a las object
lasclassify

Classify LiDAR points from source data
lasscanline

Retrieve individual scanline
lassmooth

Smooth a point cloud
readLAS

Read .las or .laz files
rumple_index

Rumple index of roughness
lasnormalize

Subtract digital terrain model
lasground

Classify points as ground or not ground
lastrees_dalponte

Individual tree segmentation
lastrees_li

Individual tree segmentation (deprecated)
lidr_options

Options Settings for the lidR package
lidR-deprecated

Deprecated function(s) in the lidR package
laspulse

Retrieve individual pulses
writeLAS

Write a las or laz file
plot.lasmetrics

Plot an object of class lasmetrics in 2D
plot.LAS

Plot LiDAR data
plot.lashexametrics

Plot an object of class lashexametrics in 2D
plot.LAScatalog

Plot a LAScatalog object
lasroi

Select a region of interest interactively
summary.LAS

LiDAR data summary
lastrees_watershed

Individual tree segmentation
tree_detection

Tree top detection based on local maxima filters
lidrpalettes

Palettes
plot.lasmetrics3d

Plot voxelized LiDAR data
tree_metrics

Compute metrics for each tree
plot3d

Plot a wireframe of a RasterLayer or a lasmetrics object
set.colors

Automatic colorization
util_makeZhangParam

Parameters for progressive morphological filter
stdmetrics

Predefined standard metrics functions
VCI

Vertical Complexity Index
area

Surface covered by a LAS object or by a LAScatalog.
LASheader

Create a LASheader object
LAScatalog-class

An S4 class to represent a set of .las or .laz files
LAS

Create a LAS object
LAScluster-class

An S4 class to represent an arbitrary region in the catalog.
LAS-class

An S4 class to represent the data read in a .las or .laz file
LAD

Leaf area density
-,LAS,RasterLayer-method

Convenient operator to lasnormalize
LASheader-class

An S4 class to represent the header read in a .las or .laz file
catalog

Build a catalog of las tiles/files
as.lasmetrics

Set the class 'lasmetrics' to a data.frame or a data.table
catalog_queries

Extract LiDAR data based on a set of coordinates
as.list.LASheader

Transform to a list
catalog_index

Retrieve the files containing ROIs
catalog_apply

Apply a user-defined function to an entire catalog in a continuous way
catalog_options

grid_density

Map the pulse or point density