# 数据字典：一周的地震目录记录

这份字典只解释练习中使用的字段；`earthquakes.csv` 保留了 USGS API 导出的全部原始列。**一行表示目录中的一次地震事件**，不是一个人、一台仪器或一天的地震总数。文件来自 2026 年 9 月 25 日（UTC）的固定下载，覆盖 2026 年 8 月 1–7 日 UTC、全球报告震级至少 4.5 的 155 条记录。每条记录的 `id` 不同。这些解释为课堂简化版；科学分析应参照 [USGS 地震目录](https://earthquake.usgs.gov/data/comcat/)及 [FDSN 事件 API](https://earthquake.usgs.gov/fdsnws/event/1/1) 文档。

| 字段 | 含义 | 单位或格式 | 本练习中的用途 |
| --- | --- | --- | --- |
| `id` | 目录给事件的标识符 | 文本 | 检查是否把同一事件重复算入。 |
| `time` | 事件起始时间的估计值 | UTC 的 ISO 8601 时间，例如 `2026-08-01T00:39:22.320Z` | 取前十个字符作为 UTC 日期；当地日期可能不同。 |
| `mag` | 报告的震级数值 | 数字 | 原查询选出 4.5+；再筛选 5.0+。震级不直接表示损失程度。 |
| `magType` | 报告震级所用的方法 | 文本，如 `mb` 或 `mww` | 提醒学生文件混合了不同方法；本短练习不转换这些方法。 |
| `depth` | 估计震源深度 | 千米 | 可选：比较平均数与中位数；单一深度摘要不能判断风险。 |
| `place` | 便于阅读的地点描述 | 文本 | 帮助读懂一行；不是精确的地理边界。 |
| `status` | 下载时 USGS 的审核状态 | 文本：`reviewed` | 155 条当时均标为已审核；这不代表目录完整或不会再改。 |
| `type` | 目录中的事件类型 | 文本：`earthquake` | 确认这 155 条在目录中均标为地震。 |

本数据按震级下限、一周时间窗口、全球范围及下载时的目录状态筛选，可能漏掉较小事件；日后目录也可能修订。不能只凭这份文件判断长期趋势、成因或当地风险。CSV 的 SHA-256：`6493902079340c728403aa09928826a377dbfb040f78ad51d60f2ad30a7b0acb`。

如需重做筛选，可向 FDSN 事件 API 使用参数 `format=csv&starttime=2026-08-01&endtime=2026-08-08&minmagnitude=4.5&orderby=time-asc`。重新查询可能得到修订后的记录；附带的 CSV 是供课堂使用的固定快照。

由 [Telemetry](https://telemetry.sh/) 创建者 JR 借助 AI 编写。尚未在课堂试用，也未经中文教师审阅。USGS 未为本教学材料背书。无需 Telemetry 账号或学生个人数据。