This function is used to find contiguous regions of unique value in a – potentially irregular/heterogeneous – univariate categorical time series.
name of the variable to use from
data.table containing behavioural variable from or one multiple animals.
When it has a key, unique values, are assumed to represent unique individuals (e.g. in a behavr table).
Otherwise, it analysis the data as coming from a single animal.
an object of the same type as
data (i.e. data.table::data.table or behavr::behavr).
Each row is a specific bout characterised by three columns.
t – its onset
duration – its length
<var> – a column with the same name as
var. The value of
var for this bout.
The relevant rethomic tutorial section – on sleep analysis
sleep_annotation – to generate a binary sleep variable
rle run length encoding function – on which this analysis is based
1 2 3 4 5 6 7 8 9 10 11 12 13
# Bout analysis on binary variable: dt <- toy_dam_data() dt[, moving := activity > 0] bdt <- bout_analysis(moving,dt) print(bdt) # With multiple states dt <- toy_ethoscope_data() # we discretise x position in three states: left, middle and right (1/3 each) dt[, location := as.character( cut(x, breaks = c(0.0, .33, .67, 1.0), labels = c("left", "middle", "right")))] bdt <- bout_analysis(location, dt)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.