METBRA25Y：巴西表面气象档案，包含 harmonized 变量与质量控制

本数据论文描述 METBRA25Y，这是一个来自巴西 Instituto Nacional de Meteorologia (INMET) 的公开历史记录衍生的 hourly surface meteorological observations 的 harmonized archive。该数据集旨在支持需要 station-level 气象 time series 且具有 standardized variable names 和 explicit quality-control metadata 的环境、气候、水文、农业、城市风险及机器学习研究。处理工作流程摄取年度 INMET archives，解析 station metadata 从 raw file headers，将异构的葡萄牙语列名规范化为 canonical schema，构建 hourly timestamps，按 city 和 station 合并 observation，并导出压缩 CSV 文件以及 station manifests、per-station quality flags、daily precipitation aggregates、variable-level failure summaries、missing-data audits。质量控制协议遵循 two-stage strategy：首先，将物理上不合理的值转换为 missing values 并添加 flag；其次，进行 temporal 和 cross-variable consistency 检查生成诊断 flag，而不必覆盖写入原始 measurement。最终得到的包覆盖 2000 年至 2025 年的观测数据，具有 station-specific temporal coverage，包括 precipitation、air temperature、dew point、relative humidity、atmospheric pressure、wind speed、wind gust、wind direction、global solar radiation 等关键气象变量。基于本发行版 snapshot 中的 summary 文件，archive 包含 616 个 unique station codes，其中 605 个坐标位于巴西合理范围内。本文记录了数据来源、文件组织、harmonized schema、quality-control 规则、technical validation 输出、limitations 以及推荐使用实践。