README.md

# Overview

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

# Installation

* `R` >= 4.0.3 recommended, package `lidR` >= 4.0.0 required
* **The package is available on [CRAN](https://cran.r-project.org/package=lidaRtRee)**, to install run in the `R` console `install.packages("lidaRtRee")`
* **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")`

# Tutorials

**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:

* [ALS data pre-processing](https://gitlab.irstea.fr/jean-matthieu.monnet/lidartree_tutorials/-/wikis/ALS-data-preprocessing)
* [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)

# Changelog

4.0.1 (May 2022) 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).

3.1.0 (July 2021) introduces names modifications for better constituency. Tests have been added.