incRbouts {incR}

Calculation of the number of daily on- and off-bouts

Description

Calculation of number and duration of incubation on- and off-bouts.

Usage

incRbouts(data, vector.incubation, dec_time, temp, sampling.rate)

Arguments

data

data frame containing a time-series vector of 1's and 0's, where "1" means "incubating individual inside nest" and "0" means "incubating individual outside nest". This vector, under the name of "inc.vector", is provided by incRscan in the first object of the returned list. A column named "date" is needed to refer to daily calculations.

vector.incubation

name of the column (vector class) storing the information about the presence/absence of the incubating individual in the nest.

dec_time

(character class) name of the column with decimal time.

temp

(character class) name of the column with incubation temperatures.

sampling.rate

time difference between two consecutive recording points. Effectively, the rate at which data points were recorded (e.g. 1 data point per 50sec). The time units of the returned object will depend on the units of this argument.

Value

This function returns a list with two objects. The first object, named total_bouts, is a list of individual on- and off-bouts, giving information about their start time, duration, start nest temperature and final nest temperature. The second object, day_bouts, provides a summary of on- and off-bouts per day of observation. This second table shows number and mean duration of on- and off-bout per day. Mean times are shown in those time units you specify the argument sampling.rate.

Author(s)

Pablo Capilla-Lasheras

See Also

incRprep incRscan incRact incRatt

Examples

#' # loading example data
data(incR_procdata)
incRbouts (data=incR_procdata, 
           vector.incubation="incR_score", 
           dec_time="dec_time",
           temp="temperature",
           sampling.rate=240) # sampling rate in seconds.