joinTreeVineSpecies: joinTreeVineSpecies: compiles trees with vine conditions and...

In KateMMiller/forestMIDN: Package for importing, joining and querying MIDN forest database tables

joinTreeVineSpecies: compiles trees with vine conditions and the vine species

Description

This function compiles vine species data for live trees only. Must run importData first. Abandoned plots and incomplete visits are excluded from function.

Usage

joinTreeVineSpecies(
  park = "all",
  from = 2007,
  to = as.numeric(format(Sys.Date(), "%Y")),
  QAQC = FALSE,
  locType = c("VS", "all"),
  panels = 1:4,
  canopyPosition = c("all", "canopy"),
  speciesType = c("all", "native", "exotic", "invasive"),
  dist_m = NA
)

Arguments

park	Combine data from all parks or one or more parks at a time. Valid inputs: "all" Includes all parks in the network "APCO" Appomattox Court House NHP only "ASIS" Assateague Island National Seashore "BOWA" Booker T. Washington NM only "COLO" Colonial NHP only "FRSP" Fredericksburg & Spotsylvania NMP only "GETT" Gettysburg NMP only "GEWA" George Washington Birthplace NM only "HOFU" Hopewell Furnace NHS only "PETE" Petersburg NBP only "RICH" Richmond NB only "SAHI" Sagamore Hill NHS only "THST" Thomas Stone NHS only "VAFO" Valley Forge NHP only
from	Year to start analysis, ranging from 2007 to current year
to	Year to stop analysis, ranging from 2007 to current year
QAQC	Allows you to remove or include QAQC events. FALSE Default. Only returns visits that are not QAQC visits TRUE Returns all visits, including QAQC visits
locType	Allows you to only include plots that are part of the GRTS sample design or include all plots, such as deer exclosures "VS" Only include plots that are part of the Vital Signs GRTS sample design "all" Include all plots, such as plots in deer exclosures or test plots.
panels	Allows you to select individual panels from 1 to 4. Default is all 4 panels (1:4). If more than one panel is selected, specify by c(1, 3), for example.
canopyPosition	Allows you to filter on tree crown class "all" Returns all canopy positions "canopy" Returns only dominant, codominant, and intermediate crown classes. Since only live trees are assigned crown classes, this also only returns live trees.
speciesType	Allows you to filter vine species on native, exotic or include all species. "all" Default. Returns all species. "native" Returns native species only "exotic" Returns exotic species only
dist_m	Filter trees by a distance that is less than or equal to the specified distance in meters of the tree to the center of the plot. If no distance is specified, then all trees will be selected. For example, to select an area of trees that is 100 square meters in area, use a distance of 5.64m.

Value

returns a data frame for every tree visit with at least one vine condition recorded. Trees without a vine condition are not returned.

Examples

## Not run: 
importData()
# compile vine data for all parks in cycle 3, excluding QAQC visits
vines_c3 <- joinTreeVineSpecies(from = 2015, to = 2018, QAQC = FALSE)

# compile exotic vine data for all parks and years
vines_exo <- joinTreeVineSpecies(speciesType = 'exotic')

# compile vine data for GETT in 2019, including QAQC visits
GETT_vines <- joinTreeVineSpecies(park = "GETT", from = 2019, to = 2019,
                                 QAQC = TRUE)

## End(Not run)

KateMMiller/forestMIDN documentation built on Nov. 10, 2024, 11:54 p.m.