Augment momentuHMM fits with angular states

Extracts an angle column and inferred states from a fitted momentuHMM model. The function uses momentuHMM::viterbi() by default and adds state probabilities when momentuHMM::stateProbs() is available.

Usage

augment_momentuHMM_angles(
  object,
  data = NULL,
  angle = NULL,
  state_method = c("viterbi", "stateProbs"),
  ...
)

Arguments

object

A fitted momentuHMM object.

data

Optional data frame. If NULL, object$data is used.

angle

Optional name of the angle column.

state_method

State extraction method.

...

Reserved for future methods.

Value

A tibble with .angle, .state and optional state probabilities.

See also

Other movement helpers: as_step_data(), compute_bearing(), compute_step_length(), compute_turn_angle(), geom_circular_point(), geom_direction_arrow(), mutate_directional_features(), plot_state_angles()