Skip to contents

data_quality(): 捕捞产量统计的数据质量

Source: vignettes/articles/zh/reference/data_quality.Rmd
data_quality.Rmd

英文原页：data_quality()

说明

该函数展示数据质量在两个方面随时间的变化：

  • 根据FAO状态标记，官方上报的渔获量占比，以及估算（由上报国家估算或由FAO插补）的渔获量占比；
  • 根据FAO分类编码，鉴定到种、属、科或只归到更高类群（例如”Marine fishes nei”）的渔获量占比。

它还针对最近五年渔获量最大的几个国家，列出这些年份中其渔获量有多少为估算值、有多少鉴定到种。

English

This function shows two aspects of data quality over time:

  • the share of the catch reported officially, and the share estimated (by the reporting country or imputed by FAO), from the FAO status flags;
  • the share of the catch identified to species, genus, family, or only to a higher group (e.g. “Marine fishes nei”), from the FAO taxonomic codes.

It also lists, for the countries with the largest catch in the last five years, how much of their catch in those years was estimated or identified to species.

用法 

data_quality(
  area_data,
  top_n = 10,
  plot = TRUE,
  table = TRUE,
  lang = NULL,
  pptx = getOption("faofishingreport.pptx", FALSE),
  plot_show = fao_setting("plot_show"),
  label = NULL
)

参数

area_data
FAO渔获数据：fishing_area_data()$area_data，或load_fao_data()的任意子集（例如一个国家，或几个渔区）。
English FAO catch data: fishing_area_data()$area_data, or any subset of load_fao_data() (e.g. one country, or several fishing areas).
top_n
国家表中的国家数。默认为10。
English The number of countries in the country table. 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.
label
输出文件名中使用的名称。默认为数据所属的渔区（或国家）。
English The name used in the output file names. Default is the fishing area (or the country) of the data.

返回值

以不可见方式返回一个列表，包含data_status和taxon_level（各类别逐年的渔获量）以及countries（国家表）。

English

Invisibly, a list with data_status and taxon_level (yearly catch by category) and countries (country table).

详细说明

最近几年估算占比偏高，通常是因为FAO尚未收到各国的上报数据；这些数值往往会在之后的版本中修订。

English

A large estimated share in the latest years usually means that FAO has not yet received the national reports; these values are often revised in later releases.

另请参阅

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

示例 

FAO27 <- fishing_area_data("Atlantic, Northeast", plot = FALSE)
data_quality(FAO27$area_data, lang = "zh")