contact (version 1.0.1)

timeBlock.append: Append TimeBlock Information to a Data Frame

Description

Appends "block," "block.start," "block.end," and "numBlocks" columns to an input data frame (x) with a dateTime (see dateTime.append) column. This allows users to "block" data into blockLength-blockUnit-long (e.g., 10-min-long) temporal blocks. If x == NULL, the function output will be a data frame with "dateTime" and block-related columns.

Usage

timeBlock.append(x = NULL, dateTime = NULL, blockLength = 10,
  blockUnit = "mins")

Arguments

x

Data frame containing dateTime information, and to which block information will be appended. if NULL, dateTime input relies solely on the dateTime argument.

dateTime

Vector of length nrow(x) or singular character data, detailing the relevant colname in x, that denotes what dateTime information will be used. If argument == NULL, the function assumes a column with the colname "dateTime" exists in x. Defaults to NULL.

blockLength

Numerical. Describes the number blockUnits within each temporal block. Defaults to 10.

blockUnit

Character string taking the values, "secs," "mins," "hours," "days," or "weeks." Defaults to "hours."

Value

Appends the following columns to x.

block

Integer ID describing unique blocks of time of pre-specified length.

block.start

The timepoint in x at which the block begins.

block.end

The timepoint in x at which the block ends.

numBlocks

Integer describing the total number of time blocks observed within x at which the block

Details

This is a sub-function that can be found in the contactDur functions.

Examples

# NOT RUN {
data("calves")
calves.dateTime<-contact::datetime.append(calves, date = calves$date, 
   time = calves$time) #add dateTime identifiers for location fixes.
calves.block<-contact::timeBlock.append(x = calves.dateTime, 
    dateTime = calves.dateTime$dateTime, blockLength = 10, 
    blockUnit = "mins")
head(calves.block) #see that block information has been appended.
# }