run_meta_resampled: Running hierarchical model meta-analyses (with resamples)

In movedesign: Study Design Toolbox for Movement Ecology Studies

Running hierarchical model meta-analyses (with resamples)

Description

This function performs a meta-analysis on movement tracking data, for mean home range area (AKDE) or continuous-time speed and distance (CTSD) estimates for a sampled population. It leverages the ctmm R package, specifically the meta() function, to obtain population-level mean parameters. This function helps to evaluate the significance of results under combination testing.

Usage

run_meta_resampled(
  rv,
  set_target = c("hr", "ctsd"),
  subpop = FALSE,
  random = FALSE,
  max_samples = 100,
  iter_step = 2,
  trace = FALSE,
  .automate_seq = FALSE,
  .only_max_m = FALSE,
  .lists = NULL
)

Arguments

rv	A list containing outputs, settings and data objects. Must not be NULL.
set_target	Character. Research target: "hr" for home range or "ctsd" for speed & distance.
subpop	Logical. If TRUE, will run meta-analyses with groups. Default is FALSE.
random	Logical. If TRUE, samples random subsets of individuals. Default is FALSE.
max_samples	Integer. Maximum number of resamples when random = TRUE. Must be positive. Default is 100.
iter_step	Numeric. The size of each iteration step. Default is 2.
trace	Logical. If TRUE, prints progress messages. Default is FALSE.
.automate_seq	Logical. If TRUE, overwrites sequence automatically to improve plot readability. Default is FALSE.
.only_max_m	Logical. If TRUE, will only run the maximum number of individuals. Default is FALSE.
.lists	A list containing already created meta inputs. Default is NULL.

Value

A data frame containing meta-analysis outputs, including estimates, errors, confidence intervals, and group information.

Author(s)

Inês Silva [e-mail]

Examples

if(interactive()) {
run_meta_resampled(rv, set_target = "hr")
}

movedesign documentation built on June 24, 2025, 9:07 a.m.