Calculates the feeding level \(f_i(w)\). The feeding level is the proportion of its maximum intake rate at which the predator is actually taking in fish. It is calculated from the encounter rate \(E_i\) and the maximum intake rate \(h_i(w)\) as $$f_i(w) = \frac{E_i(w)}{E_i(w)+h_i(w)}.$$ The encounter rate \(E_i\) is passed as an argument or calculated with getEncounter. The maximum intake rate \(h_i(w)\) is taken from the params object, and is set with setIntakeMax. As a consequence of the above expression for the feeding level, \(1-f_i(w)\) is the proportion of the food available to it that the predator actually consumes.

getFeedingLevel(object, n, n_pp, n_other, encounter, time_range, drop = FALSE)

Arguments

encounter

The encounter rate matrix (optional) of dimension no. species x no. size bins. If not passed in, it is calculated internally using getEncounter. Only used if object argument is of type MizerParams.

Value

If a MizerParams object is passed in, the function returns a two dimensional array (predator species x predator size) based on the abundances also passed in. If a MizerSim object is passed in, the function returns a three dimensional array (time step x predator species x predator size) with the feeding level calculated at every time step in the simulation. If drop = TRUE then the dimension of length 1 will be removed from the returned array.

Details

The feeding level is used in getEReproAndGrowth and in getPredRate.

See also

Examples

if (FALSE) { data(NS_species_params_gears) data(inter) params <- newMultispeciesParams(NS_species_params_gears, inter) # With constant fishing effort for all gears for 20 time steps sim <- project(params, t_max = 20, effort = 0.5) # Get the feeding level at one time step n <- sim@n[21,,] n_pp <- sim@n_pp[21,] fl <- getFeedingLevel(params,n,n_pp) # Get the feeding level at all saved time steps fl <- getFeedingLevel(sim) # Get the feeding level for time 15 - 20 fl <- getFeedingLevel(sim, time_range = c(15,20)) }