Size Composition Data Format

Size composition datasets describe the length and weight frequency distributions of fish sampled from various fisheries.
They provide important biological information used in stock assessments, growth studies, and species composition analyses.
Each record summarizes the number of fish observed within a defined length or weight class, by gear, flag, species, and spatial cell.

Most size data reported to the Commission originate from observer programs and port sampling activities.
This section focuses exclusively on aggregate size data submitted as part of the annual data submission, and does not include observer data already submitted through standard observer reports — this avoids double counting of information.

Two dedicated templates are used for reporting:

  • Length Composition Template
  • Weight Composition Template

Both templates share common data fields describing the year, month, gear, flag, fleet, and location (latitude and longitude of the southwest corner of the spatial cell).

Preferred resolution:

  • Temporal: Monthly (for all gears)
  • Spatial:
    • Longline and Troll → 5° × 5°
    • Purse Seine, Pole-and-Line, and other gears (e.g., ringnet, handline, gillnet) → 1° × 1°

Units:

  • Length → reported in centimetres (cm)
  • Weight → reported in kilograms (kg)

Each record must also specify the measurement type, which allows the SPC Scientific Services Provider (SSP) to standardize and convert between length and weight measures for analysis.
A full list of valid measurement types is available in the reference tables.


Field formatting details

  • Lengths must be reported in centimetres (cm); weights must be in kilograms (kg).
  • Coordinates (latitude and longitude) must represent the southwest corner of the spatial cell.
  • Spatial resolution must follow the gear-specific grid (5°×5° for longline/troll, 1°×1° for other gears).
  • Indicate whether measurements are rounded up or down to the nearest unit.
  • Clearly describe sampling and statistical methods, including:
    • Whether sampling occurred during fishing operations or at unloading.
    • Details of the sampling protocol.
    • Any adjustments made to the raw size data and the rationale for these.
  • Report any operational changes in the fishery that could affect data interpretation but are not captured as data attributes.
  • Ensure all measurement-type codes follow the approved reference table in Annex A.2.
  • When citing methods, refer to the Brogan et al. (2002) Port Sampling Manual for detailed sampling procedures, species handling protocols, and estimation approaches commonly applied in SPC port sampling programmes.

Documents structure and data fields format

Size composition data are organized into two distinct categories — Length and Weight — each with its own template and documentation files.
This separation ensures clarity, consistent units, and traceability of updates.

CSV Data Templates

Two templates are provided:

  • Length Frequency Template
  • Weight Frequency Template

These datasets form part of the annual data submissions to the Commission and must exclude any observer data already reported separately through observer programmes.


Length Frequency Data

This dataset contains aggregate length composition (frequency) data, summarizing the number of fish observed in each length class by gear, flag, species, and spatial cell.
Each record represents a unique combination of year, month, gear type, species, and spatial cell.

Example document – Length frequency

yearmonthgear_codeflag_codefleet_codelatitudelongitudesp_codelength_cmfreqmeas_type
20251LES-4165SKJ456LF

Field descriptions – Length frequency

Field nameTypeFormat / Allowed valuesDescriptionMandatory
yearNumberYYYYYear of sampling or landingYes
monthNumber1–12Month of sampling or landingYes
gear_codeStringSingle letter gear code (see gear reference table)Fishing gear typeYes
flag_codeString2-letter UN/LOCODEFlag of reporting CCMYes
fleet_codeString2-letter code (see fleet reference table)Sub-fleet codeOptional
latitudeNumberDecimal degrees (-90 to +90) with 3 decimals maximumLatitude of the southwest corner of the spatial cellYes
longitudeNumberDecimal degrees (-180 to +180) with 3 decimals maximumLongitude of the southwest corner of the spatial cellYes
sp_codeStringFAO 3-letter Species CodeSpecies codeYes
length_cmNumberCentimetres (cm)Midpoint of the length class binYes
freqNumberWhole numberNumber of fish observed in that length classYes
meas_typeStringSee Reference Table 1 for details on measurement codes and data types.Type of length measurement used (e.g., LF = Fork Length, LJFL = Lower Jaw Fork Length)Yes

Notes:

  • Lengths (length_cm) must be reported in centimetres (cm) and represent the midpoint of each length class.
  • The freq field records the number of fish within that class bin.
  • Coordinate values (lat, lon) define the southwest corner of the spatial cell.
  • The meas_type code identifies the type of measurement taken (e.g., Fork, Total, Lower Jaw Fork).
  • Exclude any data already submitted through observer datasets.

