README.md 2.4 KB
Newer Older
Monnet Jean-Matthieu's avatar
Monnet Jean-Matthieu committed
1
2
# Overview

Monnet Jean-Matthieu's avatar
Monnet Jean-Matthieu committed
3
`lidaRtRee` is an `R` package that provides functions for **forest analysis using airborne laser scanning** (LiDAR remote sensing) data: tree detection / segmentation and area-based approach. It includes complementary steps for forest mapping: extraction of both physical (gaps, edges, trees) and statistical features from LiDAR data, model calibration with ground reference, and maps export. 
Monnet Jean-Matthieu's avatar
Monnet Jean-Matthieu committed
4
5
6

# Installation

Monnet Jean-Matthieu's avatar
Monnet Jean-Matthieu committed
7
* `R` >= 4.0.3 recommended, package `lidR` >= 4.0.0 required
8
* **The package is available on [CRAN](https://cran.r-project.org/package=lidaRtRee)**, to install run in the `R` console `install.packages("lidaRtRee")`
Monnet Jean-Matthieu's avatar
Monnet Jean-Matthieu committed
9
* **build development version from source** with the `devtools` package by running in an `R` console: `devtools::install_git("https://gitlab.irstea.fr/jean-matthieu.monnet/lidaRtRee/", branch="dev")`
Monnet Jean-Matthieu's avatar
Monnet Jean-Matthieu committed
10
11
12

# Tutorials

Monnet Jean-Matthieu's avatar
Monnet Jean-Matthieu committed
13
**Tutorials** using `lidaRtRee` functions are available on the [lidaRtRee_tutorials](https://gitlab.irstea.fr/jean-matthieu.monnet/lidartree_tutorials/) repository, as `Rmarkdown` files and `html` files, and including datasets to run the code. The [wiki](https://gitlab.irstea.fr/jean-matthieu.monnet/lidartree_tutorials/-/wikis/home) presents the different tutorials:
Monnet Jean-Matthieu's avatar
Monnet Jean-Matthieu committed
14

Monnet Jean-Matthieu's avatar
Monnet Jean-Matthieu committed
15
* [ALS data pre-processing](https://gitlab.irstea.fr/jean-matthieu.monnet/lidartree_tutorials/-/wikis/ALS-data-preprocessing)
Monnet Jean-Matthieu's avatar
Monnet Jean-Matthieu committed
16
17
18
19
20
* [Tree detection](https://gitlab.irstea.fr/jean-matthieu.monnet/lidartree_tutorials/-/wikis/Tree-segmentation)
* [Forest field plot coregistration with ALS data](https://gitlab.irstea.fr/jean-matthieu.monnet/lidartree_tutorials/-/wikis/Field-plot-coregistration-with-ALS-data)
* [Forest gaps and edges detection](https://gitlab.irstea.fr/jean-matthieu.monnet/lidartree_tutorials/-/wikis/Forest-gaps-and-edges-detection)
* [Forest structure metrics computation and mapping](https://gitlab.irstea.fr/jean-matthieu.monnet/lidartree_tutorials/-/wikis/Forest-structure-metrics-mapping)
* [Area-based approach for forest parameters estimation](https://gitlab.irstea.fr/jean-matthieu.monnet/lidartree_tutorials/-/wikis/Area-based-approach)
21
22
23

# Changelog

Monnet Jean-Matthieu's avatar
Monnet Jean-Matthieu committed
24
May 2022. Version 4.0.0 now relies on [terra](https://cran.r-project.org/package=terra) and [sf](https://cran.r-project.org/package=sf) packages instead of [raster](https://cran.r-project.org/package=raster) and [sp](https://cran.r-project.org/package=sp).
25
July 2021. Version 3.1.0 introduces names modifications for better constituency. Tests have been added.