Package: Rceattle 4.5.0

Grant Adams

Rceattle: Fits the Multispecies Assessment Model (CEATTLE) Using TMB

Implements the CEATTLE model using Template Model Builder ('TMB'; Kristensen et al. 2015), which can be installed following <https://github.com/kaskr/adcomp/wiki/Download>. Structured similar to the original manuscript in terms of modularization. Separate functions estimate retrospective temperature- and size-specific predator rations, prey preference, and weight-at-age. These are then used as inputs to the CEATTLE model to evaluate how predation mortality, recruitment, and survival of three target species change under historical climate conditions and harvest rates.

Authors:Grant Adams [aut, cre]

Rceattle_4.5.0.tar.gz
Rceattle_4.5.0.zip(r-4.7)Rceattle_4.5.0.zip(r-4.6)Rceattle_4.5.0.zip(r-4.5)
Rceattle_4.5.0.tgz(r-4.6-x86_64)Rceattle_4.5.0.tgz(r-4.6-arm64)Rceattle_4.5.0.tgz(r-4.5-x86_64)Rceattle_4.5.0.tgz(r-4.5-arm64)
Rceattle_4.5.0.tar.gz(r-4.7-arm64)Rceattle_4.5.0.tar.gz(r-4.7-x86_64)Rceattle_4.5.0.tar.gz(r-4.6-arm64)Rceattle_4.5.0.tar.gz(r-4.6-x86_64)
manual.pdf |manual.html✨
card.svg |card.png
Rceattle/json (API)
NEWS

