Aggregated Pole-and-Line Data Format

Aggregate Catch and Effort data for pole-and-line fisheries are to be submitted for data aggregated to the level of: year, month, flag, fleet, gear, and 1x1 degree cell.
Coordinates must represent the southwest corner of each spatial cell and be reported in whole degrees.

Aggregate data represent raised logbook catches and should reflect the total annual catch and effort within the WCPFC Convention Area for a given fleet.

The pole-and-line format is similar to purse seine but does not include a school type field, as this concept is not applicable to this gear type.
In addition, there is a complementary file for reporting the number of active vessels by flag, fleet, year, month, and location (where possible).

The effort information includes:

  • number of fishing days

The catch information includes:


Field formatting details

  • Year must be reported as YYYY.
  • Month must be reported as mm (01 to 12).
  • Latitude and longitude must be reported in whole degrees at a 1°x1° resolution, with coordinates representing the southwest corner of the cell.
    • The valid range is -180 to 179 for longitude and -90 to 89 for latitude.
  • Species code must use FAO 3-letter Species Codes.
    • e.g., SKJ – Skipjack Tuna, YFT – Yellowfin Tuna, BET – Bigeye Tuna.
  • Catches must be reported in metric tonnes (mt) with a maximum of 3 decimal places.
  • Number of days must be a whole value.

Notes:

  • Coordinates correspond to the southwest corner of the 1°x1° cell.
  • Include one record per combination of year, month, flag, fleet, and cell.
  • Ensure all catch species correspond to key species listed in the Sci-Data guidelines.
  • Effort and catch data should represent total annual values aggregated across all operations.

Table documents format

Aggregated data are structured in three interconnected levels: Effort, Catch, and Vessels.
Separate tables are used for each level to maintain clarity and reduce redundancy.
The Effort and Catch tables are connected using a unique identifier set at the Effort level: effort_id, which is referenced at the Catch level.
These identifiers must be alphanumeric and unique within the set of files.

👉 Data providers can also download ready-to-use CSV data templates for each level (catch, effort, and vessels).

CSV Data Templates


Data format details (with examples)

Rows in the Effort table represent aggregated pole-and-line fishing activities, identified by year, month, flag, fleet, latitude, and longitude at a 1°x1° resolution.
Each record contains the total number of fishing days and sets.
Species-specific catches are reported separately using FAO 3-letter species codes and measured in metric tonnes (mt).

Example document at effort level

effort_idflag_codefleet_codeyearmonthlatitudelongitudedays_n
EFF001JPJP202516-17412
EFF002JPJP202515-17426

Field descriptions for the Effort data template

Field nameTypeFormatDescriptionMandatory
effort_idTextUnique identifierUnique identifier for the aggregated effort recordYes
flag_codeText2-letter flag-state code (UN/LOCODE)Authorized flag of the reporting CCMYes
fleet_codeText2-letter code for sub-fleet (see Fleet reference table)Sub-fleet codeNo
yearNumber4-digit numberYear of reported activityYes
monthNumber1–2 digit numberMonth of reported activityYes
latitudeNumberWhole degrees (-90 to +89)Latitude of the southwest corner of the 1°x1° spatial cellYes
longitudeNumberWhole degrees (-180 to +179)Longitude of the southwest corner of the 1°x1° spatial cellYes
days_nNumberIntegerNumber of fishing days associated with the given stratumYes

Notes:

  • Latitude and longitude define the southwest corner of each 1°x1° grid cell.
  • One record per combination of year, month, flag, fleet, and grid cell.
  • Catches are reported in a separate table using FAO 3-letter species codes and expressed in metric tonnes (mt).
  • Ensure data exclude operational-level detail (these represent aggregated summaries).

Example document at catch level

effort_idsp_codesp_mtis_discarded
EFF001SKJ248750
EFF001YFT5800
EFF001OCS0.11
EFF001BET40
EFF002SKJ1206500
EFF002YFT54000

Field descriptions for the Catch data template

Field nameTypeFormatDescriptionMandatory
effort_idTextAlphanumericReference to the unique identifier from the Effort tableYes
sp_codeStringFAO 3-letter Species CodeSpecies caught during the activityYes
sp_mtNumberNumeric, up to 3 decimalsCatch weight in metric tonnes (mt)Yes
is_discardedNumber0 = Retained, 1 = DiscardedIndicator showing whether the catch was discardedYes

