Skip to contents

Catch Composition by Species Group

Source: R/species_group_composition.R
species_group_composition.Rd

This function summarises the catch by ISSCAAP species group (e.g. "Herrings, sardines, anchovies") or by major group (fishes, crustaceans, molluscs, ...) over time. It saves stacked area charts of the catch and of each group's share, and a table by decade.

Usage

species_group_composition(
  area_data,
  group = c("isscaap", "major"),
  top_n = 8,
  plot = TRUE,
  table = TRUE,
  lang = NULL,
  pptx = getOption("faofishingreport.pptx", FALSE),
  plot_show = fao_setting("plot_show"),
  label = NULL
)

Arguments

area_data

FAO catch data: fishing_area_data()$area_data, or any subset of load_fao_data() (e.g. one country, or several fishing areas).

group

"isscaap" (default) for the ISSCAAP species groups, or "major" for the major groups.

top_n

The number of groups shown separately; the others are combined. Default is 8.

plot

A logical value. If TRUE (default), charts are saved in figures/png/summary/.

table

A logical value. If TRUE (default), tables are saved in tables/.

lang

The language of the chart text and names: "en" (English), "zh" (Chinese) or "both" (Chinese and English). Default is NULL, which uses the language set with fao_settings() ("en" unless changed).

pptx

A logical value. If TRUE, charts are also saved as editable PowerPoint files in figures/pptx/summary/. Default is FALSE, which can be changed for all functions with fao_settings(pptx = TRUE).

plot_show

A logical value. If TRUE, each chart is also drawn in the plot window (e.g. the Plots pane of RStudio) as it is saved, to look at it at once. Default is FALSE, which can be changed for all functions with fao_settings(plot_show = TRUE). The charts are saved as files (plot = TRUE) either way.

label

The name used in the output file names. Default is the fishing area (or the country) of the data.

Value

Invisibly, a list with yearly (catch by group and year) and table.

Details

ISSCAAP groups come from the FAO species code list. FAO gives no Chinese names for them; the Chinese names used are in inst/extdata/group_names_zh.csv (unofficial translations).

See also

Other summary analyses: area_overview(), coastal_distant(), country_group_summary(), data_quality(), diversity_concentration(), peak_trend(), regime_shift(), stock_status()

Examples

if (FALSE) { # \dontrun{
FAO27 <- fishing_area_data("Atlantic, Northeast", plot = FALSE)
species_group_composition(FAO27$area_data, lang = "zh")
} # }