74 lines
7.2 KiB
Markdown
74 lines
7.2 KiB
Markdown
---
|
|
name: tjwater-action-analytics-simulation-analysis-simulation
|
|
description: analytics/simulation-analysis 下 simulation 操作技能。
|
|
version: 3.0.0
|
|
---
|
|
|
|
# simulation Action Skill
|
|
|
|
## 简介
|
|
负责 `analytics/simulation-analysis` 场景下 `simulation` 的具体接口调用。
|
|
|
|
## 子模块索引 (渐进式引导)
|
|
- 当前为叶子节点，直接使用下方接口目录。
|
|
|
|
## 接口目录
|
|
| Method | Path | Summary | Required Params | Optional Params |
|
|
|---|---|---|---|---|
|
|
| GET | `/api/v1/runproject/` | 运行项目模拟 | network (query) | - |
|
|
| GET | `/api/v1/runprojectreturndict/` | 运行项目模拟（返回字典） | network (query) | - |
|
|
| GET | `/api/v1/runinp/` | 运行INP文件 | network (query) | - |
|
|
| GET | `/api/v1/dumpoutput/` | 导出模拟输出 | output (query) | - |
|
|
| GET | `/api/v1/burstanalysis/` | 爆管分析（基础） | network (query), pipe_id (query), start_time (query), end_time (query), burst_flow (query) | - |
|
|
| GET | `/api/v1/burst_analysis/` | 爆管分析（高级） | network (query), modify_pattern_start_time (query), burst_ID (query), burst_size (query), modify_total_duration (query), scheme_name (query) | - |
|
|
| GET | `/api/v1/valvecloseanalysis/` | 阀门关闭分析（基础） | network (query), valve_id (query), start_time (query), end_time (query) | - |
|
|
| GET | `/api/v1/valve_close_analysis/` | 阀门关闭分析（高级） | network (query), start_time (query), valves (query) | duration (query) |
|
|
| GET | `/api/v1/valve_isolation_analysis/` | 阀门隔离分析 | network (query), accident_element (query) | disabled_valves (query) |
|
|
| GET | `/api/v1/flushinganalysis/` | 冲洗分析（基础） | network (query), pipe_id (query), start_time (query), duration (query), flow (query) | - |
|
|
| GET | `/api/v1/flushing_analysis/` | 冲洗分析（高级） | network (query), start_time (query), valves (query), valves_k (query), drainage_node_ID (query) | flush_flow (query), duration (query), scheme_name (query) |
|
|
| GET | `/api/v1/contaminant_simulation/` | 污染物模拟 | network (query), start_time (query), source (query), concentration (query), duration (query) | scheme_name (query), pattern (query) |
|
|
| GET | `/api/v1/ageanalysis/` | 水龄分析（基础） | network (query) | - |
|
|
| GET | `/api/v1/age_analysis/` | 水龄分析（高级） | network (query), start_time (query), end_time (query), duration (query) | - |
|
|
| GET | `/api/v1/pressureregulation/` | 压力调节（基础） | network (query), target_node (query), target_pressure (query) | - |
|
|
| POST | `/api/v1/pressure_regulation/` | 压力调节（高级） | data (body) | - |
|
|
| GET | `/api/v1/projectmanagement/` | 项目管理（基础） | network (query) | - |
|
|
| POST | `/api/v1/project_management/` | 项目管理（高级） | data (body) | - |
|
|
| POST | `/api/v1/scheduling_analysis/` | 排程分析 | data (body) | - |
|
|
| POST | `/api/v1/daily_scheduling_analysis/` | 日排程分析 | data (body) | - |
|
|
| POST | `/api/v1/network_project/` | 导入网络项目 | file (file) | - |
|
|
| GET | `/api/v1/networkupdate/` | 管网更新（基础） | network (query) | - |
|
|
| POST | `/api/v1/network_update/` | 管网更新（高级） | file (file) | - |
|
|
| POST | `/api/v1/pump_failure/` | 泵故障管理 | data (body) | - |
|
|
| GET | `/api/v1/pressuresensorplacementsensitivity/` | 压力传感器放置-灵敏度分析（基础） | name (query), scheme_name (query), sensor_number (query), min_diameter (query), username (query) | - |
|
|
| POST | `/api/v1/pressure_sensor_placement_sensitivity/` | 压力传感器放置-灵敏度分析（高级） | data (body) | - |
|
|
| GET | `/api/v1/pressuresensorplacementkmeans/` | 压力传感器放置-KMeans聚类分析（基础） | name (query), scheme_name (query), sensor_number (query), min_diameter (query), username (query) | - |
|
|
| POST | `/api/v1/pressure_sensor_placement_kmeans/` | 压力传感器放置-KMeans聚类分析（高级） | data (body) | - |
|
|
| POST | `/api/v1/sensorplacementscheme/create` | 传感器放置方案创建 | network (query), scheme_name (query), sensor_type (query), method (query), sensor_count (query), user_name (query) | min_diameter (query) |
|
|
| POST | `/api/v1/runsimulationmanuallybydate/` | 手动运行日期指定模拟 | data (body) | - |
|
|
|
|
- 覆盖方法：`GET, POST`
|
|
|
|
## 接口说明
|
|
|
|
| 接口 | 说明 |
|
|
|---|---|
|
|
| `GET /runproject/` | 运行标准水力模拟，返回纯文本格式的模拟报告 |
|
|
| `GET /runprojectreturndict/` | 运行标准水力模拟，返回JSON字典（含节点/管段结果数据），适合程序处理；结果可达30MB+ |
|
|
| `GET /runinp/` | 运行指定INP文件（文件放在inp文件夹中，参数为不含扩展名的文件名）进行水力模拟 |
|
|
| `GET /dumpoutput/` | 导出指定绝对路径的模拟输出文件内容 |
|
|
| `GET /burstanalysis/` | 基础爆管分析：对指定管道指定时间范围内的爆管事件进行分析，评估对压力/流量的影响 |
|
|
| `GET /burst_analysis/` | 高级爆管分析：支持在指定时间点修改泵控制模式和阀门开度，分析干预措施对爆管影响的作用；支持固定泵和变速泵独立控制 |
|
|
| `GET /valve_close_analysis/` | 高级阀门关闭分析：支持同时关闭多个阀门，指定持续时间，返回纯文本格式结果 |
|
|
| `GET /valve_isolation_analysis/` | 阀门隔离分析：分析突发事件时通过关闭指定阀门进行隔离，确定必须关闭阀门、可选关闭阀门及隔离可行性 |
|
|
| `GET /flushing_analysis/` | 高级冲洗分析：支持同时开启多个阀门冲洗，指定排污节点，设置固定冲洗流量，返回纯文本结果 |
|
|
| `GET /contaminant_simulation/` | 污染物模拟：评估污染源对管网的影响范围和浓度分布，支持指定污染位置、浓度和扩散模式 |
|
|
| `GET /age_analysis/` | 高级水龄分析：在指定时间点分析水体停留时间，支持自定义模拟持续时间，返回纯文本结果 |
|
|
| `POST /pressure_regulation/` | 高级压力调节：通过JSON体提供详细控制参数（固定泵/变速泵独立控制、水箱初始水位等）进行压力优化 |
|
|
| `POST /project_management/` | 高级项目管理：通过JSON体提供详细参数（泵控制策略、水箱水位、区域需水量控制）进行管网管理 |
|
|
| `POST /scheduling_analysis/` | 排程分析：优化泵运行时间和出水流量，平衡水厂出水、水箱进出水，满足用户需求 |
|
|
| `POST /daily_scheduling_analysis/` | 日排程分析：优化水库、水厂、水箱和用户需求协调，制定合理的每日排程方案 |
|
|
| `POST /pump_failure/` | 泵故障管理：记录故障发生时间和受影响的泵列表，更新泵状态日志 |
|
|
| `POST /pressure_sensor_placement_sensitivity/` | 高级传感器放置（灵敏度法）：通过JSON体提供详细参数，基于灵敏度矩阵确定最优放置位置 |
|
|
| `POST /pressure_sensor_placement_kmeans/` | 高级传感器放置（KMeans法）：通过JSON体提供详细参数，基于聚类算法确定最优放置位置 |
|
|
| `POST /sensorplacementscheme/create` | 创建传感器放置方案：支持 sensitivity 和 kmeans 两种算法，自动计算最优传感器位置并存储方案 |
|
|
| `POST /runsimulationmanuallybydate/` | 按日期手动运行模拟：根据指定日期、开始时间和持续时间查询管网参数并执行水力模拟 | |