fb4package (version 2.0.0)

get_individual_results: Get individual results from hierarchical models

Description

Extracts all individual-level results from hierarchical FB4 models. Returns a comprehensive summary for each individual.

Usage

get_individual_results(result, confidence_level = 0.95)

Value

A data.frame with one row per individual. Base columns are

individual_id, p_estimate, and p_se. When individual uncertainty data are available the frame additionally contains

*_est, *_se, *_ci_lower, and *_ci_upper

columns for final_weight, consumption, total_growth,

relative_growth, gross_efficiency, and

metabolic_scope. Stops with an error if result was not produced by the hierarchical method.

Arguments

result

FB4 result object from hierarchical method

confidence_level

Confidence level for intervals (default 0.95)

Examples

# \donttest{
data(fish4_parameters)
sp   <- fish4_parameters[["Oncorhynchus tshawytscha"]]$life_stages$adult
info <- fish4_parameters[["Oncorhynchus tshawytscha"]]$species_info
bio  <- Bioenergetic(
  species_params     = sp,
  species_info       = info,
  environmental_data = list(
    temperature = data.frame(Day = 1:30, Temperature = rep(12, 30))
  ),
  diet_data = list(
    proportions = data.frame(Day = 1:30, Prey1 = 1.0),
    energies    = data.frame(Day = 1:30, Prey1 = 5000),
    prey_names  = "Prey1"
  ),
  simulation_settings = list(initial_weight = 100, duration = 30)
)
bio$species_params$predator$ED_ini <- 5000
bio$species_params$predator$ED_end <- 5500
# Individual results require a hierarchical run; shown here for illustration
# result <- run_fb4(bio, strategy = "hierarchical", ...)
# df <- get_individual_results(result)
# }