# Install 'Rceattle' in R:
install.packages('Rceattle', repos = c('https://noaa-fisheries-integrated-toolbox.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/grantdadams/rceattle/issues

Pkgdown/docs site:https://grantdadams.github.io

Datasets:
  • Atka2022 - Data inputs for Atka mackerel CEATTLE model
  • BS2017MS - Data inputs for multispecies CEATTLE of the Bering Sea from 1979 to 2017
  • BS2017SS - Data inputs for single species CEATTLE of the Bering Sea from 1979 to 2017
  • EBS_ms_run - Fitted multispecies CEATTLE model for the Eastern Bering Sea
  • EBS_ss_M_run - Fitted single-species CEATTLE model with estimated M for the Eastern Bering Sea
  • EBS_ss_run - Fitted single-species CEATTLE model for the Eastern Bering Sea
  • GeorgesBank3spp - Data inputs for a three-species Georges Bank CEATTLE model
  • GOA2018SS - Data inputs for a single-species Gulf of Alaska CEATTLE model
  • GOAatf - Data inputs for Gulf of Alaska arrowtooth flounder CEATTLE model
  • GOAatf2023 - Data inputs for Gulf of Alaska arrowtooth flounder CEATTLE model
  • GOAcod - Data inputs for Gulf of Alaska Pacific cod CEATTLE model
  • GOApollock - Data inputs for Gulf of Alaska walleye pollock CEATTLE model
  • GOAsafe2018 - Gulf of Alaska 2018 SAFE report reference values
  • NorthernRockfish2022 - Data inputs for Northern Rockfish CEATTLE model
  • whamGrowthData - Data inputs for CEATTLE model with WHAM-estimated growth

On CRAN:

Conda:

8.16 score 12 stars 238 scripts 66 exports 56 dependencies

Last updated from:3ccf8f15d3. Checks:12 OK, 1 FAIL. Indexed: no.

TargetResultTimeFilesSyslog
linux-devel-arm64OK445
linux-devel-x86_64OK400
source / vignettesOK483
linux-release-arm64OK321
linux-release-x86_64OK340
macos-release-arm64OK291
macos-release-x86_64OK579
macos-oldrel-arm64OK294
macos-oldrel-x86_64OK616
windows-develOK461
windows-releaseOK430
windows-oldrelOK361
wasm-releaseFAIL130

Exports:build_boundsbuild_growthbuild_hcrbuild_hcr_mapbuild_M1build_mapbuild_paramsbuild_srrcheck_mseclean_datacombine_datacompare_simconvergence_diagnosticsfit_controlfit_modjitterlinkage_specload_msemodel_averagemse_summaryplot_b_eatenplot_b_eaten_propplot_biomassplot_catchplot_compplot_dataplot_depletionplot_depletionSSBplot_diet_compplot_exploitable_biomassplot_fplot_formplot_indexplot_indexresidualplot_logindexplot_m_at_ageplot_m2_at_age_propplot_maturityplot_mortalityplot_rationplot_recruitmentplot_selectivityplot_selectivity_vs_maturityplot_ssbplot_ssb_depletionplot_stock_recruitplot_timeseriesprior_betaprior_gammaprior_lognormalprior_normalread_datarearrange_datrearrange_dataremove_Frename_outputretrospectiverun_msesample_recself_testset_phasessim_modswitch_checkTMBAICTMBphasewrite_data

Dependencies:bitopscaToolscellrangerclicowplotcpp11crayondplyrfarvergenericsggplot2gluegplotsgswgtablegtoolshmsisobandKernSmoothlabelinglatticelifecyclemagrittrMASSMatrixocepillarpkgconfigplyrprettyunitsprogresspurrrR.methodsS3R.ooR.utilsR6RColorBrewerRcppRcppEigenreadxlrematchreshape2rlangS7scalesstringistringrtibbletidyrtidyselectTMButf8vctrsviridisLitewithrwritexl

Model options and functionality

Grant Adams

Rendered frommodel-options-and-functionality.Rmdusingknitr::rmarkdownon Jun 10 2026.

Last update: 2026-05-27
Started: 2026-05-08

Rceattle: An Introduction

Rendered fromintroduction.Rmdusingknitr::rmarkdownon Jun 10 2026.

Last update: 2026-05-11
Started: 2026-05-08

HCRs and MSEs: an introduction

Grant Adams

Rendered fromhcrs-and-mses.Rmdusingknitr::rmarkdownon Jun 10 2026.

Last update: 2026-05-27
Started: 2026-05-08

Model diagnostics

Rendered frommodel-diagnostics.Rmdusingknitr::rmarkdownon Jun 10 2026.

Last update: 2026-06-10
Started: 2026-05-08

Projections and reference points

Rendered fromprojections-and-reference-points.Rmdusingknitr::rmarkdownon Jun 10 2026.

Last update: 2026-05-08
Started: 2026-05-08

Single- vs. multi-species models

Rendered fromsingle-vs-multispecies.Rmdusingknitr::rmarkdownon Jun 10 2026.

Last update: 2026-05-08
Started: 2026-05-08

Building a data object in R

Rendered fromdata-without-excel.Rmdusingknitr::rmarkdownon Jun 10 2026.

Last update: 2026-05-08
Started: 2026-05-08

Converting from Stock Synthesis

Rendered fromstock-synthesis-conversion.Rmdusingknitr::rmarkdownon Jun 10 2026.

Last update: 2026-05-08
Started: 2026-05-08

Model parameterizations

Rendered frommodel-parameterizations.Rmdusingknitr::rmarkdownon Jun 10 2026.

Last update: 2026-05-08
Started: 2026-05-08

Environmental linkages and priors: a formula-driven API

Rendered fromenvironmental-linkages-and-priors.Rmdusingknitr::rmarkdownon Jun 10 2026.

Last update: 2026-05-27
Started: 2026-05-08

Growth estimation with linkages and priors

Rendered fromgrowth-estimation.Rmdusingknitr::rmarkdownon Jun 10 2026.

Last update: 2026-05-27
Started: 2026-05-08

Readme and manuals

Help Manual

Help pageTopics
Helper to adjust map for shared catchability/selectivity indicesadjust_map_shared_params
Tidy long-format derived quantities from an Rceattle fitas.data.frame.Rceattle
Data inputs for Atka mackerel CEATTLE model (2022)Atka2022
Data inputs for multispecies CEATTLE of the Bering Sea from 1979 to 2017BS2017MS
Data inputs for single species CEATTLE of the Bering Sea from 1979 to 2017BS2017SS
Build parameter boundsbuild_bounds
Specify the growth model for Rceattlebuild_growth
Specify the harvest control rule (HCR) used for Rceattlebuild_hcr
Function to construct the TMB map argument for CEATTLE for projecting under alternative harvest control rulesbuild_hcr_map
Define M1 specificationsbuild_M1
Main function to construct the TMB map argument for CEATTLEbuild_map
Helper to set map for Catchability parametersbuild_map_catchability
Helper to set map for debug modebuild_map_debug
Helper to set map for Fishing Mortality and Data Weightsbuild_map_f_and_data_weights
Helper to set map for Fixed N-at-Age modelsbuild_map_fixed_natage
Helper to set map for growth parametersbuild_map_growth
Helper to set map for Natural Mortality (M1) parametersbuild_map_m1
Helper to set map for Predation Mortality (M2) parametersbuild_map_predation
Helper to set map for Recruitment parametersbuild_map_recruitment
Helper to set map for Selectivity parametersbuild_map_selectivity
Build parameter list from cpp filebuild_params
Specify the stock-recruit relationship (SRR) for Rceattlebuild_srr
Function to load .RDs files from MSE runscheck_mse
Function to clean data prior to Rceattle runsclean_data
Extract estimated parameters from an Rceattle fitcoef.Rceattle
Combine data sets. Will use the env_data data set from data_set1 and diet data will have to be updated.combine_data
Evaluate simulation performancecompare_sim
Convergence diagnostics for a fitted Rceattle modelconvergence_diagnostics
Fitted multispecies CEATTLE model for the Eastern Bering SeaEBS_ms_run
Fitted single-species CEATTLE model with estimated M for the Eastern Bering SeaEBS_ss_M_run
Fitted single-species CEATTLE model for the Eastern Bering SeaEBS_ss_run
Bundle the optimizer / sdreport / phasing controls for 'fit_mod()'fit_control
This function runs CEATTLEfit_mod
Data inputs for a three-species Georges Bank CEATTLE modelGeorgesBank3spp
Generate Length-at-Age Transition Matrixget_growth_matrix_r
Calculate Predicted Weight-at-Ageget_weight_at_age_r
Data inputs for a single-species Gulf of Alaska CEATTLE model (2018)GOA2018SS
Data inputs for Gulf of Alaska arrowtooth flounder CEATTLE modelGOAatf
Data inputs for Gulf of Alaska arrowtooth flounder CEATTLE model (2023)GOAatf2023
Data inputs for Gulf of Alaska Pacific cod CEATTLE modelGOAcod
Data inputs for Gulf of Alaska walleye pollock CEATTLE modelGOApollock
Gulf of Alaska 2018 SAFE report reference valuesGOAsafe2018
Jitter analysisjitter
Capture a linkage specificationlinkage_spec
Function to load .RDs files from MSE runsload_mse
Log-likelihood of an Rceattle fitlogLik.Rceattle
Model average of derived quantitiesmodel_average
Management strategy evaluation performance metric summarymse_summary
Data inputs for Northern Rockfish CEATTLE model (2022)NorthernRockfish2022
Plot biomass eatenplot_b_eaten
Plot biomass consumed of each prey species by predatorplot_b_eaten_prop
Plot biomassplot_biomass
Landings fitsplot_catch
Plot time series of comp dataplot_comp
Timeline of data used in the model likelihoodsplot_data
Plot biomass depletionplot_depletion
Plot SSB depletionplot_depletionSSB
Plot diet composition fitsplot_diet_comp
Plot exploitable biomassplot_exploitable_biomass
plot Fplot_f
Plot functional formplot_form
CPUE fitsplot_index
CPUE residualplot_indexresidual
log(CPUE) fitsplot_logindex
Plot natural mortality by ageplot_m_at_age
Plot predation mortality by age and predatorplot_m2_at_age_prop
Plot maturityplot_maturity
Plot M1 + M2plot_mortality
Plot rationplot_ration
Plot recruitmentplot_recruitment
Plot selectivityplot_selectivity
Plot fishery selectivity and maturityplot_selectivity_vs_maturity
Plot spawning stock biomass (SSB)plot_ssb
Plot SSB depletion (deprecated name)plot_ssb_depletion
Plot stock recruit functionplot_stock_recruit
Plot time-seriesplot_timeseries
Plot method for fitted Rceattle modelsplot.Rceattle
Print method for fitted Rceattle modelsprint.Rceattle
Beta prior on a linkage coefficientprior_beta
Gamma prior on a linkage coefficientprior_gamma
Lognormal prior on a linkage coefficientprior_lognormal
Normal prior on a linkage coefficientprior_normal
Likelihood profile across one or more parameter cellsprofile.Rceattle
Read a CEATTLE excel data fileread_data
Rearrange a data_list for TMBrearrange_dat rearrange_data
Rerun with F = 0.remove_F
Function to rename derived quantities from Rceattlerename_output
Observed-vs-fitted residuals from an Rceattle fitresiduals.Rceattle
Retrospective peelsretrospective
Make a vector of colors.rich.colors.short
Run a management strategy evaluationrun_mse
Sample historical recruitment deviates and place in the projectionsample_rec
Self test simulation analysis analysisself_test
Function to set phasing orderset_phases
Simulate Rceattle datasim_mod
Compact summary method for Rceattle fitssummary.Rceattle
Function to check for missing switches for map and parameter functionsswitch_check
#https://www.dataanalytics.org.uk/make-transparent-colors-in-r/t_col
Calculate marginal AIC for a fitted modelTMBAIC
Run TMB using phasesTMBphase
Variance-covariance matrix for an Rceattle fitvcov.Rceattle
Data inputs for CEATTLE model with WHAM-estimated growthwhamGrowthData
Write data filewrite_data