time_of_day: Time of the day when a fix was taken

View source: R/time_of_day.R

time_of_dayR Documentation

Time of the day when a fix was taken

Description

A convenience wrapper around suncalc::getSunlightTimes to annotate if a fix was taken during day or night (optionally also include dawn and dusk).

Usage

time_of_day(x, ...)

## S3 method for class 'track_xyt'
time_of_day(x, include.crepuscule = FALSE, ...)

## S3 method for class 'steps_xyt'
time_of_day(x, include.crepuscule = FALSE, where = "end", ...)

Arguments

x

⁠[track_xyt,steps_xyt]⁠
A track or steps.

...

Further arguments, none implemented.

include.crepuscule

⁠[logical(1)=TRUE]⁠
Should dawn and dusk be included.

where

⁠[character(1)="end"]{"start", "end", "both"}⁠ For steps, should the start, end or both time points be used?

Value

A tibble with an additional column tod_ that contains the time of the day for each relocation.

Examples

data(deer)
deer |> time_of_day()
deer |> steps_by_burst() |> time_of_day()
deer |> steps_by_burst() |> time_of_day(where = "start")
deer |> steps_by_burst() |> time_of_day(where = "end")
deer |> steps_by_burst() |> time_of_day(where = "both")


amt documentation built on June 25, 2024, 1:14 a.m.