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

功能介绍

通过分子合成路径规划任务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
      } ]
    }
  }
}