addCarcass {dwp}

Add Carcasses to a Site Layout

Description

After the site layout is analyzed and structured by rings for analysis, carcass data may still need to be added to the site data. addCarcass grabs carcass location data from a shape file or data frame and formats it into ring data, with carcass tallies in every 1m ring from the turbine to the maximum search distance away from any turbine.

Usage

addCarcass(x, ...)

## S3 method for class 'shapeCarcass'
addCarcass(
  x,
  data_ring,
  plotLayout = NULL,
  ncarcReset = TRUE,
  ccCol = NULL,
  ...
)

## S3 method for class 'data.frame'
addCarcass(
  x,
  data_ring,
  ccCol = NULL,
  ncarcReset = TRUE,
  unitCol = "turbine",
  rCol = "r",
  ...
)

Arguments

x

carcass data to insert into data_ring

...

ignored

data_ring

ring data for receiving carcass data from x

plotLayout

(optional) shapeLayout object to facilitate proper insertion of carcass data into ring structure.

ncarcReset

boolean to direct the function to set the carcass counts in all the rings to 0 before adding the new carcasses (default) or to add the new carcasses to the old totals (ncarcReset = FALSE).

ccCol

name of carcass class column (optional). Typically, the "carcass class" would be for carcass characteristics that would be expected to affect distances that carcasses would fall from the turbine. For example, distances would not be expected to be the same for large and small carcasses, and bats may have significantly different distance distributions than small birds. The ccCol could also be used for subsetting by any covariate that would be expected to interact with carcass distance distributions, like season (if winds vary by season) or turbine type (if the site has a diverse mix of turbines of different sizes or types). Additionally, ccCol can be used to subset the data by area (for example, NW, NE, SW, SE; or hilltop, river bank) or any other discrete covariate that the user may be interested in.

unitCol

name of unit column

rCol

name of column with carcass distances

Value

an object of class rings with a tally of the number of of carcasses discovered in each concentric 1m ring from the turbine to the most distant point searched.

Examples

 data(layout_simple)
 data(carcass_simple)
 sitedata <- initLayout(layout_simple)
 ringdata <- prepRing(sitedata)
 ringsWithCarcasses <- addCarcass(carcass_simple, data_ring = ringdata)