Quick start

快速入门 · Quick start

以东北大西洋（FAO 27渔区）为例的完整流程；每一步的详细说明、图表和参数表见网站的快速入门（English）。

A complete first analysis of the Northeast Atlantic (FAO area 27); see Get started for every chart and argument.

library(faofishingreport)
fao_settings(lang = "zh")        # 图表用中文；"en"英文，"both"中英双语
# 每个函数运行完在控制台显示结果摘要；结果赋值保存。plot_show = TRUE 时同时在 Plots 窗格显示图
# Each function shows a summary in the console; assign the result to keep it. plot_show = TRUE also draws the charts

# 1. 数据 Data：检查并下载FAO最新版本（FAO发布新版本时才需要）
check_fao_update()
download_fao_data()
fao_data_info()                  # 所用的版本、下载链接和引用格式

# 2. 渔区 Fishing areas：全部FAO主要渔区，27区及其亚区（安装ggOceanMaps时显示水深）
fao_areas()
fishing_area_map(27)

#    27区的总产量、突变点、占全球海洋捕捞产量的比例、地图
FAO27 <- fishing_area_data("Atlantic, Northeast")
species <- fishing_area_species(FAO27$area_data, rank_range = 1:10)   # 前十名；c(5, 6)为第五和第六名
countries <- fishing_area_country(FAO27$area_data, rank_range = 1:10)

# 3. 物种与国家 Species and countries
species_country(FAO27$area_data, "Atlantic cod")
country_species(FAO27$area_data, "Norway")

# 4. 汇总分析 Summary analyses
species_group_composition(FAO27$area_data)
stock_status(FAO27$area_data)
data_quality(FAO27$area_data)
diversity_concentration(FAO27$area_data)
coastal_distant(FAO27$area_data)

# 5. 文献方法 Methods from the literature
catch_shocks(FAO27$area_data)
collapse_analysis(FAO27$area_data)
catch_synchrony(FAO27$area_data)
pelagic_demersal(FAO27$area_data)
mean_temperature_catch(FAO27$area_data, version = "builtin")

# 6. 资源评估 Stock assessment（先运行一次cmsy_setup()）
cmsy_area("Atlantic, Northeast", top = 10)

# 7. 报告 Report：一键生成Word评估报告
report <- fao_report(27, lang = "zh")

想要一个完整、每张图都有讲解的示例？请看🎓 教程：东北太平洋（FAO 67区）从零到报告（English）。

结果保存在哪里 · Where the results go

• 图表 Charts：figures/png/（可选可编辑的PowerPoint：figures/pptx/）
• 表格 Tables：tables/
• 报告 Reports：reports/
• CMSY++：cmsy_areas/<渔区>/（cmsy_area()）或报告旁的cmsy/（fao_report(cmsy = TRUE)）

下一步 · Next

主题 Topic	中文	English
FAO数据：下载与自定义	中文	English
渔区分析	中文	English
物种与国家	中文	English
类群结构、资源状态与趋势	中文	English
数据质量、多样性与船队	中文	English
渔获骤变、崩溃、同步性与远洋捕捞	中文	English
海表温度与渔获平均温度	中文	English
FishBase与SeaLifeBase物种特征	中文	English
CMSY++资源评估	中文	English
Word评估报告	中文	English
自定义图表与地图	中文	English