get_population_results: Get population results from hierarchical models

In fb4package: 'Fish Bioenergetics 4.0' Model Implementation with High-Performance 'TMB' Backend

Get population results from hierarchical models

Description

Extracts population-level results from hierarchical FB4 models. Returns means, standard errors, and population parameters.

Usage

get_population_results(result, confidence_level = 0.95)

Arguments

result	FB4 result object from hierarchical method
confidence_level	Confidence level for intervals (default 0.95)

Value

A named list containing at minimum ten elements: mu_p_estimate and mu_p_se (population-mean ration), sigma_p_estimate and sigma_p_se (among-individual SD), sigma_obs_estimate and sigma_obs_se (observation SD), n_individuals (integer), log_likelihood, aic, and bic. When population uncertainty data are available, additional mean_*_est, mean_*_se, mean_*_ci_lower, and mean_*_ci_upper elements are appended for final_weight, consumption, total_growth, relative_growth, gross_efficiency, and metabolic_scope. Confidence-interval elements are also added for mu_p, sigma_p, and sigma_obs. Stops with an error if result was not produced by the hierarchical method.

Examples

# Population results require a hierarchical run; shown here for illustration
# result <- run_fb4(bio, strategy = "hierarchical", ...)
# pop <- get_population_results(result)

fb4package documentation built on May 8, 2026, 1:07 a.m.