HTest | R Documentation |
HTest
calculates the Horvitz–Thompson-like stand density estimate (number of trees) in a specified area based on a collection of detected trees.
area_esh
is an internal function for surface area calculations that can handle empty sets.
gg_wind
is an internal function that forms a union of discs based on their center points and radii.
HTest(treelist, plotwindow, alpha) area_esh(W) gg_wind(treelist)
treelist |
A 3-column matrix containing the x and y coordinates of detected trees and their crown radii. |
plotwindow |
A |
alpha |
A tuning parameter that controls the calculation of detection probabilities, or detectabilities. Must have a value from -1 to 1. |
W |
A |
HTest
is the Horvitz–Thompson-like stand density estimator presented by Kansanen et al. (2016) to adjust individually detected trees for non-detection. It uses individual tree detection data, namely the locations and crown radii of detected trees, to calculate detection probabilities, or detectabilities, for every detected tree, and produces an estimate based on the detectabilities. The detectability for a certain tree is based on the planar set formed by the larger trees. The parameter alpha
controls how easy it is to detect a tree of certain size from under the larger trees. If alpha
=1, then the tree will be detected if it is not fully covered by the larger crowns. If alpha
=0, the tree will be detected if its center point is not covered. If alpha
=-1, the tree will be detected if it is fully outside the larger tree crowns.
The object treelist
can include trees that are not in the estimation area specified by plotwindow
. This can be useful to take into account possible edge effects, by including trees with center points outside plotwindow
that have crown discs that intersect plotwindow
. The estimate is calculated only using those trees that have crown center points in plotwindow
.
area_esh
and gg_wind
are internal helper functions used by HTest
. First one is a shell for the spatstat
function area.owin
that takes into account that an intersection of two sets can be empty, represented in the calculations as NULL. The function returns 0 in this case. Otherwise, it returns the surface area of the window W
. The latter function forms a union of discs that is needed in the detectability calculations.
HTest
returns a list with two components:
N |
The estimated number of trees in |
treelist |
matrix with columns ”r” and ”detectability”, giving the tree crown radii that have been used in the estimation, as well as the detectabilities for trees with those crown radii. |
area_esh
returns 0, if W
is NULL; otherwise, the surface area of W
.
gg_wind
returns a spatstat
object of class ”owin
” representing a set formed as a union of discs.
These functions require the package spatstat
(Baddeley et al. 2015) to work.
Kasper Kansanen <kasperkansanen@gmail.com>
Kansanen, K., Vauhkonen, J., Lahivaara, T., and Mehtatalo., L. (2016) Stand density estimators based on individual tree detection and stochastic geometry. Canadian Journal of Forest Research 46(11):1359–1366. doi: 10.1139/cjfr-2016-0181.
Baddeley, A., Rubak, E. and Turner, R. (2015) Spatial Point Patterns: Methodology and Applications with R. Chapman and Hall/CRC Press, London. doi: 10.1201/b19708
Kansanen, K., Packalen, P., Lahivaara, T., Seppanen, A., Vauhkonen, J., Maltamo, M., and Mehtatalo., L. (2019) Horvitz–Thompson-like stand density estimation and functional k-NN in individual tree detection. Submitted manuscript.
# Generate a 10x10 meter square window: w<-square(10) # Generate 6 detected trees, 5 located in the window: x<-cbind(c(6.75, 8.65, 3.95, 2, 2, 11), c(1.36, 3.10, 6.66, 2, 4, 11), c(1.29, 2.31, 1.80, 2, 1.5, 3)) # Draw the set formed by the detected tree crowns: plot(w) plot(gg_wind(x), add=TRUE) # Calculate the results with different alpha: HTest(x, w, 1) HTest(x, w, 0) HTest(x, w, -0.75)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.