Aggregated Troll Data Format

Aggregate Catch and Effort data for troll are to be submitted for data aggregated to the level of:
year, month, flag, fleet, gear, and 5x5 degree cell.

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

The effort information includes:

  • number of fishing days

The catch information includes:

  • catch in weight (mt) and number of individuals (n)
  • an indicator to note whether the catch was discarded or not

The vessel information may also be reported to indicate the number of active vessels contributing to the aggregated data at the same spatial and temporal level.


Field formatting details

  • Year (or season) must be reported as YYYY.
  • Month must be reported as mm (01 to 12).
  • Latitude and longitude must be reported in whole degrees, floored by 5° increments (e.g., 24° reported as 20°, and -137° reported as -140°).
    The valid range is -180 to 175 for longitude and -90 to 85 for latitude.
  • Species codes must use FAO 3-letter Species Codes.
  • Fleet codes must follow the Fleet reference table.

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


Example document at effort level

effort_idflag_codefleet_codeyearmonthlatitudelongitudedays_n
EFF001NZ20251-32-17412
EFF002NZ20251-33-17426

Field descriptions for the Effort data template

Field nameTypeFormatDescriptionMandatory
effort_idTextUnique IDIdentifier linking effort and catch dataYes
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
yearNumberYYYYCalendar year of fishing activityYes
monthNumber1–12Month of fishing activityYes
latitudeNumberWhole degrees (floored by 5° increment)Centre of 5x5° grid cellYes
longitudeNumberWhole degrees (floored by 5° increment)Centre of 5x5° grid cellYes
days_nNumberIntegerNumber of fishing days in the cellYes

Example document at catch level

effort_idsp_coderetained_ndiscard_nretained_mtdiscard_mt
EFF001ALB38421023.44.043
EFF001BET30230
EFF002ALB52001531.72.065
EFF002BET100.010

Field descriptions for the Catch data template

Field nameTypeFormatDescriptionMandatory
effort_idTextLinks to EffortIdentifier linking catch record to effort recordYes
sp_codeTextFAO 3-letter species code (see Species reference table)Species caughtYes
retained_nNumberIntegerNumber of fish retainedYes
discard_nNumberIntegerNumber of fish discardedYes
retained_mtNumberDecimalRetained catch weight in metric tonnesYes
discard_mtNumberDecimalDiscarded catch weight in metric tonnesYes

Example document at vessel level

flag_codefleet_codeyearmonthlatitudelongitudevessels_n
NZ20251-3217414

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
yearNumberYYYYCalendar year of fishing activityYes
monthNumber1–12Month of fishing activityYes
latitudeNumberWhole degrees (floored by 5° increment)Centre of 5x5° grid cellYes
longitudeNumberWhole degrees (floored by 5° increment)Centre of 5x5° grid cellYes
vessels_nNumberIntegerNumber of vessels active in that cell during the periodYes

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