ALB 2024 Diagnostic Model

Download ALB 2024 assessment report:

• Stock Assessment of South Pacific Albacore: 2024
  WCPFC-SC20-2024/SA-WP-02

Download ALB 2024 diagnostic model:

• Clone the alb-2024-diagnostic repository or download as main.zip file

Download ALB 2024 ensemble results:

• Clone the alb-2024-ensemble repository or download as main.zip file

Reference model

In SPC assessment jargon, the diagnostic model is the reference model that is the basis of several sections and figures in the stock assessment report.

The diagnostic model is also the entry point when configuring and running the ensemble models that is the basis of scientific advice. When the model ensemble includes specific factor levels (for steepness, likelihood weights, etc.) the diagnostic model has intermediate levels, while other ensemble models explore higher and lower levels.

Finally, the diagnostic model is also the starting point for the ALB 2027 stock assessment model development. One purpose of this repository is to give the stock assessor a good starting point that is organized and documented.

Explore data, model settings, and results

The MFCL folder includes all the MFCL input files, model settings, and output files.

The TAF folder extracts the data and results from MFCL format to CSV format that can be examined using Excel, R, or other statistical software. TAF is a standard reproducible format for stock assessments that is practical for making the MFCL data and output available in a format that is easy to examine. The report folder contains formatted tables and example plots.

Run the assessment model

The ALB 2024 model takes around 1-2 hours to run. It requires a Linux platform, such as:

• Plain Linux machine, e.g. a personal laptop
• Windows Subsystem for Linux, optional feature in Windows
• Virtual machine, e.g. VirtualBox or VMware
• Online services that provide Linux machines

The mfclo64 executable was compiled on Ubuntu 20.04 using static linking, so it should run on almost any Linux machine.

Run in a Linux terminal

Navigate to the MFCL folder and run:

./doitall.sh

Alternatively, copy the required files into a new folder,

08.par
alb.age_length
alb.frq
doitall.sh
mfcl.cfg
mfclo64

and then run the model:

./doitall.sh

Run on Condor

SPC staff run most assessment models on a Condor cluster of Linux machines:

library(condor)
session <- ssh_connect("CONDOR_SUBMITTER_MACHINE")
condor_submit()

Run in TAF format

Anyone can run the assessment analysis in TAF format. First install TAF, FLCore, and FLR4MFCL, if they are not already installed:

install.packages("TAF")
install_github("flr/FLCore")
install_github("PacificCommunity/FLR4MFCL")

On a Linux machine, the full assessment model can be run as a TAF analysis. Start R, make sure the TAF folder is the working directory, and then run:

library(TAF)
taf.boot()
source.taf("data.R")
source.taf("model.R")
source.taf("output.R")
source.taf("report.R")

A shortcut script is provided, to run the TAF analysis in 1 minute rather than 2 hours:

library(TAF)
taf.boot()
source.taf("data.R")
source.taf("model_shortcut.R")
source.taf("output.R")
source.taf("report.R")

The TAF shortcut analysis runs an all platforms: Windows, Linux, and macOS. It extracts the data and output from the MFCL files and makes them available as CSV files that can be examined and analyzed further.