Notes:

  • Each record in the Catch table corresponds to a single species entry linked to an Effort record via effort_id.
  • The sp_mt field must represent the aggregated total catch weight in metric tonnes (mt).
  • The is_discarded field identifies whether the species was retained (0) or discarded (1).
  • Species codes must use the FAO 3-letter Species Codes.
  • Ensure all catches are consistent with the Effort table and represent aggregated summaries.

Example document at vessel level

flag_codefleet_codeyearmonthlatitudelongitudevessels_n
JPJP20251617414

Field descriptions for the Vessel data template

Field nameTypeFormatDescriptionMandatory
flag_codeText2-letter flag-state code (UN/LOCODE)Authorized flag of the reporting CCMYes
fleet_codeText2-letter code for sub-fleet (see Fleet reference table)Sub-fleet codeNo
yearNumber4-digit numberYear of reported vessel activityYes
monthNumber1–2 digit numberMonth of reported vessel activityYes
latitudeNumberWhole degrees (-90 to +89)Latitude of the southwest corner of the 1°x1° spatial cellYes
longitudeNumberWhole degrees (-180 to +179)Longitude of the southwest corner of the 1°x1° spatial cellYes
vessels_nNumberIntegerNumber of active vessels operating in that grid cell and time periodYes

Notes:

  • The Vessel table provides contextual information on fishing capacity.
  • One record per combination of year, month, flag, fleet, and grid cell.
  • Coordinates refer to the southwest corner of the 1°x1° cell.
  • This dataset complements Effort and Catch data to improve spatial interpretation of fishing activity.

References

Reference Table 1: List of Fleets

country_codefleet_codegear_codeis_activeocean_codesdescription
AUAFS1WX,SP,SX,WPAustralia purse seine, inside the Australian Fishing Zone
AUAUL1WX,SP,SX,WPAustralia domestic and chartered longline
AUEXS1WX,SP,SX,WPAustralia distant-water purse seine
AUJVL0WX,SP,SX,WPAustralian joint-venture Longline
CNDWL1SP,NP,NX,SXChina distant-water longline
IDDWS1WX,WPIndonesia distant-water purse seine
IDIDS1WX,WPIndonesia domestic purse seine
JPCSL1WX,NP,NX,WPJapan coastal fleet longline
JPCSP1WX,NP,NX,WPJapan coastal fleet pole-and-line
JPCSS1WX,NP,NX,WPJapan coastal fleet purse seine
JPDWP1WX,SP,NP,NX,WPJapan offshore and distant water pole-and-line
JPDWS1WX,SP,NP,NX,WPJapan offshore and distant-water purse seine
JPJPL1WX,SP,NP,SX,NX,WPJapan offshore and distant water longline
PHDWS1WX,WPPhilippines distant-water purse seine
PHPHS1WX,NX,WPPhilippines domestic purse seine
TWDWL1WX,SP,NP,SX,NX,WPChinese Taipei distant-water longline
TWODL0NP,NXChinese Taipei offshore domestic longline (REDUNDANT -STLL)
TWOSL1WX,SP,NP,SX,NX,WPChinese Taipei small-scale Longline (STLL)
USASL1WX,SP,NP,SX,NX,WPAmerican Samoa longline
USAST1WX,SP,SX,NX,WPAmerican Samoa (US) Troll
USGUL1WX,NP,NX,WPGuam (US) Longline
USGUT1WX,SP,SX,NX,WPGuam (US) Troll
USHWH1WX,NP,NX,WPHawaii (US) Handline
USHWL1WX,SP,NP,NX,WPUnited States of America longline (Hawaii)
USHWP1SP,NP,NX,WPHawaii pole-and-line
USHWT1WX,NP,SX,NX,WPHawaii (US) Troll
USHWT1SP,NX,SX,WPHawaii (US) Troll and Handline
USMPL1WX,NP,NX,WPNorthern Marianas Islands (US) Longline
USMPT1WX,SP,SX,NX,WPNorthern Mariana Islands (US) troll
USUSL1WX,SP,NP,NX,WPUnited States of America longline