Learn R Programming

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

DLMtool

DLMtool is a R package for management strategy evalaution and implementation of data-limited fishery stock assessment methods.

Find more information about DLMtool at http://datalimitedtoolkit.org/.

Installation

The released version of DLMtool can be downloaded from CRAN:

install.packages("DLMtool")

This GitHub repository contains the development version of DLMtool. The development version may be unstable, and it is not recommended for analyses.

User Guide

A User Guide for the DLMtool package are now available: 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('DLMtool')

Monthly Downloads

594

Version

5.2

License

GPL-2

Maintainer

Tom Carruthers

Last Published

July 10th, 2018

Functions in DLMtool (5.2)

BK

Beddington and Kirkwood life-history MP
CompSRA

Age-Composition Stock-Reduction Analysis
CC1

Geromont and Butterworth (2015) Constant Catch
Cos_thresh_tab

Current default thresholds for COSEWIC satificing
DDe

Effort-based Delay - Difference Stock Assessment
CSRA

Catch at size reduction analysis
CompSRA_

Internal function for CompSRA MP
DD_R

Delay-Difference Internal Function
AvC_MLL

Average Catch with a size limit
DFO_report

Create a standard DFO MSE report
DCAC_

Depletion Corrected Average Catch
DLMDataDir

Directory of the installed package on your computer
DFO_spider

DFO performance spider plot (top three MPs)
DLMenv

DLMenv blank environment
ChkYrs

Check the years to summarize performance
Choose

Manually map parameters for the historical period of operating model
DOM

How dominant is an MP?
DLMextra

Load more data from DLMextra package
DFO_proj

Deparment of Fisheries and Oceans projection plot
DFO_quant

Deparment of Fisheries and Oceans biomass quantile plot
Blow_opt

Blow internal parallel optimization function
DTe40

Effort searching MP aiming for a fixed stock depletion
Data_xl

Read in Data object from Excel spreadsheet
DLMtool-package

Data-Limited Methods Toolkit
DBSRAopt

Internal optimization function
DBSRA_

Depletion-based SRA internal function
CC

Age-based Catch Curve
DataDescription

DataDescription
DynF

Dynamic Fratio MP
Cplot

Plot the median biomass and yield relative to last historical year
DBSRA

Depletion-Based Stock Reduction Analysis
DataInit

Initialize an empty Data workbook or CSV
FilterSmooth

Kalman filter and Rauch-Tung-Striebel smoother
DFO_bar

Deparment of Fisheries and Oceans stock status bar plot
Fdem_

Internal function for Fdem MP
DecE_Dom

Fleet class objects
Fease

MP feasibility diagnostic
GB_target

Geromont and Butterworth target CPUE and catch MP
GB_slope

Geromont and Butterworth index slope Harvest Control Rule
DFO_hist

Deparment of Fisheries and Oceans historical plot
ForceCor

Forces correlation among operating model parameters for M, K, Linf and L50
IOTC_plot

Indian Ocean Tuna Commission trade-off plot
Imp-class

Class 'Imp'
ImpDescription

ImpDescription
CanMP

What Data objects can be used to run this MP?
IT5

Iterative Index Target MP
Itarget1

Incremental Index Target MP
ChkObj

Check that a DLM object is valid
DFO_plot

Deparment of Fisheries and Oceans trade-off plot
DD

Delay - Difference Stock Assessment
LBSPR

Length-Based SPR Effort Control
Itarget1_MPA

Itarget1 with an MPA
DD_

Delay-Difference Internal Function
MRreal

Spatial closure and allocation management procedures
LH2OM

Predict missing life-history parameters
LHdatabase

LHdatabase
L2A

Length to age conversion
Fleet-class

Class 'Fleet'
DFO_tab

Create a standard DFO performance table
DFO_plot2

Deparment of Fisheries and Oceans default plot 2
Data-class

Class 'Data'
Atlantic_mackerel

Data class objects
MSE-class

Class 'MSE'
DFO_tab_formatted

A formatted version of the standard DFO performance plot, color coded by thresholds
FleetDescription

FleetDescription
ITe5

Index Target Effort-Based
NAor0

Is a value NA or zero.
NOAA_plot

National Oceanographic and Atmospheric Administration default plot 1
Fadapt

Adaptive Fratio
LstepCC1

Step-wise Constant Catch
Lratio_BHI

Mean length-based indicator MP of Jardim et al. 2015
LBSPR_

