calc_dyadic_rates: Calculation of behavior rates for female dyads

In urskalbitzer/daginR: Analyses of Monkey Data from Scan and Focal Samples

Description

This function calculates rates of different behaviors for all female dyads meeting specific criteria (age, focal effort) within a specified group and time period (only works with one group and one time period at a time).

Usage

calc_dyadic_rates(
  focaldata,
  census_pace,
  biography_pace,
  group,
  start,
  end,
  minAgeF,
  behaviours_duration,
  behaviours_events,
  minEffortDyad = 0,
  minEffortInd = 0,
  roles_included = c("D", "R", "M"),
  dyads_summarized = TRUE
)

Arguments

focaldata	Dataset with focaldata from capuchin monkeys
census_pace	Dataframe from the PACE database with monthly capuchin census data
biography_pace	Dataframe from the PACE database with individual biography data
group	Name of the social group
start	Define first and last day (YYYY-MM-DD) of the desired time period
end	Define first and last day (YYYY-MM-DD) of the desired time period
minAgeF	The minimum age of females to be included (in years)
behaviours_duration	Behaviours with duration (e.g. grooming) to be included
minEffortDyad	Minimum duration (in hours) a dyad has to be observed to be included (observation time of IndA while IndB was around + observation time IndB while IndA was around)
minEffortInd	The minimum duration (in hours) an individual has to be observed to be included
roles_included	Which roles should be included, e.g., (D)irected, (R)eceived, or (M)utual
dyads_summarized	Should dyadic values be summarized? If FALSE, each behavior will be listed as IndA->IndB and as IndB->IndA separately (per dyad and per role)
beahviours_events	Behaviours without duration (e.g. approach) to be included

Value

If values are summarized, the rates IndA->IndB and IndB->IndA are averaged. This is slightly different from calculating behaviour counts (or durations) IndA->IndB + IndB->IndA divided by EffortA + EffortB (unless EffortA = EffortB). Thus, rates are not weighted by focal effort of IndA and IndB

urskalbitzer/daginR documentation built on Jan. 21, 2020, 1:26 a.m.