模型云开放接口
  1. 应用计算-新版
模型云开放接口
  • 文档说明
    • 应用集成
    • 阅读对象
    • 版本说明
    • 业务流程
  • 接口规则
    • 协议规则
    • 安全规范
  • 服务器API
    • 获取模型对象数据-新版
      • 通用
        • 获取指定类型对象列表
        • 获取面雨量(雨量站和权重)
        • 获取水工调度方案列表
        • 获取图层列表
        • 下载图层
        • 导出断面形状
      • 水文
        • 获取水文站的属性参数
        • 获取水库的属性参数
        • 获取子流域的模型参数
      • 率定
        • 获取率定场次列表
      • 一维
        • 获取一维水闸的闸孔列表
      • 管网
        • 获取排水泵参数
    • 应用计算-新版
      • 提交应用计算
        POST
      • 提交应用率定-自动率定
        POST
      • 停止计算
        POST
      • 获取计算状态详情
        GET
      • 获取计算日志-字符串
        GET
      • 提交自定义方案计算
        POST
      • 提交智能模型计算
        POST
    • 获取计算结果-新版
      • 通用
        • 获取解析后的文件路径
        • 获取计算结果目录
        • 获取计算结果文件
      • 水文
        • 获取水文模拟结果
      • 率定
        • 获取率定评定结果
        • 获取率定结果参数
        • 获取率定评定结果 V2
      • 一维
        • 获取一维结果的总体信息
        • 获取一维指定帧范围内所有断面的信息
        • 获取一维水闸信息
        • 获取一维水泵信息
        • 获取一维结果的总体信息 V2
        • 获取一维指定帧范围内所有断面的信息 V2
        • 获取一维蓄水池
      • 二维
        • 获取二维结果的总体信息
        • 获取二维指定帧范围内所有节点的信息
        • 获取二维指定帧范围内所有网格数据
        • 获取二维结果的总体信息 V2
        • 获取二维指定帧范围内所有节点的信息 V2
      • 管网
        • 获取管网模拟结果
        • 根据对象ID获取管网数据
        • 根据对象属性获取管网数据
    • 数据回调
      • 计算状态推送
  • 最佳实践
    • 管网项目实践
    • 城市内涝项目实践
    • 对接demo示例
    • 一维示例
      • 一维demo示例
    • 二维示例
      • 二维demo示例
    • 管网示例
      • 管网demo示例
    • 水文示例
      • 水文demo示例
  • 常见问题
    • 网格文件格式
  1. 应用计算-新版

提交应用率定-自动率定

POST
/api/mcc/v1/app/calib
最后修改时间：2024-04-29 01:26:43

前提条件#

已获取AK和SK，获取方法参见《安全规范.MD》
目前只支持水文模型的参数率定

请求参数

Header 参数
apiKey
string 
apiKey
必需
默认值:
{{apiKey}}
timestamp
string 
时间戳
必需
默认值:
{{timestamp}}
sign
string 
签名
必需
默认值:
{{sign}}
Body 参数application/json
calibConfigParams
object 
率定参数
可选
timeStep
enum<integer> 
时间步长(计算/输出)
可选
仅可输入1小时或24小时
枚举值:
124
optimizationAlgorithm
enum<string> 
优化算法
可选
枚举值:
MOEA.NSGAIIMOEA.eNSGAIIMOEA.OMOPSOMOEA.GAMOEA.DEMOEA.ESJGAP.GA
默认值:
MOEA.NSGAII
calibrationTimes
integer 
率定次数
可选
NSE
number 
纳什效率系数
可选
VE
number 
洪量系数
可选
PE
number 
洪峰系数
可选
NSE、VE、PE权重和要为1
calibrationSessions
array[string]
率定场次IDs
可选
选中参与计算的率定场次
calibSessionParams
array [object {5}] 
创建场次
可选
flow
object 
实测流量
必需
precipitation
array [object {2}] 
面雨量
可选
不传的项则为不指定(保持原有)
evaporation
array [object {2}] 
蒸发
可选
initValueAt
array [object {3}] 
产汇流初值
可选
riverRoutingAt
array [object {4}] 
河道汇流初值
可选
不传则使用全局设置
示例
{
	"calibConfigParams": {
		"timeStep": 24,
		"optimizationAlgorithm": "MOEA.GA",
		"calibrationTimes": 10,
		"NSE": 0.3,
		"VE": 0.4,
		"PE": 0.3,
		"calibrationSessions": [
			"16dc9370-ebf6-11ed-94ab-db13ecfb52a8",
			"170d4060-ebf6-11ed-94ab-db13ecfb52a8",
			"17654b70-ebf6-11ed-94ab-db13ecfb52a8"
		]
	}
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://cloud.keepsoft.net:30100/api/mcc/v1/app/calib' \
--header 'apiKey;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
	"calibConfigParams": {
		"timeStep": 24,
		"optimizationAlgorithm": "MOEA.GA",
		"calibrationTimes": 10,
		"NSE": 0.3,
		"VE": 0.4,
		"PE": 0.3,
		"calibrationSessions": [
			"16dc9370-ebf6-11ed-94ab-db13ecfb52a8",
			"170d4060-ebf6-11ed-94ab-db13ecfb52a8",
			"17654b70-ebf6-11ed-94ab-db13ecfb52a8"
		]
	}
}'

返回响应

🟢200成功
application/json
Body
idx
integer 
任务idx
必需
任务idx
示例
{
    "idx": 7344
}
🟠400400参数错误
🟠401401签名无效
修改于 2024-04-29 01:26:43
上一页
提交应用计算
下一页
停止计算
Built with