Internal Estimation Function for LBSPR MP
LBSPRgen

Internal estimation function for LBSPR MP
Overages

Imp class objects
PWhisker

Performance Whisker Plot
Fdem

Demographic FMSY method
Fratio

FMSY/M ratio methods
GB_CC

Geromont and Butterworth Constant Catch Harvest Control Rule
ITM

Index Target based on natural mortality rate
LSRA_MCMC_sim

Internal SRA MCMC CPP code
Fratio_

Fratio internal function
LSRA_opt

Internal estimation function for LSRA and LSRA2 functions
EtargetLopt

Effort Target Optimum Length
FMSYref

Reference management procedures
IT_

Index Target Internal Function
Islope1

Index Slope Tracking MP
OMdoc

Generate OM Documentation Report
PerformanceMetric

Performance Metrics Methods
LSRA

Estimates R0 using SRA to match current F estimates and avoid penalities for low stock sizes
OMexample

Copy example OM XL and OM Documentation
LSRA2

Alternative version of LSRA that's a wrapper for LSRA_opt to return the right type of output (mode) using sapply
Islope_

Index Slope Internal Function
Pplot2

A projection by projection plot of F/FMSY, B/BMSY, B/B0, and yield
Gcontrol

G-control MP
ML2D

Depletion and F estimation from mean length of catches
Itargeteff_

Incremental Index Target MP Internal Function - Effort MP
Kplot

KOBE plot: a projection by projection plot of F/FMSY and B/BMSY
Pplot

A projection by projection plot of F/FMSY and B/BMSY
MPStats

Calculate Statistics for MP Performance
LstepCE1

Step-wise Constant Effort
SampleImpPars

Sample Implementation Error Parameters
LSRA_opt_cpp

Internal estimation function for LSRA and LSRA2 functions
ICI

Index Confidence Interval
OM-class

Class 'OM'
SBT1

SBT simple MP
Input

Function to run a set of input control methods
Iratio

Mean Index Ratio
SampleObsPars

Sample Observation Parameters
Ltarget1

Length Target TAC MP
ItargetE1

Incremental Index Target MP - Effort-Based A management procedure that incrementally adjusts the fishing effort to reach a target CPUE / relative abundance index
MPtype

Management Procedure Type
SPMSY

Catch trend Surplus Production MSY MP
LinInterp

Linear interpolation of a y value at level xlev based on a vector x and y
ObsDescription

ObsDescription
Obs-class

Class 'Obs'
SampleStockPars

Sample Stock parameters
Itarget_

Incremental Index Target MP Internal Function
Rec-class

Class 'Rec'
Sense

Sensitivity analysis
LtargetE1

Length Target TAE MP
MPurl

Get help topic URL
Albacore

Stock class objects
Thresh_tab

Current default thresholds for DFO satificing
OMinit

Initialize Operating Model
MCD

Mean Catch Depletion
OneRep

Make stochastic variables certain for only one rep
Tplot_old

Trade-off plots for an MSE object
Replace

Replace an existing Stock, Fleet, Obs, or Imp object
Generic_Obs

Obs class objects
OMDescription

OMDescription
Turing

Turing Test
PMobj-class

An object for storing data for analysis using data-limited methods
SPSRA

Surplus Production Stock Reduction Analysis
TradePlot

Generic Trade-Plot Function
Stock-class

Class 'Stock'
TradePlot_old

Generic Trade-off Plot
SRAcomp

Plot simulation test of Stochastic SRA method
SPmod

Surplus production based catch-limit modifier
VOI

Calculate Value Of Information
SRAsim

Simulates catch at age and catch history data for testing SRA methods
applyMP

Apply Management Procedures to an object of class Data
avail

What objects of this class are available
SampleFleetPars

Sample Fleet Parameters
SPSRA_

Surplus Production Stock Reduction Analysis Internal Function
VOIplot2

Value of Information Plot using PM functions
SampleCpars

Sample custom pars
TAC

Calculate TAC recommendations for more than one MP
getEffhist

Calculate historical fishing mortality
TACfilter

TAC Filter
XL2Data

Import a Data object from Excel file
XL2OM

Load OM from Excel file
curE

Fishing at current effort levels
compplot

Generic comparison plot for simulation testing of Stochastic SRA method
cv

Calculate CV from vector of values
Range

Standardize values
hist2

Wrapper for histogram function
getFref3

Calculate Reference Yield
YPR

