Plot diet, resolved by prey species, as function of predator at size.

Plots the proportions with which each prey species contributes to the total biomass consumed by the specified predator species, as a function of the predator's size. These proportions are obtained with getDiet().

Usage

plotDiet(object, species = NULL, return_data = FALSE)

Arguments

object

An object of class MizerSim or MizerParams.

species

The species to be selected. Optional. By default all target species are selected. A vector of species names, or a numeric vector with the species indices, or a logical vector indicating for each species whether it is to be selected (TRUE) or not.

return_data

A boolean value that determines whether the formatted data used for the plot is returned instead of the plot itself. Default value is FALSE

Value

A ggplot2 object, unless return_data = TRUE, in which case a data frame with the four variables 'Predator', 'w', 'Proportion', 'Prey' is returned.

Details

Prey species that contribute less than 1 permille to the diet are suppressed in the plot. The plot only extends to predator sizes where the predator has a meaningful abundance (defined as having a biomass density greater than 0.1% of its maximum biomass density).

If more than one predator species is selected, then the plot contains one facet for each species.

See also

getDiet()

Other plotting functions: animateSpectra(), plot,MizerParams,missing-method, plot,MizerSim,missing-method, plotBiomass(), plotFMort(), plotFeedingLevel(), plotGrowthCurves(), plotPredMort(), plotSpectra(), plotYield(), plotYieldGear(), plotting_functions

Examples

# \donttest{
plotDiet(NS_params, species = "Cod")

plotDiet(NS_params, species = 5:9)


# Returning the data frame
fr <- plotDiet(NS_params, species = "Cod", return_data = TRUE)
str(fr)
#> 'data.frame':	800 obs. of  4 variables:
#>  $ Predator  : Factor w/ 1 level "Cod": 1 1 1 1 1 1 1 1 1 1 ...
#>  $ w         : num  0.486 0.58 0.693 0.827 0.987 1.18 1.4 1.68 2 2.39 ...
#>  $ Prey      : Factor w/ 14 levels "External","Resource",..: 14 14 14 14 14 14 14 14 14 14 ...
#>  $ Proportion: num  0.00113 0.00139 0.0017 0.00208 0.00254 ...
# }