hemispheR: an R package for fisheye canopy image analysis

Abstract

Hemispherical photography is a relevant tool to estimate canopy attributes such as leaf area index (LAI). Advancements in digital photography and image processing tools have supported long-lasting use of digital hemispherical photography (DHP). While some open-source tools have been made available for DHP, very few solutions have been made available in R programming packages, and none of these allows a full processing workflow to retrieve LAI and other canopy attributes from fisheye images. To fill this gap, we developed an R package (hemispheR) to support the whole processing of DHP images in an automated, fast, and reproducible way. The package functions, which are designed for step-by-step single-image analysis, can be performed sequentially in a pipeline, while allowing inspecting the quality of each image processing step. The package allows to analyze both circular and fullframe fisheye images, collected either with upward facing (forest canopies) or downward facing (short canopies and crops) camera orientation. In addition, the package allows to implement two consolidated LAI methods (LAI-2000/2200 and 57{degrees} method). A case study is presented to demonstrate the reliability of canopy attributes derived from hemispheR in temperate deciduous forests with variable canopy density and structure. Canopy attributes were validated against either results obtained from a reference proprietary software, either by benchmarking measurements obtained from terrestrial laser scanning. Results indicated hemispheR provide reliable openness and leaf area index values in forest canopies as compared with reference values. By providing a simple, transparent, and flexible image processing procedure, hemispheR supported the use of DHP for routine measurements and monitoring of forest canopy attributes. Hosting the package in a Git repository will further support development of the package, through either collaborative coding or forking projects.