Skip to contents

英文原页:area_overview()

说明

该函数对比各FAO主要海洋渔区:各渔区渔获量随时间的变化、峰值年份、最后一年渔获量占峰值的百分比,以及近期趋势(见peak_trend())。

English

This function compares the FAO major marine fishing areas: their catch over time, peak year, catch in the last year as a percentage of the peak, and recent trend (see peak_trend()).

用法

area_overview(
  recent_years = 10,
  plot = TRUE,
  table = TRUE,
  lang = NULL,
  pptx = getOption("faofishingreport.pptx", FALSE),
  plot_show = fao_setting("plot_show"),
  data_version = "latest"
)

参数

recent_years
计算趋势所用的最近年数。默认为10。
English The number of most recent years used for the trend. Default is 10.
plot
逻辑值。为TRUE(默认)时,图表保存在figures/png/summary/。
English A logical value. If TRUE (default), charts are saved in figures/png/summary/.
table
逻辑值。为TRUE(默认)时,表格保存在tables/。
English A logical value. If TRUE (default), tables are saved in tables/.
lang
图表文字和名称的语言:“en”(英文)、“zh”(中文)或”both”(中英双语)。默认为NULL,即使用fao_settings()设置的语言(未更改时为”en”)。
English 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
逻辑值。为TRUE时,图表还另存为可编辑的PowerPoint文件,保存在figures/pptx/summary/。默认为FALSE,可以用fao_settings(pptx = TRUE)为所有函数统一更改。
English 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
逻辑值。为TRUE时,每张图在保存的同时也画在绘图窗口中(例如RStudio的Plots窗格),便于立即查看。默认为FALSE,可以用fao_settings(plot_show = TRUE)为所有函数统一更改。无论是否显示,图表都会保存为文件(plot = TRUE)。
English 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.
data_version
使用的FAO数据版本;见fishing_area_data()。默认为”latest”。
English The FAO data release to use; see fishing_area_data().

返回值

以不可见方式返回一个数据框,每个渔区一行(第一行为总渔获量)。

English

Invisibly, a data frame with one row per area (the first row is the total).

示例

area_overview(lang = "zh")