Learn R Programming

⚠️There's a newer version (3.7.3) of this package.Take me there.

MSEtool

MSEtool is an extension of the DLMtool R package and provides simulation tools for management strategy evaluation informing data-rich fisheries.

Find more information about DLMtool and MSEtool at https://www.datalimitedtoolkit.org/.

Installation

The released version of MSEtool can be downloaded from CRAN:

install.packages("MSEtool")

The GitHub repository contains the development version of MSEtool, which can be installed via:

devtools::install_github("tcarruth/MSEtool")

The development version may be unstable and it is typically not recommended for analyses.

User Guide

Vignettes describing the features of MSEtool can be obtained via:

devtools::install_github("tcarruth/MSEtool", build_vignettes = TRUE)
browseVignettes("MSEtool")

The vignettes can also be viewed on the MSEtool page on CRAN.

A User Guide for the DLMtool package also available at https://dlmtool.github.io/DLMtool/userguide/introduction.html.

Bugs and Issues

Please report any bugs or issues through GitHub or the DLMtool website.

Copy Link

Version

Install

install.packages('MSEtool')

Monthly Downloads

397

Version

2.0.1

License

GPL-3

Maintainer

Tom Carruthers

Last Published

September 29th, 2020

Functions in MSEtool (2.0.1)

Assessment-class

Class-Assessment
DD_TMB

Delay - Difference Stock Assessment in TMB
CASALpars

Rips MLE estimates from CASAL file structure
Albacore_TwoFleet

A two-fleet Albacore operating model
Awatea2OM

Reads MCMC estimates from Awatea (Paul Starr) processed r file structure into an operating model
CASAL2OM

Reads MLE estimates from CASAL file structure into an operating model
HCR_FB

A Harvest Control Rule using B/BMSY and F/FMSY to adjust TAC or TAE.
Probs

Calculates mahalanobis distance and rejection of the Null operating model
HCR_MSY

Harvest control rule to fish at some fraction of maximum sustainable yield
MOM-class

Class 'MOM'
HCR_ramp

Linearly ramped harvest control rules
ResFromRel

Returns Results of a set of MICE relationships
NIL

Item in list: get the list values from a list of lists
HistMICE

Reconstruct historical dynamics
MPCalcsNAs

Fill any NAs arising from MPCalcs (hermaphroditism mode)
expandHerm

Expand the Herm list in SexPars to a matrix of fractions at age
SS2Data

Reads data Stock Synthesis file structure into a Data object using package r4ss
diagnostic_AM

diagnostic_AM (diagnostic of Assessments in MSE): Did Assess models converge during MSE?
HCRlin

Generic linear harvest control rule based on biomass
Sub_cpars

Stock-reduction analysis (SRA) for conditioning operating models
MSEtool-package

Management Strategy Evaluation
Model-based-MP

Model-based management procedures
SCA

Statistical catch-at-age (SCA) model
SS2MOM

Import Stock Synthesis to multi-fleet 2-sex MOM
MMSE-class

Class 'MMSE'
SOL

Sum over list: get the list values from a list of lists
SP_production

Find the production parameter based on depletion that produces MSY
SRA-class

Class-SRA
PRBcalc

Calculate mahalanobis distance (null and alternative MSEs) and statistical power for all MPs in an MSE
getnIVs

Count independent variables for a MICE relationship at position x in a Rel list
getq_multi

optimize for catchability (q)
multidebug

A basic comparison of runMSE output (MSE) and multiMSE (MMSE)
plot.prof

Plot profile object
plot.retro

Methods for retro object
optQ_multi

Optimize q for a single simulation
plotquant

A fairly tidy time-series quantile plot
cDD

Continuous Delay-differential assessment model
SIL

Slot in list: get the slot values from a list of objects
SS2OM

Reads MLE estimates from Stock Synthesis file structure into an operating model using package r4ss.
SP

Surplus production model with FMSY and MSY as leading parameters
iSCAM2Data

Reads data from iSCAM file structure into a DLMtool Data object
SSS

Simple Stock Synthesis
TAC_MSY

Calculate MSY-based TAC from Assessment object
fetch.file.names

Reads iSCAM Data, Control and Projection files
popdynMICE

Population dynamics for a MICE model (multiyear)
getinds

Characterize posterior predictive data
qestMICE

Internal function for optimizing catchability (q) for a MICE model
compare_models

Compare output from several assessment models
multiDataS

Combine data among stocks
hrate

Derives the rate of exchange from one sex to another based on asymptotic fraction
getq_multi_MICE

optimize for catchability (q) and fishing dist for a MICE model
VPA

Virtual population analysis (VPA)
iSCAM2OM

Reads MLE estimates from iSCAM file structure into an operating model
TEG

Toms expand grid
iSCAMcomps

Combines all iSCAM age composition data across fleets
iSCAMinds

Combines indices into a single index using linear modelling
mahplot

Plot statistical power of the indicator with increasing time blocks
plot_betavar

Plots a beta variable
makemov

Calculates movement matrices from user inputs for fraction in each area (fracs) and probability of staying in areas (prob)
VPA2OM

Reads bootstrap estimates from a VPA stock assessment into an operating model.
multiMSE

Run a multi-fleet multi-stock Management Strategy Evaluation
plot_composition

Plot composition data
multiData

Combine data among fleets
read.control.file

Reads iSCAM control file
simmov

Calculates movement matrices from user inputs
retrospective

Retrospective analysis of assessment models
make_MP

Make a custom management procedure (MP)
retrospective_AM

retrospective_AM (retrospective of Assessment model in MSE)
plotRel

Plot a relationship between stocks
plot.Assessment

Plot Assessment object
plot.MMSE

Standard plot for an object of class MMSE (multi MSE)
avail

What objects of this class are available
plotmulti

A basic SSB plot for debugging runMSE output
read.data.file

Reads iSCAM dat file
plot_timeseries

Plot time series of data
ldim

Dimensions of a hierarchical list object
plot_SR

Plot stock-recruitment function
summary.Assessment

Summary of Assessment object
plot_crosscorr

Produce a cross-correlation plot of the derived data arising from getinds(MSE_object)
projection

Projections for assessment models
project-class

Class-project
plot_residuals

Plot residuals
plot_steepness

Plots probability distribution function of stock-recruit steepness
load.iscam.files

Reads iSCAM files into a hierarchical R list object
plot.SRA

Plot SRA scope output
plot_lognormalvar

Plots a lognormal variable
plot.MOM

Standard plot for an object of class MOM
userguide

Get the MSEtool vignettes
read.mcmc

Reads iSCAM mcmc output files
popdynOneMICE

Population dynamics for a MICE model (single year)
read.par.file

Reads iSCAM parameter file
read.projection.file

Reads iSCAM projection file
prelim_AM

Preliminary Assessments in MSE
swordfish

North Atlantic Swordfish dataset
prof-class

Class-prof
tinyErr

Remove observation error, process error, implementation error or future gradients in (time varying) parameters
profile

Profile likelihood of assessment models
read.report.file

Reads iSCAM Rep file
retro-class

Class-retro