Weight Frequency Data

This dataset contains aggregate weight composition (frequency) data, summarizing the number of fish by weight class for each fishery, species, and spatial cell.
Each record represents a unique combination of year, month, gear, flag, species, and spatial cell.

Example document – Weight frequency

yearmonthgear_codeflag_codefleet_codelatitudelongitudesp_codesp_kgfreqmeas_type
202510SES13173YFT121WW

Field descriptions – Weight frequency

Field nameTypeFormat / Allowed valuesDescriptionMandatory
yearNumberYYYYYear of sampling or landingYes
monthNumber1–12Month of sampling or landingYes
gear_codeString1–3 letters (see gear reference tableFishing gear typeYes
flag_codeString2-letter UN/LOCODEFlag of reporting CCMYes
fleet_codeString2-letter code (see fleet reference table)Sub-fleet codeOptional
latitudeNumberDecimal degrees (-90 to +90) with 3 decimals maximumLatitude of the southwest corner of the spatial cellYes
longitudeNumberDecimal degrees (-180 to +180) with 3 decimals maximumLongitude of the southwest corner of the spatial cellYes
sp_codeStringFAO 3-letter Species CodeSpecies codeYes
sp_kgNumberKilograms (kg)Midpoint of the weight class binYes
freqNumberWhole numberNumber of fish observed in that weight classYes
meas_typeStringSee Reference Table 1 for details on measurement codes and data types.Type of measurement used (e.g., WW = Whole Weight, GW = Gutted Weight)Yes

Notes:

  • Weights (sp_kg) must be reported in kilograms (kg) and represent the midpoint of each weight class.
  • The freq field indicates how many fish fall within that weight class.
  • Coordinate values (lat, lon) define the southwest corner of the spatial cell.
  • The meas_type code specifies the type of weight measurement (e.g., Whole, Gutted, Dressed).
  • Do not include observer data already reported separately through observer submissions.

References

Reference Table 1: Measurement codes, descriptions, and size data types (i.e., length or weight) for size data.

The commonly used types are in bold.

meas_codemeas_descmeas_type
ANAnal fin lengthL
BFBill to fork in tailL
BLBeak LengthL
CCCurved carapace lengthL
CKCleithrum to anterior base caudal keelL
CLCarapace length (turtles)L
CWCarapace widthL
CXCleithrum to caudal forkL
EOPosterior eye orbital to caudal forkL
EVPosterior eye orbital to ventL
FF1st dorsal to fork in tailL
FS1st dorsal to 2nd dorsalL
GIGirthL
LFLower jaw to fork in tailL
NMNot measuredL
OWObserver’s estimateL
PCNose to anterior tail portion (sharks)L
PFPectoral to fork in tailL
PSPectoral to 2nd dorsalL
SCStraight carapace lengthL
SLTip of snout to end of caudal peduncleL
T1Finlet 1 to tail forkL
T2Finlet 2 to tail forkL
THBody thickness (width)L
TLTip of snout to end of tailL
TWTotal width (tips of wings - rays)L
UFUpper jaw to fork in tailL
USUpper jaw to 2nd dorsalL
WLWing length tip of wing to wrist (birds)L
FNWeight of all fins (sharks)W
FWFillets weightW
GFGilled, gutted, headed, flaps removedW
GGGilled and guttedW
GHGutted, headedW
GOGutted only, not gilledW
GTGilled, gutted, tailedW
GXGutted, headed, tailedW
LWLoin weightW
OCWeight of gills and guts onlyW
TTTrunk weightW
WWWhole weightW

Reference Table 2: Vessel gear listing

gear_codegear_desc
GDrift Gillnet
HHandline (large fish)
KHandline (small fish)
LLongline
NGillnet
OOther (including artisanal troll)
PPole-and-line
RRingnet
SPurse seine
TTroll (albacore)
UGroup seine
VLight boat
ZBaby purse seine

Reference Table 3: List of Fleets

country_codefleet_codegear_codeis_activeocean_codesdescription
AONULLO1AOAO Other
AUNULLO1SP,SX,WPAustralia Other
AUNULLP1WX,SP,SX,WPAustralia pole-and-line
AUNULLT1WX,SP,SX,WPAustralia troll
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
AUJVL1WX,SP,SX,WPAustralian joint-venture Longline
BZNULLL1SP,SX,WPBelize Longline
CANULLS1SP,NP,WPCanadian Purse seine
CANULLT1NP,NXCanada troll
CKNULLL1WX,SP,SX,WPCook Islands longline
CKNULLO1WX,SP,SX,WPCook Islands Artisanal
CKNULLS1WX,WPCook Islands purse seine
CNNULLL1WX,SP,NP,SX,NX,WPChina offshore and distant-water longline
CNNULLS1WX,WPChina purse seine
CNDWL1SP,NP,NX,SXChina distant-water longline
ECNULLS1WX,EP,WPEcuador Purse seine
EPNULLL1SP,NP,EPEP Longline
EPNULLO1EPEP Other
EPNULLP1EPEP Pole and line
EPNULLS1EPEP Seiner
EPNULLT1SP,NP,EPEP Troll
ESNULLL1WX,SP,NP,SX,NX,WPEU - Spanish Longline
ESNULLS1WX,WPEU - Spanish purse seine
FJNULLL1WX,SP,SX,WPFiji longline
FJNULLO1WX,SP,SX,WPFiji Artisanal Tuna Fisheries
FJNULLP1WX,SP,SX,WPFiji pole-and-line
FMNULLL1WX,SP,NP,NX,SX,WPFederated States of Micronesia longline
FMNULLS1WX,WPFederated States of Micronesia purse seine
GUNULLL1NP,NX,WPGuam longline
IDNULLG1WX,SP,SX,WPIndonesia gillnet
IDNULLH1WX,SP,SX,WPIndonesia handline (large-fish)
IDNULLK1WX,SP,SX,WPIndonesia small-fish hook-and-line
IDNULLL1WX,SP,SX,WPIndonesia longline
IDNULLO1WX,SP,SX,WPIndonesia unclassified
IDNULLP1WX,SP,SX,WPIndonesia pole-and-line
IDNULLT1WX,SP,SX,WPIndonesia troll
IDDWS1WX,WPIndonesia distant-water purse seine
IDIDS1WX,WPIndonesia domestic purse seine
IONULLO1IOIO Other
JPNULLG1WX,SP,NP,NX,SX,WPJapan drift gillnet
JPNULLN1WX,SP,NP,WPJapanese Gillnet
JPNULLO1WX,NP,NX,WPJapanese Other
JPNULLT1WX,NP,NX,WPJapanese Troll
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
KINULLL1WX,SP,NP,SX,NX,WPKiribati longline
KINULLO1SP,NX,WPKiribati Artisanal
KINULLP1WX,NP,NX,WPKiribati pole-and-line
KINULLS1WX,NX,WPKiribati purse seine
KRNULLG1WX,SP,NP,NX,SX,WPKorea drift gillnet
KRNULLL1WX,SP,NP,SX,NX,WPKorea longline
KRNULLS1WX,WPKorea purse seine
MHNULLL1WX,NP,NX,WPMarshall Islands longline
MHNULLS1WX,NX,WPMarshall Islands purse seine
MXNULLO1WPMexico Other
MXNULLS1WX,WPMexico purse seine
NCNULLL1WX,SP,SX,WPNew Caledonia longline
NCNULLP1WX,SP,SX,WPNew Caledonia pole-and-line
NINULLS1WPNicaragua purse seine
NPNULLL1SP,NPNP Longline
NPNULLT1SP,NPNP Troll
NRNULLL1NP,NX,WPNauru longline
NRNULLO1WX,SP,NX,WPNauru Artisanal Tuna Fisheries
NRNULLS1WX,NX,WPNauru purse seine
NUNULLL1SP,SX,WPNiue longline
NUNULLO1WX,SP,SX,WPNiue Artisanal
NZNULLL1WX,SP,SX,WPNew Zealand longline
NZNULLO1SP,SX,WPNew Zealand Other
NZNULLP1WX,SP,SX,WPNew Zealand pole-and-line
NZNULLS1WX,WPNew Zealand purse seine
NZNULLT1WX,SP,SX,WPNew Zealand troll
PANULLS1WPPanama Purse seine
PFNULLL1WX,SP,SXFrench Polynesia longline
PFNULLP1SP,SXFrench Polynesia pole-and-line
PFNULLT1WX,SP,SX,WPFrench Polynesia troll
PFO1WX,SP,SX,EP,WPFrench Polynesia Other
PGNULLL1WX,SP,SX,WPPapua New Guinea longline
PGNULLP1WX,SP,SX,WPPapua New Guinea pole-and-line
PGNULLS1WX,SX,WPPapua New Guinea purse seine
PHNULLG1SP,NP,WPPhilippines gillnet
PHNULLH1WX,NP,NX,WPPhilippines handline (large-fish)
PHNULLK1NP,NX,WPPhilippines handline (small-fish)
PHNULLL1WX,NP,NX,WPPhilippines domestic longline
PHNULLO1NP,NX,WPPhilippines artisanal gears (not specified)
PHNULLR1WX,NP,NX,WPPhilippines ringnet
PHDWS1WX,WPPhilippines distant-water purse seine
PHPHS1WX,NX,WPPhilippines domestic purse seine
PTNULLL1SP,SX,WPEU - Portuguese Longline
PWNULLL1WX,NP,NX,WPPalau longline
PWNULLP1WX,NP,NX,WPPalau pole-and-line
SBNULLL1WX,SP,NP,SX,NX,WPSolomon Islands longline
SBNULLP1WX,SP,SX,WPSolomon Islands pole-and-line
SBNULLS1WX,SX,WPSolomon Islands purse seine
SNNULLL1SP,NP,NX,WPSenegal Longline
SUNULLL1SP,NP,NX,WPSoviet Union longline
SUNULLS1WX,WPRussia purse seine
SVNULLS1WPEl Salvador Purse seine
TKNULLO1WX,SP,SX,WPTokelau Artisanal Tuna Fisheries
TONULLL1WX,SP,SX,WPTonga longline
TONULLO1WX,SP,SX,NX,WPTonga Artisanal Tuna Fisheries
TVNULLL1WX,SP,SX,WPTuvalu longline
TVNULLO1WX,SP,SX,WPTuvalu Artisanal Tuna Fisheries
TVNULLP1WX,SP,SX,WPTuvalu pole-and-line
TVNULLS1WX,WPTuvalu Purse seine
TWNULLG1SP,NP,NX,SX,WPChinese Taipei drift gillnet
TWNULLO1NP,NX,WPChinese Taipei Other
TWNULLR1WX,WPChinese Taipei domestic SEINE
TWNULLS1WX,WPChinese Taipei purse seine
TWDWL1WX,SP,NP,SX,NX,WPChinese Taipei distant-water longline
TWODL1NP,NXChinese Taipei offshore domestic longline (REDUNDANT -STLL)
TWOSL1WX,SP,NP,SX,NX,WPChinese Taipei small-scale Longline (STLL)
USNULLG1SP,NPUnited States of America Gillnet
USNULLO1WPUnited States of America (Sports fishery)
USNULLO1WPUnited States of America (Unclassified)
USNULLP1SP,NP,NX,WPUnited States of America Pole and line (Albacore)
USNULLS1WX,WPUnited States of America purse seine
USNULLT1WX,SP,NP,SX,NX,WPUnited States of America Troll (Tropical)
USNULLT1WX,SP,NP,SX,NX,WPUnited States of America (Albacore) troll
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
VNNULLG1WX,NP,NX,WPVietnamese Gillnet
VNNULLH1WX,NP,NX,WPVietnamese Handline
VNNULLL1WX,NP,NX,WPVietnamese Longline
VNNULLS1WX,NP,NX,WPVietnamese Purse seine
VUNULLL1WX,SP,NP,SX,NXVanuatu longline
VUNULLO1WX,SP,SX,WPVanuatu Artisanal Tuna Fisheries
VUNULLS1WX,WPVanuatu purse seine
WFNULLL1WX,SP,SX,WPWallis and Futuna Longline
WFNULLO1WXWallis and Futuna artisanal
WFNULLT1WX,SP,SX,WPWallis and Futuna Troll
WNNULLL1SP,NPNorth Western Pacific longline
WNNULLP1North Western Pacific pole-and-line
WNNULLT1SP,NPNorth Western Pacific troll
WPNULLL1SP,NP,EPWP Longline
WPNULLO1EPWP Other
WPNULLP1EPWP Pole and line
WPNULLS1EPWP Purse Seine
WSNULLL1WX,SP,SX,WPSamoa longline