---
name: tjwater-action-analytics-simulation-analysis-leakage
description: analytics/simulation-analysis 下 leakage 操作技能。
version: 3.0.0
---

# leakage Action Skill

## 简介
负责 `analytics/simulation-analysis` 场景下 `leakage` 的具体接口调用。

## 子模块索引 (渐进式引导)
- 当前为叶子节点，直接使用下方接口目录。

## 接口目录
| Method | Path | Summary | Required Params | Optional Params |
|---|---|---|---|---|
| POST | `/api/v1/leakage/identify/` | 执行漏损识别 | data (body) | - |
| GET | `/api/v1/leakage/schemes/` | 查询漏损识别方案列表 | network (query) | query_date (query) |
| GET | `/api/v1/leakage/schemes/{scheme_name}` | 获取漏损识别方案详情 | network (query), scheme_name (path) | - |

- 覆盖方法：`GET, POST`

## 接口说明

| 接口 | 说明 |
|---|---|
| `POST /identify/` | 基于压力观测数据和遗传算法识别管网中的漏损位置和大小。通过对比模型计算与实测压力数据，迭代优化找到最匹配的漏损节点和漏水量。 |
| `GET /schemes/` | 获取指定管网的所有漏损识别方案列表，可通过 query_date 按日期筛选。 |
| `GET /schemes/{scheme_name}` | 获取指定名称的漏损识别方案详细配置，包含传感器节点、算法参数等。 |

## 请求体关键字段（POST /identify/）

| 字段 | 类型 | 说明 |
|---|---|---|
| `network` | str | 管网名称（数据库名） |
| `observed_pressure_data` | str/dict/list/null | 观测压力数据 |
| `start_time` | float | 起始时间（小时），默认0 |
| `duration` | float | 持续时间（小时），默认24 |
| `timestep` | float | 时间步长（分钟），默认5 |
| `q_sum` | float | 总流量（m³/s），默认0.2 |
| `pop_size` | int | 遗传算法种群大小，默认50 |
| `max_gen` | int | 遗传算法最大代数，默认100 |
| `n_workers` | int | 并行工作线程数，默认CPU数-1（最大4） |
| `scada_start` / `scada_end` | datetime/null | 从SCADA数据库查询的时间范围 |
| `sensor_nodes` | list/null | 传感器节点列表，null为全部 |