Build a spesim_result directly from observed data — spesim_from

Creates a full spesim_result object using real observed site x species data, site coordinates, and optional site-level environment. No simulation is performed.

Usage

spesim_from_observed(
  abund_matrix,
  site_coords,
  site_env = NULL,
  domain = NULL,
  env_gradients = NULL,
  edges = NULL,
  order_by = NULL,
  directed = FALSE,
  wrap = FALSE,
  point_jitter = 0
)

Arguments

abund_matrix: Data frame with first column site and remaining species abundance columns.
site_coords: Data frame with columns site, x, y.
site_env: Optional data frame with site and environmental columns.
domain: Optional sf polygon domain. If NULL, a convex hull + small buffer is built from site_coords.
env_gradients: Optional environmental grid. If NULL, a point grid is created from site_env joined to site_coords.
edges: Optional edge table (from, to, optional weight) defining connectivity among sites.
order_by: Optional ordering used to build chain edges when edges is NULL.
directed: Logical; treat connectivity as directed.
wrap: Logical; only used when chain edges are auto-built.
point_jitter: Numeric jitter for reconstructed species_dist points.

Value

A spesim_result.