Yield Per Recruit analysis to get FMSY proxy F01
barplot.MSE

Plot a barplot of MSE results
checkMSE

Utility functions for MSE objects
Rcontrol

Intrinsic rate of Increase MP
boxplot.Data

Boxplot of TAC recommendations
getmov2

Optimization function to find a movement model that matches user specified movement characteristics modified for Rcpp.
getr

Internal function to estimate r
plot.OM

Plot the operating model (OM) object parameters
getclass

get object class
getq3

optimize for catchability (q)
SPslope

Slope in surplus production MP
plotObs

Plot the Observation object parameters
plotSelect

Plot the vulnerability and retention curves
demographic2

Internal demographic function
iVB

Inverse von Bertalanffy
makeTransparent

Make colors transparent
dnormal

Double-normal selectivity curve
StochasticSRA

Stochastic SRA construction of operating models
movfit_Rcpp

Rcpp version of the Optimization function that returns the squared difference between user specified and calculated movement parameters.
plotStock

Plot the Stock object parameters
join_plots

Plot several plots with a shared legend
StochasticSRAcpp

Stochastic SRA construction of operating models
optCPU

Determine optimal number of cpus
label.class-class

Label class union for performance metric objects
StockDescription

StockDescription
Sub

Subset MSE object by management procedure (MP) or simulation.
matlenlim

Size limit management procedures
simYears

Simulate population dynamics for historical years
summary,Data-method

Summary of Data object
plot.Data

Plot Data object
runMP

Run a Management Procedure
plotFleet

Plot the Fleet object parameters
runMSE

Run a Management Strategy Evaluation
writeCSV

Internal function to write CSVs for objects
plot.MSE

Plot MSE object
ReqData

ReqData
Required

What management procedures need what data
sdconv

Get parameters of lognormal distribution from mean and standard deviation in normal space
VOI2

Calculate Value Of Information 2
runCOSEWIC

COSEWIC MSE run using the correct MPs and projected time horizon
plotImp

Plot the Implementation object parameters
setup

Setup parallel processing
runInMP

Runs input control MPs on a Data object.
SimulatedData

SimulatedData Data
VOIplot

Yet another Value of Information Plot
tiny

tiny
SketchFun

Manually map the historical relative fishing effort trajectory.
calcMean

Calculate Mean Probability
calcProb

Calculate Probability
tinyErr

Remove observation, implementation, and process error
SubCpars

Subset an OM cpars slot
SubOM

Subset a Stock, Fleet, Obs, or Imp object from an OM object
replic8

Enlarge (replicate) a DLM data object to create an additional dimension for simulation / sensitivity testing
prob.class-class

Prob class union for performance metric objects
YPR_

Internal function for YPR MPs
condmet

Condition met?
sample_steepness2

Sample steepness given mean and cv
cparscheck

Internal function of runMSE for checking that the OM slot cpars slot is formatted correctly
getsel

Calculate selectivity curve
sampy

Sample vector
makeMeanMP

Create an MP that averages the results of multiple MPs
gettempvar

Creates a time series per simulation that has gradient grad and random normal walk with sigma
alphaconv

Calculate parameters for beta distribution from mean and standard deviation in normal space
getBlow

Blow parallel optimization function
getAFC

Calculate age at first capture from length at first capture and growth
initialize-methods

~~ Methods for Function initialize ~~
makePerf

Convert a OM object to one without observation or process error
joinData

Join Data objects present in a list
trlnorm

Lognormal distribution for DLMtool
plotFun

Print out plotting functions
userguide

Open the DLMtool User Guide
optMSY

Optimize yield for a single simulation
plotM

Plot M-at-Age and Size
optQ

Optimize q for a single simulation
popdynCPP

Population dynamics model in CPP
plotMPA

Plot the Historical Spatial Closures
plotOFL

A generic OFL plot for NOAA use
popdynOneTScpp

Population dynamics model for one annual time-step
show,PMobj-method

Show the output of a PM
show,Rec-method

Show the output of a single MP recommendation
summary,MSE-method

Summary of MSE object
validcpars

Valid custom parameters (cpars)
wormplot

Biomass wormplot
testOM

testOM OM
Can

Identify management procedures (MPs) based on data availability
CSRAfunc

Optimization function for CSRA
Converge

Check Convergence
AvC

Average Catch
BlankSelPlot

Internal function to create a blank plot for mapping selectivity at length
DCACs

Depletion Corrected Average Catch