2imi9/us-power-climate-data-streamflow

--- dataset_info: features: - name: date dtype: timestamp[ns, tz=UTC] - name: plant_code dtype: int64 - name: gauge_id dtype: string - name: discharge_cfs dtype: float64 - name: gauge_lat dtype: float64 - name: gauge_lon dtype: float64 splits: - name: train num_bytes: 684740 num_examples: 13140 download_size: 162361 dataset_size: 684740 configs: - config_name: default data_files: - split: train path: data/train-* --- # USGS Streamflow Near U.S. Power Plants (2022–2023) This dataset provides daily streamflow observations from the U.S. Geological Survey (USGS) National Water Information System (NWIS) for rivers and streams located near a sampled subset of U.S. electric power plants. It is intended for studies of hydrologic constraints on power generation, climate vulnerability analysis, and machine-learning applications requiring hydrology–infrastructure relationships. ## Contents The dataset includes: * 13,140 daily streamflow records * 18 matched USGS gauges * 50 power plants sampled from the EIA-860 registry * Daily streamflow from 2022-01-01 to 2023-12-31 (where available) Each record represents the discharge at the nearest available USGS gauge to a specific power plant on a specific day. ## Variables | Column | Description | | ----------------- | --------------------------------------------------- | | **date** | Timestamp of observation (UTC, daily mean) | | **plant_code** | EIA plant identifier (from EIA-860 plant registry) | | **gauge_id** | USGS site identifier | | **discharge_cfs** | Mean daily discharge in cubic feet per second (CFS) | | **gauge_lat** | Latitude of USGS gauge (WGS84) | | **gauge_lon** | Longitude of USGS gauge (WGS84) | ## Methodology 1. For each sampled power plant, a bounding box of ±0.5° latitude/longitude was used to search for USGS gauges with daily discharge data (`parameterCd = 00060`). 2. If multiple gauges were found, the closest in geographic distance was selected. 3. Daily discharge was retrieved for January 1, 2022 through December 31, 2023. 4. Observations were merged with plant identifiers for cross-analysis. ## Source * **USGS National Water Information System (NWIS)** Daily Discharge (Parameter 00060) [https://waterdata.usgs.gov/nwis](https://waterdata.usgs.gov/nwis) ## Processing Notes * Only gauges with available daily discharge time series were retained. * Some plants have no nearby gauge; resulting dataset includes streamflow for 18 of 50 sampled plants. * All timestamps were converted to pandas datetime format for consistency. * All columns use lowercase snake_case formatting. ## Citation If you use this dataset, please cite: **2imi9. USGS Streamflow Near U.S. Power Plants (2022–2023). Hugging Face Datasets.** [https://huggingface.co/datasets/2imi9/us-power-climate-data-streamflow](https://huggingface.co/datasets/2imi9/us-power-climate-data-streamflow)数据集信息： 特征： - 名称：date 数据类型：时间戳（纳秒级，时区为协调世界时UTC） - 名称：plant_code 数据类型：64位整数 - 名称：gauge_id 数据类型：字符串 - 名称：discharge_cfs 数据类型：64位浮点数 - 名称：gauge_lat 数据类型：64位浮点数 - 名称：gauge_lon 数据类型：64位浮点数 划分集： - 名称：train（训练集） 字节数：684740 样本数：13140 下载大小：162361 数据集总大小：684740 配置： - 配置名称：default（默认配置） 数据文件： - 划分集：train 路径：data/train-* # 美国电厂附近地表径流数据集（2022–2023年） 本数据集源自美国地质调查局（U.S. Geological Survey, USGS）国家水信息系统（National Water Information System, NWIS），收录了美国采样电力电厂周边河流与溪流的每日地表径流观测数据，可用于发电水文约束研究、气候脆弱性分析，以及需依托水文-基础设施关联关系的机器学习应用。 ## 数据集内容 本数据集包含： * 13140条每日地表径流记录 * 18个匹配的USGS水文测站 * 从EIA-860注册库中选取的50座电厂 * 2022年1月1日至2023年12月31日的每日地表径流（数据可用时） 每条记录代表特定日期下，距离某座指定电厂最近的可用USGS测站的径流量。 ## 变量说明 | 列名 | 描述 | | ----------------- | --------------------------------------------------- | | **date** | 观测时间戳（协调世界时UTC，日均值） | | **plant_code** | EIA电厂标识符（源自EIA-860电厂注册库） | | **gauge_id** | USGS测站站点标识符 | | **discharge_cfs** | 以立方英尺每秒（CFS）为单位的日平均径流量 | | **gauge_lat** | USGS测站纬度（WGS84坐标系） | | **gauge_lon** | USGS测站经度（WGS84坐标系） | ## 构建方法 1. 针对每座采样电厂，以±0.5°的经纬度范围作为边界框，搜索携带每日径流量数据（参数代码`parameterCd = 00060`）的USGS测站。 2. 若找到多个测站，则选取地理距离最近的一个。 3. 获取2022年1月1日至2023年12月31日的每日径流量数据。 4. 将观测数据与电厂标识符进行合并，以支持交叉分析。 ## 数据来源 * **美国地质调查局国家水信息系统（NWIS）** 每日径流量数据（参数代码00060） [https://waterdata.usgs.gov/nwis](https://waterdata.usgs.gov/nwis) ## 处理说明 * 仅保留拥有可用每日径流量时间序列的测站。 * 部分电厂周边无可用测站，最终数据集仅包含50座采样电厂中18座的径流量数据。 * 为保证数据一致性，所有时间戳均转换为pandas datetime格式。 * 所有列均采用小写蛇形命名法（snake_case）。 ## 引用要求 若使用本数据集，请引用如下文献： **2imi9. 美国电厂附近地表径流数据集（2022–2023年）. Hugging Face 数据集.** [https://huggingface.co/datasets/2imi9/us-power-climate-data-streamflow](https://huggingface.co/datasets/2imi9/us-power-climate-data-streamflow)