更新时间:2024-02-07 GMT+08:00
分享

查询分子合成路径规划任务

功能介绍

通过分子合成路径规划任务ID查询分子合成路径规划任务状态及结果。

URI

GET /v1/{project_id}/task/synthesis/{task_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

华为云项目id

task_id

String

分子合成路径规划任务ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户 token

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

status

String

异步任务的状态:等待中、运行中、已完成、失败

枚举值:

  • waiting

  • running

  • finished

  • failed

task_data

SynthesisTaskData object

分子合成路径规划任务的请求体

result

SynthesisResult object

分子合成路径规划任务的返回结果

表4 SynthesisTaskData

参数

参数类型

描述

smiles

String

分子SMILES表达式

top_n

Integer

期望最大返回条目数(排序后取TopN)

最小值:1

最大值:50

max_search_depth

Integer

预测路径的最大深度

最小值:3

最大值:12

max_prediction_per_product

Integer

每个产物的最大反应数量

最小值:2

最大值:20

表5 SynthesisResult

参数

参数类型

描述

smiles

String

产物smiles序列

top_n

Integer

期望返回的条目数

max_search_depth

Integer

期望搜索的最大深度

max_prediction_per_product

Integer

期望每个产物的最多反应数量

result

result object

合成路径规划结果字典

表6 result

参数

参数类型

描述

molecules

Array of molecules objects

分子合成规划中的分子

reactions

Array of reactions objects

分子合成规划中的反应列表

synthesis_routes

Array of SynthesisResultItem objects

分子合成规划的具体信息

表7 molecules

参数

参数类型

描述

id

String

molecule的序号

smiles

String

molecule的smiles序列

source

String

molecule的smiles来源

表8 reactions

参数

参数类型

描述

id

String

反应的序号

reactants

Array of strings

反应物分子序号的列表

product

String

产物分子序号

表9 SynthesisResultItem

参数

参数类型

描述

route

Array of strings

分子合成规划,列表内是reactions id

score

Float

当前分子合成路径的得分

请求示例

查询一个分子合成路径规划任务

GET https://{endpoint}/v1/{project_id}/task/synthesis/{task_id}

响应示例

状态码: 200

分子合成路径规划任务查询成功响应

{
  "status" : "finished",
  "result" : {
    "smiles" : "c1ccccc1",
    "top_n" : 50,
    "max_search_depth" : 5,
    "max_prediction_per_product" : 20,
    "result" : {
      "molecules" : [ {
        "id" : "1",
        "smiles" : "c1ccccc1",
        "source" : "ZINC"
      }, {
        "id" : "2",
        "smiles" : "C11c",
        "source" : "ZINC"
      }, {
        "id" : "3",
        "smiles" : "C1c1",
        "source" : "ZINC"
      }, {
        "id" : "4",
        "smiles" : "c1",
        "source" : "ZINC"
      }, {
        "id" : "5",
        "smiles" : "cc",
        "source" : "ZINC"
      }, {
        "id" : "6",
        "smiles" : "Cc",
        "source" : "ZINC"
      }, {
        "id" : "7",
        "smiles" : "Cc1",
        "source" : "ZINC"
      } ],
      "reactions" : [ {
        "id" : "1",
        "reactants" : [ "2", "3" ],
        "product" : "1"
      }, {
        "id" : "2",
        "reactants" : [ "4", "5", "6" ],
        "product" : "2"
      }, {
        "id" : "3",
        "reactants" : [ "4", "7" ],
        "product" : "2"
      } ],
      "synthesis_routes" : [ {
        "route" : [ "1", "2" ],
        "score" : 0.3467
      }, {
        "route" : [ "1", "3" ],
        "score" : 0.3154
      } ]
    }
  }
}

状态码

状态码

描述

200

分子合成路径规划任务查询成功响应

404

分子合成路径规划任务ID不存在

错误码

请参见错误码

相关文档