Calculate stoichiometric balance — calculate_stoichiometric

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)
#> $nutrient_limitation
#> [1] "N-limited"
#> 
#> $limiting_nutrient
#> [1] "nitrogen"
#> 
#> $excess_nutrient
#> [1] "phosphorus"
#> 
#> $excess_factor
#> consumed 
#>     1.08 
#> 
#> $limiting_efficiency
#> [1] 0.3
#> 
#> $consumption_np_ratio
#> consumed 
#> 6.666667 
#> 
#> $redfield_ratio
#> [1] 7.2
#> 
#> $np_deviation
#>   consumed 
#> -0.5333333 
#> 
#> $efficiencies
#> $efficiencies$nitrogen
#> $efficiencies$nitrogen$assimilation_efficiency
#> [1] 0.8
#> 
#> $efficiencies$nitrogen$retention_efficiency
#> [1] 0.3
#> 
#> $efficiencies$nitrogen$excretion_rate
#> [1] 0.5
#> 
#> $efficiencies$nitrogen$growth_efficiency
#> [1] 0.375
#> 
#> 
#> $efficiencies$phosphorus
#> $efficiencies$phosphorus$assimilation_efficiency
#> [1] 0.73
#> 
#> $efficiencies$phosphorus$retention_efficiency
#> [1] 0.3333333
#> 
#> $efficiencies$phosphorus$excretion_rate
#> [1] 0.4
#> 
#> $efficiencies$phosphorus$growth_efficiency
#> [1] 0.4545455
#> 
#> 
#> $efficiencies$relative_n_retention
#> [1] 0.9
#> 
#> $efficiencies$relative_n_excretion
#> [1] 1.25
#> 
#> 
#> $np_ratios
#> $np_ratios$ratios
#>  consumed    growth excretion  egestion 
#>  6.666667  6.000000  8.333333  5.000000 
#> 
#> $np_ratios$ratio_type
#> [1] "mass"
#> 
#> $np_ratios$redfield_ratio
#> [1] 7.2
#> 
#>