Skip to contents

Analyze and Plot the Main Species Caught by a Country in a Fishing Area

Source: R/country_species.R
country_species.Rd

This function takes the fishing area data and a country name, analyzes the catch of that country, and identifies the top species by production at the ranks chosen with rank_range.

Usage

country_species(
  area_data,
  country_name,
  rank_range = 1:10,
  plot = TRUE,
  table = TRUE,
  timeseries_analysis = TRUE,
  time_analysis_text_displacement = 10,
  h_value = 0.15,
  ZH = FALSE,
  lang = NULL,
  pptx = getOption("faofishingreport.pptx", FALSE),
  plot_show = fao_setting("plot_show")
)

Arguments

area_data

A data frame containing the fishing area data.

country_name

A string specifying the country to be analyzed.

rank_range

The ranks of the species to show, ranked by the catch of the country: the ranks listed, e.g. 1:10 (default) for the first ten, c(5, 6) for the fifth and sixth, or c(1, 10) for the first and the tenth. Ranks beyond the number of species are left out. Until version 0.9.0 two numbers gave the first and the last rank (c(1, 10) was the first ten).

plot

A logical value indicating whether to generate and save plots.

table

A logical value indicating whether to generate and save tables

timeseries_analysis

A logical value indicating whether to analysis timeseries.

time_analysis_text_displacement

The number of years after the first year of data at which the percentage labels are placed in the faceted time series plot. Default is 10.

h_value

The minimum segment size passed to strucchange::breakpoints(): a fraction of the series length (default 0.15) or a number of years.

ZH

A logical value. If TRUE, chart text and names are in Chinese. Default is FALSE. ZH = TRUE is the same as lang = "zh".

lang

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

pptx

A logical value. Charts are always saved as PNG in figures/png/; if TRUE they are also saved as editable PowerPoint files in figures/pptx/. 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.

Value

A data frame with the yearly catch of the country by the ranked species (the others grouped). Charts and tables are saved if plot and table are TRUE.

See also

Other species and country analyses: country_analysis(), species_country()

Examples

if (FALSE) { # \dontrun{
FAO27 <- fishing_area_data("Atlantic, Northeast")
country_species(FAO27$area_data, "Norway", rank_range = 1:10)    # the ten main species
country_species(FAO27$area_data, "Norway", rank_range = c(5, 6)) # the fifth and sixth
} # }