Aggregated Purse Seine Data Format

Aggregate Catch and Effort data for purse seine 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 purse seine format includes information on associated school types, providing a clear view of fishing behavior and catch composition by activity type.

The effort information includes:

  • number of fishing days by activity and school type
  • number of sets (for fishing set activities)
  • school type (e.g., free school, drifting FAD, anchored FAD, etc.)

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.
  • School type codes must follow the School Type Reference Table.
  • 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 sets 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, activity, school type, 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 operational activities.

Table documents format

Aggregated data are structured in two interconnected levels: Effort and Catch. In this format, separate tables are used for each data level to maintain clarity and reduce redundancy. Each table is connected using a unique identifier, which is set at Effort level: effort_id and referenced at Catch level. These identifiers must be numeric or alphanumeric and unique within the set of files.

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

CSV Data Templates

Data format details (with examples)

Rows in the Effort table represent aggregated purse seine 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 for each school type.
Species-specific catches are reported separately using FAO 3-letter species codes and measured in metric tonnes (mt).

Example document at effort level

effort_idyearmonthflag_codefleet_codelatitudelongitudeschool_type_iddays_nsets_n
EFF00120251JPDW6-17441210
EFF00220251JPDW5-17412620

Field descriptions for the Effort data template

Field nameTypeFormatDescriptionMandatory
effort_idTextUnique identifierUnique identifier for the aggregated effort recordYes
yearNumber4-digit numberYear of reported activityYes
monthNumber1–2 digit numberMonth of reported activityYes
flag_codeText2-letter flag-state code (UN/LOCODE)Authorized flag of the reporting CCMYes
fleet_codeText2-letter code for sub-fleet see Fleet reference tableSub-fleet codeNo
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
school_type_idNumberInteger: refer to School type reference tableType of school for the set (e.g., 1 = Free school, 4 = Drifting FAD)Yes
days_nNumberIntegerNumber of fishing days associated with the given activity and school typeYes
sets_nNumberIntegerNumber of fishing sets made under the specified conditionsYes

Notes:

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

Example document at catch level

effort_idsp_codesp_mtis_discarded
EFF001YFT130
EFF001BET15.20
EFF002BET260

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 discardedNo

Notes:

  • Each record in the Catch table corresponds to a single species entry linked to an Effort record via effort_id.
  • Both number of fish (sp_n) and catch weight (sp_mt) can be reported if available.
  • At least one of these two fields (sp_n or sp_mt) must be present.
  • 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 aggregated summaries consistent with the Effort table records.

Example document at vessel level

flag_codefleet_codeyearmonthlatitudelongitudevessels_n
JPDW20251617414

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 purse seine vessels operating in that grid cell and time periodYes

Notes:

  • The Vessel table provides contextual information on fishing capacity and fleet distribution.
  • 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 tables to enhance interpretation of fishing activity and effort distribution.
  • Values represent active vessels, not total registered vessels.

References

Reference Table 1: School Type identifiers

school_type_idDescription
1Unassociated/free school
2Feeding on baitfish
3Drifting log, debris or dead animal
4Drifting raft, FAD or payao
5Anchored raft, FAD or payao
6Live whale
7Live whale shark
8Other

Reference Table 2: 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