calculate_stoichiometric_balance: Calculate stoichiometric balance

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

Calculate stoichiometric balance

Description

Analyzes nutritional limitations based on N:P ratios and determines which nutrient is limiting growth.

Usage

calculate_stoichiometric_balance(nutrient_balance)

Arguments

nutrient_balance

Complete list result from calculate_nutrient_balance with efficiencies and ratios

Value

A named list with ten elements:

nutrient_limitation

Character. Overall assessment: "N-limited", "P-limited", or "Undetermined".

limiting_nutrient

Character. The identified limiting nutrient ("nitrogen", "phosphorus", or "unknown").

excess_nutrient

Character. The nutrient in relative excess.

excess_factor

Numeric. Fold-excess of the non-limiting nutrient relative to the Redfield ratio; 1 when undetermined.

limiting_efficiency

Numeric. Retention efficiency of the limiting nutrient; NA when undetermined.

consumption_np_ratio

Numeric. Observed N:P ratio of consumed food.

redfield_ratio

Numeric. Reference Redfield ratio used.

np_deviation

Numeric. Difference between observed and Redfield N:P ratio.

efficiencies

List from calculate_nutrient_efficiencies.

np_ratios

List from calculate_np_ratios.

Examples

nb <- list(
  nitrogen   = list(consumed = 10, assimilated = 8, growth = 3, excretion = 5,
                    egestion = 2, assimilation_efficiency = 0.8),
  phosphorus = list(consumed = 1.5, assimilated = 1.1, growth = 0.5,
                    excretion = 0.6, egestion = 0.4, assimilation_efficiency = 0.73)
)
calculate_stoichiometric_balance(nb)

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