# 数据说明｜案例 02 降水异常与气象干旱的时空聚集分析

## 先看结论

这份数据说明把“随包文件”和“需要从官方平台另行下载的数据”分开列出。随包文件是公开数据原文件或从原文件裁出的真实像元样片；来源、版本、许可、字节数和 SHA-256 记录在 `../references/DATASET_MANIFEST.csv`。

**Notebook 当前仍使用固定随机种子生成的合成输入。** 随包真实数据不会自动替换 Notebook 输入；因此 Notebook 图表是算法演示结果，不能当作这些真实文件的统计结论。

## 随包可以直接使用的数据文件

- `data/verified_samples/chirps-v2.0.2023.11.tif.gz`（14,589,662 B）：随包提供官方完整全球月降水文件 14589662 B；SHA-256 0b00019ad160e75dfe495cb74b7ddceacfea02e126323c1a07ac982610bbb73b；gzip 与 GeoTIFF 签名已验证。使用时请保留 CHIRPS 来源和论文引用。
- `data/verified_samples/chirps-v2.0.2023.11_clip_110p5_111p5E_27_28N.tif`（2,998 B）：官方源文件 chirps-v2.0.2023.11.tif.gz：14589662 B，SHA-256 0b00019ad160e75dfe495cb74b7ddceacfea02e126323c1a07ac982610bbb73b；随包样片范围 110.5–111.5°E、27–28°N，20×20 像元，CRS EPSG:4326；样片 2998 B，SHA-256 538e3e7d8550fb3e95e15ab9cf418856f6f9147df25fecdeacb025498f9d3030。完整原始文件按 source_url 下载。
- `data/verified_samples/chirps-v2.0.2023.12.tif.gz`（14,597,702 B）：随包提供官方完整全球月降水文件 14597702 B；SHA-256 ebfd5b474246be52389c620c48e8f2be9357f69df2b2c7b0dd0ece99ffaa92e0；gzip 与 GeoTIFF 签名已验证。使用时请保留 CHIRPS 来源和论文引用。
- `data/verified_samples/chirps-v2.0.2023.12_clip_110p5_111p5E_27_28N.tif`（2,998 B）：官方源文件 chirps-v2.0.2023.12.tif.gz：14597702 B，SHA-256 ebfd5b474246be52389c620c48e8f2be9357f69df2b2c7b0dd0ece99ffaa92e0；随包样片范围 110.5–111.5°E、27–28°N，20×20 像元，CRS EPSG:4326；样片 2998 B，SHA-256 d34de4f41c50fc42607db36301d880d82aba6fbb7fa36aa73602f10b9818af3e。完整原始文件按 source_url 下载。
- `data/verified_samples/chirps-v2.0.2024.01.tif.gz`（14,493,531 B）：随包提供官方完整全球月降水文件 14493531 B；SHA-256 c2087dfdd414ef85884f3d1e815c18b221b370d4f0d647f0f9b8ef4934a9e5b8；gzip 与 GeoTIFF 签名已验证。使用时请保留 CHIRPS 来源和论文引用。
- `data/verified_samples/chirps-v2.0.2024.01_clip_110p5_111p5E_27_28N.tif`（3,054 B）：官方源文件 chirps-v2.0.2024.01.tif.gz：14493531 B，SHA-256 c2087dfdd414ef85884f3d1e815c18b221b370d4f0d647f0f9b8ef4934a9e5b8；随包样片范围 110.5–111.5°E、27–28°N，20×20 像元，CRS EPSG:4326；样片 3054 B，SHA-256 2f11b4df461653168a14ad9a8b98c5700340fa26a71f52f54f0ff6e7de941b57。完整原始文件按 source_url 下载。

## 需要下载的数据和具体入口

### CHIRPS v2.0 月降水

