MLZ (version 0.1.5)

profile_MLmulti: Grid search for the multispecies mean length estimator

Description

A grid search is performed over the time series, which can be used to identify local and global minima. A plot of the likelihood surface is also created similar to Figure 6 of Gedamke and Hoenig (2006) or Figure 3 of Huynh et al. (2017).

Usage

profile_MLmulti(MLZ.list, ncp, model = c("SSM", "MSM1", "MSM2", "MSM3"),
  startZ1 = rep(0.5, length(MLZ.list)), parallel = ifelse(ncp > 2,
  TRUE, FALSE), min.time = 3, figure = TRUE, color = TRUE)

Value

A matrix of change points with the total negative log-likelihood values and values from the each species.

Arguments

MLZ.list

A list containing an object of class MLZ_data for each species or stock.

ncp

The number of change points.

model

The name of the multispecies model for the grid search.

startZ1

A vector of length ncp+1 as the starting value of total mortality rate used in the grid search.

parallel

Whether the grid search is performed with parallel processing.

min.time

The minimum number of years between change points. Only used if ncp > 1.

figure

If TRUE, creates a plot of the likelihood over the grid search. Only used if ncp = 1 or 2.

color

If TRUE, creates a color plot for the likelihood surface. Only used if ncp = 2.

References

Gedamke, T. and Hoenig, J.M. 2006. Estimating mortality from mean length data in nonequilibrium situations, with application to the assessment of goosefish. Transactions of the American Fisheries Society 135:476-487.

Huynh, Q.C, Gedamke, T., Hoenig, J.M, and Porch C. 2017. Multispecies Extensions to a Nonequilibrium Length-Based Mortality Estimator. Marine and Coastal Fisheries 9:68-78.

Examples

if (FALSE) {
data(PRSnapper)
profile_MLmulti(PRSnapper, ncp = 1, model = "MSM1")
}