A class to hold the parameters for a size based model.
Source:R/MizerParams-class.R
MizerParams-class.Rd
Although it is possible to build a MizerParams
object by hand it is
not recommended and several constructors are available. Dynamic simulations
are performed using project()
function on objects of this class. As a
user you should never need to access the slots inside a MizerParams
object
directly.
Details
The MizerParams class is fairly complex with a large number of
slots, many of which are multidimensional arrays. The dimensions of these
arrays is strictly enforced so that MizerParams
objects are consistent
in terms of number of species and number of size classes.
The MizerParams
class does not hold any dynamic information, e.g.
abundances or harvest effort through time. These are held in
MizerSim objects.
Slots
metadata
A list with metadata information. See
setMetadata()
.mizer_version
The package version of mizer (as returned by
packageVersion("mizer")
) that created or upgraded the model.extensions
A named vector of strings where each name is the name of and extension package needed to run the model and each value is a string giving the information that the remotes package needs to install the correct version of the extension package, see https://remotes.r-lib.org/.
time_created
A POSIXct date-time object with the creation time.
time_modified
A POSIXct date-time object with the last modified time.
w
The size grid for the fish part of the spectrum. An increasing vector of weights (in grams) running from the smallest egg size to the largest maximum size.
dw
The widths (in grams) of the size bins
w_full
The size grid for the full size range including the resource spectrum. An increasing vector of weights (in grams) running from the smallest resource size to the largest maximum size of fish. The last entries of the vector have to be equal to the content of the w slot.
dw_full
The width of the size bins for the full spectrum. The last entries have to be equal to the content of the dw slot.
w_min_idx
A vector holding the index of the weight of the egg size of each species
maturity
An array (species x size) that holds the proportion of individuals of each species at size that are mature. This enters in the calculation of the spawning stock biomass with
getSSB()
. Set withsetReproduction()
.psi
An array (species x size) that holds the allocation to reproduction for each species at size, \(\psi_i(w)\). Changed with
setReproduction()
.intake_max
An array (species x size) that holds the maximum intake for each species at size. Changed with
setMaxIntakeRate()
.search_vol
An array (species x size) that holds the search volume for each species at size. Changed with
setSearchVolume()
.metab
An array (species x size) that holds the metabolism for each species at size. Changed with
setMetabolicRate()
.mu_b
An array (species x size) that holds the external mortality rate \(\mu_{ext.i}(w)\). Changed with
setExtMort()
.ext_encounter
An array (species x size) that holds the external encounter rate \(E_{ext.i}(w)\). Changed with
setExtEncounter()
.pred_kernel
An array (species x predator size x prey size) that holds the predation coefficient of each predator at size on each prey size. If this is NA then the following two slots will be used. Changed with
setPredKernel()
.ft_pred_kernel_e
An array (species x log of predator/prey size ratio) that holds the Fourier transform of the feeding kernel in a form appropriate for evaluating the encounter rate integral. If this is NA then the
pred_kernel
will be used to calculate the available energy integral. Changed withsetPredKernel()
.ft_pred_kernel_p
An array (species x log of predator/prey size ratio) that holds the Fourier transform of the feeding kernel in a form appropriate for evaluating the predation mortality integral. If this is NA then the
pred_kernel
will be used to calculate the integral. Changed withsetPredKernel()
.rr_pp
A vector the same length as the w_full slot. The size specific growth rate of the resource spectrum.
cc_pp
A vector the same length as the w_full slot. The size specific carrying capacity of the resource spectrum.
resource_dynamics
Name of the function for projecting the resource abundance density by one timestep.
other_dynamics
A named list of functions for projecting the values of other dynamical components of the ecosystem that may be modelled by a mizer extensions you have installed. The names of the list entries are the names of those components.
other_encounter
A named list of functions for calculating the contribution to the encounter rate from each other dynamical component.
other_mort
A named list of functions for calculating the contribution to the mortality rate from each other dynamical components.
other_params
A list containing the parameters needed by any mizer extensions you may have installed to model other dynamical components of the ecosystem.
rates_funcs
A named list with the names of the functions that should be used to calculate the rates needed by
project()
. By default this will be set to the names of the built-in rate functions.sc
species_params
A data.frame to hold the species specific parameters. See
species_params()
for details.given_species_params
A data.frame to hold the species parameters that were given explicitly rather than obtained by default calculations.
gear_params
Data frame with parameters for gear selectivity. See
setFishing()
for details.interaction
The species specific interaction matrix, \(\theta_{ij}\). Changed with
setInteraction()
.selectivity
An array (gear x species x w) that holds the selectivity of each gear for species and size, \(S_{g,i,w}\). Changed with
setFishing()
.catchability
An array (gear x species) that holds the catchability of each species by each gear, \(Q_{g,i}\). Changed with
setFishing()
.initial_effort
A vector containing the initial fishing effort for each gear. Changed with
setFishing()
.initial_n
An array (species x size) that holds the initial abundance of each species at each weight.
initial_n_pp
A vector the same length as the w_full slot that describes the initial resource abundance at each weight.
initial_n_other
A list with the initial abundances of all other ecosystem components. Has length zero if there are no other components.
resource_params
List with parameters for resource.
A
linecolour
A named vector of colour values, named by species. Used to give consistent colours in plots.
linetype
A named vector of linetypes, named by species. Used to give consistent line types in plots.
ft_mask
An array (species x w_full) with zeros for weights larger than the maximum weight of each species. Used to efficiently minimize wrap-around errors in Fourier transform calculations.