movedesign (version 0.3.2)

md_plot_preview: Preview plot for movedesign workflow outputs (single replicate)

Description

Generates a quick visualization of relative error for home range or movement speed estimation from a single replicate of a movedesign workflow. This functions shows preliminary outputs only and should not be used to evaluate study design.

Use the output of md_run() (a movedesign_preprocess object). Users should run md_replicate() for a full assessment.

Usage

md_plot_preview(obj, error_threshold = 0.05, pal = c("#007d80", "#A12C3B"))

Value

A ggplot object displaying relative error by population sample size, with point estimate and confidence intervals for mean estimates, and horizontal error threshold lines.

Arguments

obj

An object of class movedesign_preprocess (output of md_run()).

error_threshold

Numeric. Error threshold (e.g. 0.05 for 5%) to display as a reference in the plot.

pal

Character vector of two colors for within/outside threshold (default: c("#007d80", "#A12C3B")).

Details

For robust results and credible intervals, use md_replicate().

See Also

md_run(), md_replicate()

Examples

if (interactive()) {
  input <- md_prepare(
    data = buffalo,
    models = models,
    species = "buffalo",
    n_individuals = 5,
    dur = list(value = 1, unit = "month"),
    dti = list(value = 1, unit = "day"),
    add_individual_variation = TRUE,
    grouped = TRUE,
    set_target = "hr",
    which_meta = "mean"
  )

  output <- md_run(input)
  md_plot_preview(output, error_threshold = 0.05)
}