Skip to contents

cmsy_tables(): 报告用的CMSY++先验参数表和结果表

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

英文原页：cmsy_tables()

说明

本函数生成CMSY++研究通常给出的两个表格：各种群的先验（所用年份、r和k的范围、MSY先验，以及第一年、中间年份和最后一年的B/k先验及其来源）和结果（r、k、MSY、Fmsy和Bmsy及其95%置信限，最后一年的B/Bmsy和F/Fmsy、Kobe象限概率和状态）。数值经过舍入，范围写作”low-high”（下限-上限），列名使用所选的语言。

English

This function makes the two tables that CMSY++ studies usually give: the priors of each stock (years used, r and k ranges, MSY prior, and the B/k priors of the first, intermediate and last years, with their sources) and the results (r, k, MSY, Fmsy and Bmsy with their 95% confidence limits, last-year B/Bmsy and F/Fmsy, Kobe probabilities and status). Values are rounded and ranges written as “low-high”, with the column names in the chosen language.

用法 

cmsy_tables(
  result,
  stocks = NULL,
  table = TRUE,
  lang = NULL,
  silent = fao_setting("silent")
)

参数

result
cmsy_run()的结果。
English The result of cmsy_run().
stocks
要列入表格的种群（可选）：Stock标识，或物种的FAO英文或中文名称、学名或FAO三字母代码。默认为NULL，即所有已运行的种群。
English Optional stocks to put in the tables: Stock identifiers or species, by English or Chinese FAO name, scientific name or FAO 3-alpha code. Default is NULL, all stocks that ran.
table
逻辑值。为TRUE（默认）时，表格保存在tables/cmsy/。
English A logical value. If TRUE (default), the tables are saved in tables/cmsy/.
lang
表格列名和名称的语言：“en”（英文）、“zh”（中文）或”both”（中英双语）。默认为NULL，即使用fao_settings()设置的语言（未更改时为”en”）。
English The language of the column names and other names of the tables: “en” (English), “zh” (Chinese) or “both”. Default is NULL, which uses the language set with fao_settings() (“en” unless changed).
silent
逻辑值。为TRUE时不输出种群匹配情况的提示信息。默认为FALSE，或fao_settings(silent = )设置的值。
English A logical value. If TRUE, the messages on how the stocks were matched are not printed. Default is FALSE, or the value set with fao_settings(silent = ).

返回值

以不可见方式返回一个列表，包含数据框priors和results。结果表同时按FAO（2026）对仅基于渔获量结果的两级分类和Palomares等（2018）的五级分类给出状态。

English

Invisibly, a list with the data frames priors and results. The results give the status in the two classes of FAO (2026) for catch-only results and in the five classes of Palomares et al. (2018).

参考文献

FAO (2026). The State of World Fisheries and Aquaculture 2026. Rome, FAO. Section “The status of fishery resources”, Box 1.3 (assessment tiers and status classes). https://openknowledge.fao.org/server/api/core/bitstreams/09d03e2f-7097-4d59-bf94-db65e95f44fd/content/sofia-2026/the-status-fishery-resources.html

Palomares, M.L.D., Froese, R., Derrick, B., Noel, S.-L., Tsui, G., Woroniak, J. and Pauly, D. (2018). A preliminary global assessment of the status of exploited marine fish and invertebrate populations. A report prepared by the Sea Around Us for OCEANA. University of British Columbia and GEOMAR. https://www.fishbase.de/rfroese/OceanaFinalReport_V7a.pdf

示例 

# result <- cmsy_run(...), see cmsy_run()
tables <- cmsy_tables(result, lang = "zh")       # also saved in tables/cmsy/
tables$priors
tables$results

# Column names in both languages, without saving
cmsy_tables(result, lang = "both", table = FALSE)$results