basal_area {ausplotsR}

Basal area of tree trunks in TERN AusPlots

Description

Calculates basal area (or number of basal wedge hits) for each plot, using the raw basal wedge data returned from get_ausplots.

Usage

basal_area(veg.basal, by.spp=FALSE, by.hits=FALSE, 
species_name=c("SN","HD","GS"))

Arguments

veg.basal

Raw basal wedge data generated from get_ausplots.

by.spp

Set to TRUE to get values per individual species in plots rather than combined values per plot.

by.hits

Set to TRUE to return the number of individual basal wedge hits rather than basal area per se.

species_name

If by.spp=TRUE, set to "SN" to use "standardised_names" (the default), "HD" to use "herbarium_determination", and "GS" to use "genus_species". See details for explanation of each setting.

Details

Stand basal area is the cross-sectional area of tree trunks per unit area, and is measured at each plot using a basal wedge sweep. Measurement is by species at nine points, and basal area (number of hits at a defined wedge angle multiplied by the basal wedge factor) is averaged across them (Finch 1957). Raw tree stem hits are also recorded, noting that the number of hits is dependent on the basal wedge factor in use. Note that species-level estimates of basal area (if requested in the function) may be unstable if there were fewer than 7 hits of that species.

species_name provides multiple options for calculating basal area if by.spp=TRUE. For example, if species_name="HD", the function will use the "herbarium_determination" provided by state herbaria to identify unique species. "herbarium_determination" are made to the lowest possible taxonomic rank, which may be the family, genus, species, subspecies or variety. If species_name="SN", the default, the function will use the the "standardised_name" to identify unique species. Values are based on the veg.PI$herbarium_determination but have been matched to the accepted scientific name according to the Australian Plant Census (APC: https://www.anbg.gov.au/cpbr/program/hc/hc-APC.html) and the Australian Plant Name Index (APNI: https://www.anbg.gov.au/cpbr/program/hc/hc-APNI.html). The standardised name field therefore helps to ensure taxonomic consistency. It excludes any records that don't match the APC. If species_name="GS", only the standardised genus species rank ("genus_species" in the veg.basal input table) is used to identify species. species_name="GS" maximises consistency in species comparisons between plots, but reduces the taxonomic detail.

Value

Returns a dataframe with rows for plots (or species by plots if by.spp=TRUE) and basal area (m2/ha) or hit scores as mean per plot/species across the 9 sweep points. Species means (if selected) are mean across all 9 sweep points, even if a species is recorded at fewer points.

Author(s)

Greg R. Guerin, Samantha E.M. Munroe

References

Finch, H.D.S. (1957) Plotless enumeration with angle gauges.Forestry 30, 173-192.

See Also

get_ausplots

Examples

## Not run: 
#get basal wedge data for selected plots:
my.data <- get_ausplots(my.Plot_IDs=c("SATFLB0004", "QDAMGD0022", "NTASTU0002"),
site_info=FALSE, basal.wedge=TRUE)

#calculate basal area:
basal_area(my.data$veg.basal)

## End(Not run)