47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
---
|
||
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为全部 |
|