用途
BSEE/SODIR Data Extraction Skill 面向海上能源数据分析，用于从两个监管机构的数据源提取和处理数据：美国安全与环境执法局（BSEE，覆盖墨西哥湾）和挪威海上管理局（SODIR）。资料将其定位为支持综合海上能源分析的数据提取技能。
主要能力
BSEE（美国墨西哥湾）数据提取
资料列出的可用数据集包括：产量数据（按月统计的油/气/水）、井数据（API 编号、定向测量）、平台/结构数据、运营商信息、安全与事件数据（OCS 事件）以及环境合规数据。
资料给出了基础 URL 字典：
BSEE_BASE_URLS = {
"production": "https://www.data.bsee.gov/Production/",
"well": "https://www.data.bsee.gov/Well/",
"platform": "https://www.data.bsee.gov/Platform/",
"company": "https://www.data.bsee.gov/Company/",
"field": "https://www.data.bsee.gov/Field/",
"incidents": "https://www.data.bsee.gov/Incidents/",
}
产量数据提取函数 fetch_bsee_production_data 接受年份、输出目录和可选的区域代码（如 'GC'、'MC'、'WR'），从 https://www.data.bsee.gov/Production/Files/ogoraan{year}.zip 下载压缩文件，解压后读取 CSV、按区域过滤、清理列名并附加提取日期与来源元数据。
聚合函数 aggregate_production_by_field 可按月、季度或年度按油田（字段、区域代码、区块编号）聚合产量，聚合项包括 OIL_BBL、GAS_MCF、WATER_BBL 以及井数（若存在 API 编号则用 nunique，否则用 count）。
井数据方面，fetch_bsee_well_data 从 https://www.data.bsee.gov/Well/Files/Well.zip 下载井数据，可按 14 位 API 编号或油田名称过滤；fetch_directional_surveys 从定向测量数据压缩包读取数据并按 API 编号过滤、按测量深度排序。
HSE 数据方面，fetch_bsee_incident_data 从 https://www.data.bsee.gov/Incidents/Files/Accidents.zip 获取事故数据，按年月范围过滤；calculate_operator_safety_score 依据事故与产量数据计算每个运营商的安全指标，包括事故总数、死亡与受伤人数、总 BOE（油桶数加气量除以 6000）、每百万 BOE 事故数以及风险评分（风险评分越低越好，由每百万 BOE 事故数、死亡数乘 10、受伤数乘 2 相加得到），并按风险降序排列。
SODIR/NPD（挪威）数据提取
资料列出的可用数据集包括：油田产量（油、气、NGL、凝析油）、井数据（勘探、开发）、发现与潜力、公司信息、管道与基础设施。
SODIR 数据通过 SODIRDataFetcher 类访问，基础 URL 为 https://factpages.sodir.no/api/v1，端点包括：
ENDPOINTS = {
"fields": "/fields",
"field_production": "/field-production-yearly",
"wells": "/wells",
"discoveries": "/discoveries",
"companies": "/companies",
"pipelines": "/pipelines",
"facilities": "/facilities",
}
该类方法包括 get_all_fields（获取全部挪威海上油田）、get_field_production（可按油田名称、起止年份过滤）、get_wells（可按井类型 exploration/development/other 和状态过滤）、get_discoveries（可按状态过滤）。
组合分析
资料提供 compare_gom_norway_production 函数，将 BSEE 与 SODIR 产量数据按年份聚合后，用 Plotly 生成墨西哥湾与挪威的石油、天然气产量对比图，并输出为 HTML。
使用方式
资料中的示例用法包括：调用 fetch_bsee_production_data(year=2024, output_dir=Path("data/raw/bsee"), area_code="GC") 获取 2024 年 Green Canyon 区域产量并聚合；调用 fetch_bsee_well_data(field_name="THUNDER HORSE") 获取井数据；以 2020 至 2024 年事件数据与 2024 年产量数据计算运营商安全评分；以及用 SODIRDataFetcher 获取全部油田、Johan Sverdrup 产量和勘探井数据。
适用场景
资料列出的使用场景包括：产量数据（按油田/井的油、气、水产量）、井信息（定向测量、完井、钻井数据）、油田数据（储量、运营商、开发状态）、HSE 数据（安全事件、环境合规）、经济分析（使用监管数据进行 NPV 计算）以及监管合规（跟踪许可证、违规、检查）。
限制与缺失信息
资料未提供安装方式、依赖清单、许可授权、费用或价格信息，也未说明各数据源的更新频率、请求频率限制或数据字段的完整定义。以上内容暂未提供。