process_pcl: Process single PCL transects.

Description Usage Arguments Details Value Examples

View source: R/process_pcl.R

Description

process_pcl imports and processes a single PCL transect.

Usage

1
2
process_pcl(f, user_height, marker.spacing, max.vai, pavd = FALSE,
  hist = FALSE)

Arguments

f

the name of the filename to input <character> or a data frame <data frame>.

user_height

the height of the laser off the ground as mounted on the user in meters. default is 1 m

marker.spacing

distance between markers, defaults is 10 m

max.vai

the maximum value of column VAI. The default is 8. Should be a max value, not a mean.

pavd

logical input to include Plant Area Volume Density Plot from [plot_pavd], if TRUE it is included, if FALSE, it is not.

hist

logical input to include histogram of VAI with PAVD plot, if TRUE it is included, if FALSE, it is not.

Details

This is function works on either files or existing data frames in the environment. It processes raw PCL data through a workflow that cuts the data into 1 meter segments with z and x positions and vertically normalizes data based on light extinction assumptions from the Beer-Lambert Law to account for light saturation. Data are then summarized, metrics of canopy structure complexity are calculated, and then output data saved to an output directory. A hit grid plot is also saved to this same directory.

Value

writes the hit matrix, summary matrix, and output variables to csv in an output folder, along with hit grid plot

Examples

1
2
3
4
5
6
# with designated file
## Not run: process_pcl("pcl_data.csv", marker.spacing = 10, user_height = 1.05, max.vai = 8)


# with data frame
process_pcl(osbs, marker.spacing = 10, user_height = 1.05, max.vai = 8)

atkinsjeff/forestr documentation built on Nov. 29, 2017, 3:18 a.m.