bev_import: Import multiple behaviour observation files

In wanjarast/accelerateR: Process acceleration data

Import multiple behaviour observation files

Description

Import the behaviour and corresponding timestamps from multiple files of the same individual. Can also add the behaviour lables to the raw acceleration data.

Usage

bev_import(id , date = NULL , time = NULL , timestamp = NULL , behaviour , rounding = 10 ,
time_format = dmy_hms , match = FALSE , acc_data , data_path = NULL)

Arguments

id	ID of the individual that is read in.
date	Name of the column that stores the date. (This applies if date and time are stored in two sperate columns)
time	Name of the column that stores the time. (This applies if date and time are stored in two sperate columns)
timestamp	Name of the column that stores the timestamp. (This applies if date and time are stored in the same column)
behaviour	Name of the column that stores the behaviour.
rounding	Rounds the timestamp down to the desired position set in seconds. No rounding when set to 1. The default is 10 which will round the timestamp down to full 10 seconds.
time_format	Date-time format of the original data. Default is dmy_hms which corresponds to day.month.year_hour:minute:second
match	Should the imported behaviour data be added to the acceleration data. Default is FALSE.
acc_data	In case match is TRUE this names the acceleration data frame to which the behaviour data should be added.
data_path	Data path of the data in case they are not stored in the RStudio project folder. If the data is located in the project folder no path is needed.

Details

This function will only accept csv files. All files of the same individual schould be named in order. Multiple files of the same individual should be indicated with either a number or a letter (capital or small). Excepted formats are "<id>_behaviour_1.csv" or "<id>_behaviour_a.csv". In case there is only one behaviour file it should be named "<id>_behaviour.csv". All data will be read in in order of the file naming. Timestamp order will have no influence.

Value

The output will be a data.table.data frame which should work like a base R data.frame in most cases.

Author(s)

Wanja Rast

See Also

tag_import

Examples

##---- NOT RUN !! ----

data <- bev_import(id = "tag6566" , date = "date" , time = "time" , behaviour = "bev" ,
                    rounding = 10 , match = T , acc_data = raw_data , time_format = dmy_hms)

wanjarast/accelerateR documentation built on June 21, 2022, 3:29 p.m.