fb4package (version 2.0.0)

get_population_results: 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)

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.

Arguments

result

FB4 result object from hierarchical method

confidence_level

Confidence level for intervals (default 0.95)

Examples

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