- 官方产品说明：[打开产品页](https://www.chc.ucsb.edu/data/chirps)
- 下载或检索入口：[打开官方入口](https://data.chc.ucsb.edu/products/CHIRPS-2.0/global_monthly/tifs/)
- 下载范围和参数：CHIRPS global_monthly/tifs：本包提供 2023-11、2023-12、2024-01 完整文件和真实像元样片；完整 SPI-3 研究请从同一目录下载连续至少30年月文件。

### CHIRPS v2.0 月降水

- 官方产品说明：[打开产品页](https://www.chc.ucsb.edu/data/chirps)
- 下载或检索入口：[打开官方入口](https://data.chc.ucsb.edu/products/CHIRPS-2.0/global_monthly/tifs/chirps-v2.0.2023.11.tif.gz)
- 下载范围和参数：随包提供官方完整全球月降水文件 14589662 B；SHA-256 0b00019ad160e75dfe495cb74b7ddceacfea02e126323c1a07ac982610bbb73b；gzip 与 GeoTIFF 签名已验证。使用时请保留 CHIRPS 来源和论文引用。
- 随包文件/样片：`data/verified_samples/chirps-v2.0.2023.11.tif.gz`；如需完整序列，按官方链接获取。

### CHIRPS v2.0 月降水

- 官方产品说明：[打开产品页](https://www.chc.ucsb.edu/data/chirps)
- 下载或检索入口：[打开官方入口](https://data.chc.ucsb.edu/products/CHIRPS-2.0/global_monthly/tifs/chirps-v2.0.2023.12.tif.gz)
- 下载范围和参数：随包提供官方完整全球月降水文件 14597702 B；SHA-256 ebfd5b474246be52389c620c48e8f2be9357f69df2b2c7b0dd0ece99ffaa92e0；gzip 与 GeoTIFF 签名已验证。使用时请保留 CHIRPS 来源和论文引用。
- 随包文件/样片：`data/verified_samples/chirps-v2.0.2023.12.tif.gz`；如需完整序列，按官方链接获取。

### CHIRPS v2.0 月降水

- 官方产品说明：[打开产品页](https://www.chc.ucsb.edu/data/chirps)
- 下载或检索入口：[打开官方入口](https://data.chc.ucsb.edu/products/CHIRPS-2.0/global_monthly/tifs/chirps-v2.0.2024.01.tif.gz)
- 下载范围和参数：随包提供官方完整全球月降水文件 14493531 B；SHA-256 c2087dfdd414ef85884f3d1e815c18b221b370d4f0d647f0f9b8ef4934a9e5b8；gzip 与 GeoTIFF 签名已验证。使用时请保留 CHIRPS 来源和论文引用。
- 随包文件/样片：`data/verified_samples/chirps-v2.0.2024.01.tif.gz`；如需完整序列，按官方链接获取。

## 下载后按这个顺序检查

1. 先核对产品编号/版本、年份、变量或波段、研究区和瓦片；不要只凭文件名判断数据正确。
2. 用 GIS 软件或 Python 读取 CRS、分辨率、范围、NoData、单位和 QA 标记；不同数据先统一空间范围、时间和有效像元规则。
3. 记录下载日期、官方页面、产品版本、筛选条件和 SHA-256。Earthdata、CDS、USGS EarthExplorer、Protected Planet 的数据需要账号或许可时，按页面要求登录或申请；产品页面返回 200 不等于已下载数据。
4. 只有准备好连续时间序列、共同 AOI 和质量掩膜后，才运行完整的趋势、聚集、物候、火烧或脆弱性分析。单月或裁剪样片只用于文件读取和接入练习。

## 数据许可和再分发

逐文件的署名、许可和是否允许随包分发，以 `../references/DATASET_MANIFEST.csv` 与 `../references/来源与许可.csv` 为准。需要账号、申请或许可的数据只给官方入口；请勿把登录后取得的数据重新上传或二次分发，除非该产品条款明确允许。

## 文件核验记录

全库路径、原始下载来源、裁剪前后大小、SHA-256 与状态见 `../../00_规划/DATA_CATALOG_15案.csv`、`../../00_规划/DOWNLOAD_MANIFEST_15案.csv` 和 `../../00_规划/REAL_DATA_SAMPLE_PROVENANCE.json`。