Data and versions - Linbojun99/faofishingreport GitHub Wiki
数据与版本 · Data and versions
FAO全球捕捞产量统计 · FAO Global Capture Production
| 包内自带版本 Bundled release | 2026.1.0(1950–2024年),FAO于2026年3月30日发布 |
| 来源 Source | FAO Global Capture Production,FishStatJ数据集 |
| 许可 Licence | CC BY 4.0 |
check_fao_update() # 网上最新版本与本机数据对比
download_fao_data() # 下载最新版本(也可指定版本,如"2025.1.0")
load_fao_data() # 读取最新的数据(下载的或包自带的)
fao_data_info() # 所用版本、发布日期、下载链接和引用格式
compare_releases(...) # 比较两个版本之间修订、新增和删除的记录
所有分析函数默认使用本机最新的版本;fishing_area_data()、area_overview()和fao_report()可以用data_version指定版本("latest"、"bundled"或如"2026.1.0")。网站每篇文章开头都写明了所用的版本和下载链接。
All analyses use the newest release available; data_version chooses another. Every page of the website states the release used.
FishBase与SeaLifeBase · FishBase and SeaLifeBase
-
包内自带一个物种特征表(FishBase和SeaLifeBase 26.06),离线时也能使用。A trait table from FishBase and SeaLifeBase 26.06 is bundled for offline use.
-
check_fishbase_update()、download_fishbase_data()下载数据表的快照(parquet文件),默认只下载本包所需的表(约30 MB)。这些快照由rOpenSci的rfishbase项目发布:源代码 https://github.com/ropensci/rfishbase,数据文件 https://data.source.coop/cboettig/fishbase/,引用Boettiger, Lang & Wainwright (2012), Journal of Fish Biology 81(6): 2030–2039, doi:10.1111/j.1095-8649.2012.03464.x。The snapshots are published by the rfishbase project of rOpenSci. -
fishbase_match()按公开的规则逐条匹配FAO物种条目,每一行都给出规则来源和链接;fishbase_sources()列出来源、许可协议和匹配规则。 -
许可:FishBase和SeaLifeBase为CC BY-NC 4.0(FishBase.org team),引用Froese & Pauly (Eds.)和Palomares & Pauly (Eds.)。
-
中文名(0.6.0起):FAO名录中没有中文名、且只对应一个物种的条目,使用FishBase和SeaLifeBase中给中国的简体中文俗名(1144个条目,FAO名称始终优先),名称表为
inst/extdata/species_names_zh_fishbase.csv,由data-raw/build_species_names_zh.R生成,数据来自rfishbase读取的FishBase数据表。Species items without an FAO Chinese name take the Chinese common name of FishBase or SeaLifeBase (simplified characters, names given for China).
详见FishBase文章(English)。
海表温度 · Sea surface temperature
- 包内自带NOAA ERSST v5(2°×2°,1950–2025年)各FAO渔区的逐年海表温度。NOAA ERSST v5 is bundled.
download_sst_data()可下载HadISST1、COBE-SST2或OISST v2.1,或补充ERSST v5新发布的年份;也可以用自己的NetCDF文件(fao_area_sst(sst = "路径"))。fao_sst_products()列出各产品及其参考文献。
详见海表温度与渔获平均温度(English)。
引用 · Citation
fao_data_info()$citation # 所用FAO数据的引用
citation("faofishingreport") # 本包的引用
cmsy_sources() # CMSY++各组成部分的版本、链接和引用
fishbase_sources() # FishBase、SeaLifeBase、rfishbase快照和WoRMS的来源、许可和匹配规则