User Documentation for: A harmonized global dataset of historical tuna catch and effort

How to cite:

Emily Rodriguez, & Juan Carlos Villaseñor-Derbez. (2026). A harmonized global dataset of historical tuna catch and effort. (Version v0.0.1) [Dataset]. Zenodo. https://doi.org/10.5281/zenodo.23477216

User Guide

This document provides an overview for users utilizing the harmonized tuna RFMO datasets in this repository. It explains what data are available, how they are structured, and how to load data.

What these data are

This repository harmonizes publicly available catch and effort datasets from four major tuna Regional Fisheries Management Organizations (RFMOs):

  • IATTC
  • ICCAT
  • WCPFC
  • IOTC

Each RFMO publishes data in different formats, resolutions, and naming conventions. This repository standardizes them into a unified format so users can work with a single, consistent set of catch and effort datasets.

Available datasets

Files located under data/output/

Dataset Gear Spatial Resolution Temporal Resolution By Flag Formats
allrfmo_month_1deg_purseseine purse seine 1°×1° month no .csv, .rds
allrfmo_year_1deg_purseseine purse seine 1°×1° year no .csv, .rds
allrfmo_year_1deg_purseseine_flag purse seine 1°×1° year yes .csv, .rds
allrfmo_month_5deg_longline longline 5°×5° month no .csv, .rds
allrfmo_month_5deg_longline_flag longline 5°×5° month yes .csv, .rds
allrfmo_year_5deg_longline longline 5°×5° year no .csv, .rds
allrfmo_year_5deg_longline_flag longline 5°×5° year yes .csv, .rds

Available variables for catch and effort data

Variables Description
rfmo Related RFMO
flag Flag code in ISO 3166-1 alpha-3 (excluding SUN)
lon Longitude of fishing activity
lat Latitude of the fishing activity
year Year of record
month Month of record
effort_set Number of fishing sets
effort_day Number of fishing days
effort_t_hooks Thousands of hooks
catch_tot Total catch (mt)
catch_tot_mt Total catch (mt) (for longline datasets)
catch_tot_num Total catch (numbers of tuna caught) (for longline datasets)
catch_skj Catch of skipjack tuna (mt)
catch_alb Catch of albacore tuna (mt)
catch_bet Catch of bigeye tuna (mt)
catch_yft Catch of yellowfin tuna (mt)

Temporal coverage

Dataset # Records
allrfmo_month_1deg_purseseine 547202
allrfmo_month_5deg_longline_flag 382074
allrfmo_month_5deg_longline 283733
allrfmo_year_1deg_purseseine_flag 349678
allrfmo_year_1deg_purseseine 156506
allrfmo_year_5deg_longline 41624
allrfmo_year_5deg_longline_flag 77150

Spatial coverage

Additional length data

Files located under data/output/

Dataset Gear Spatial Temporal Temporal Coverage By Flag RMFOs Included Formats
wcpfc_length_data multi 5°×5° multi 1953-2025 no WCPFC .rds

Additional variables specific to length datasets

Variables Description
tstrat Temporal stratification
gear Gear type
species Tuna species
length_cm Fish length in centimeters
length_bin Length class/bin in cm based on interval (e.g., 1,2 cm bins)

Downloading .rds data in R

The harmonized tuna RFMO datasets can be loaded directly into R from this GitHub repository without cloning the repository. The datasets for R are stored as .rds files in the data/output/ directory.

To download a dataset:

  1. Navigate to data/output/ in the GitHub repository.
  2. Select the dataset you want to use.
  3. Copy the Raw file URL (not the regular GitHub webpage URL).
  4. Pass the URL to readRDS() as shown below.

For example:

raw_url <- "https://raw.githubusercontent.com/jcvdav/tuna_data/main/data/output/allrfmo_month_1deg_purseseine.rds"

tuna_data <- readRDS(url(raw_url))

head(tuna_data)
# A tibble: 6 × 12
  rfmo    lon   lat  year month effort_set effort_day catch_tot catch_skj
  <chr> <dbl> <dbl> <dbl> <dbl>      <dbl>      <dbl>     <dbl>     <dbl>
1 iotc  130.  -46.5  2023     1         NA          3      14        14  
2 iotc   79.5 -44.5  2016     2         NA         NA       0.5       0.5
3 iotc  148.  -43.5  1999     3         NA         NA     223.      223. 
4 iotc  148.  -43.5  1999     3         NA         NA      19        19  
5 iotc  148.  -42.5  1999     3         NA         NA     124       124  
6 iotc  148.  -41.5  1999     2         NA         NA       1.3       1.3
# ℹ 3 more variables: catch_alb <dbl>, catch_bet <dbl>, catch_yft <dbl>

Downloading .csv Data

.rds files are recommended for R users, but .csv files are also available.

To download a .csv dataset to your computer:

  1. Navigate to the data/output/ directory in the GitHub repository.
  2. Select the .csv file you would like to download.
  3. Click the Download raw file button.
  4. Save the file to your desired location on your computer.

Dataset overviews

Purse seine catch time series

Show code for creating catch time series
### Creating a purse seine catch time series ###################################

# Combine purse seine datasets into a single table
ps_ts <- bind_rows(
  
  # Aggregate each dataset's catch into annual catch totals
  
  # Monthly purse seine data
  month_1deg_ps |>
    
    # Organize observations into groups by year
    group_by(year) |>
    
    # Calculate the total catch each year
    summarise(catch = sum(catch_tot, na.rm = TRUE)) |>
    
    # Create a new column called "dataset" that identifies which source dataset produced each time series
    mutate(dataset = "Monthly"),
  
  # Yearly purse seine data
  year_1deg_ps |>
    group_by(year) |>
    summarise(catch = sum(catch_tot, na.rm = TRUE)) |>
    mutate(dataset = "Yearly"),

  # Yearly purse seine data, by flag
  year_1deg_ps_flag |>
    group_by(year) |>
    summarise(catch = sum(catch_tot, na.rm = TRUE)) |>
    mutate(dataset = "Yearly (flag)")
)

#### Plot the summarized data ##################################################

ggplot(ps_ts,
       aes(x = year, 
           y = catch, 
           color = dataset)) +
  
  # geom_line() adds a line connecting observations through time
  geom_line(linewidth = 1) +
  scale_color_manual(
    values = c(
      "Monthly" = "#005F73",
      "Yearly" = "#0A9396",
      "Yearly (flag)" = "#94D2BD"
    )) +
  theme_bw() +
  labs(
    x = "Year",
    y = "Total catch (mt)",
    color = NULL
  )

Longline catch time series

Show code for creating catch time series
### Creating a longline catch time series ######################################

# Combine longline datasets into a single table
ll_ts <- bind_rows(
  
  # Aggregate each dataset's catch into annual catch totals
  
  # Monthly longline data
  month_5deg_ll |>
    
    # Organize observations into groups by year
    group_by(year) |>
    
    # Calculate the total catch each year
    summarise(catch = sum(catch_tot_mt, na.rm = TRUE)) |>
    
    # Create a new column called "dataset" that identifies which source dataset produced each time series
    mutate(dataset = "Monthly"),
  
  # Montly longline data where catch with flag data
  month_5deg_ll_flag |>
    group_by(year) |>
    summarise(catch = sum(catch_tot_mt, na.rm = TRUE)) |>
    mutate(dataset = "Monthly (flag)"),

  # Annual longline dataset
  year_5deg_ll |>
    group_by(year) |>
    summarise(catch = sum(catch_tot_mt, na.rm = TRUE)) |>
    mutate(dataset = "Yearly"),
  
  # Annual longline dataset with flag data
  year_5deg_ll_flag |>
    group_by(year) |>
    summarise(catch = sum(catch_tot_mt, na.rm = TRUE)) |>
    mutate(dataset = "Yearly (flag)")
)

#### Plot the summarized data ##################################################

ggplot(ll_ts, 
       aes(x = year, 
           y = catch, 
           color = dataset)) +
  
  # geom_line() adds a line connecting observations through time
  geom_line(linewidth = 1) +
  scale_color_manual(
    values = c(
      "Monthly" = "#005F73",
      "Monthly (flag)" = "#0A9396",
      "Yearly" = "#94D2BD",
      "Yearly (flag)" = "#EE9B00"
    )
  ) +

  theme_bw() +
  labs(
    x = "Year",
    y = "Total catch (mt)",
    color = NULL
  )

User feedback

If you identify a bug, data issue, inconsistency, typo, or other problem, please open a GitHub issue and include as much detail as possible:

  • Location of the issue: Specify the relevant file, dataset, or script.
  • Description of the problem: Explain what problem you observed.
  • Reason for concern: Describe why you believe this may be an issue (e.g., incorrect values, missing information, unclear documentation, incorrect filtering).