更新时间:2023-06-16 GMT+08:00
分享

新建分子生成任务接口

功能介绍

输入分子属性约束,创建分子生成任务。

URI

POST /v1/{project_id}/task/generation

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

华为云项目id

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户 token

表3 请求Body参数

参数

是否必选

参数类型

描述

num_trials

Integer

生成分子数量

strong_constraints

Array of 表4 objects

强约束集合

weak_constraints

Array of 表4 objects

弱约束集合

num_expected

Integer

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

initial_dataset

Array of strings

初始化分子集合

binding_site

表6 object

结合位点

custom_props

Array of 表8 objects

用户已开启的自定义属性集合

表4 MoleculeConstraint

参数

是否必选

参数类型

描述

name

String

属性名称

type

String

属性约束类型

枚举值:

  • bool
  • range
  • struct
  • minimize
  • maximize

bool

Boolean

属性约束类型bool的参数

range

Array of numbers

属性约束类型range的参数

struct

表5 object

结构约束参数

quantiles

Array of numbers

属性约束类型minimize和maximize的参数

最小值:0.0

最大值:1.0

表5 StructureConstraintParams

参数

是否必选

参数类型

描述

structs

Array of strings

子结构SMILES

exclusive

Boolean

是否排除子结构

operator

String

多个子结构之间的逻辑关系

缺省值:or

枚举值:

  • or
  • and
表6 BindingSite

参数

是否必选

参数类型

描述

protein

String

蛋白质3D结构,使用gzip压缩然后转base64格式

最小长度:1

最大长度:10000000

bounding_box

表7 object

结合口袋,包含口袋中心位置和尺寸大小

表7 BoundingBox

参数

是否必选

参数类型

描述

center

Array of numbers

口袋中心坐标。 x, y, z轴的坐标

size

Array of numbers

口袋尺寸大小。x, y, z轴的大小

最小值:1.7

最大值:500

表8 CustomProp

参数

是否必选

参数类型

描述

id

String

自定义属性的ID(API侧)

最小长度:1

最大长度:64

prop_definition

表9 object

属性定义的元信息

表9 PropDefinition

参数

是否必选

参数类型

描述

id

String

属性业务侧ID

最小长度:1

最大长度:128

name

String

属性名称

最小长度:1

最大长度:32

type

String

属性类型

枚举值:

  • binary
  • numerical

description

String

属性具体描述信息

最小长度:0

最大长度:256

value_range

表10 object

属性有效值域区间

optimal_range

表10 object

属性最优值域区间

warning_range

表10 object

属性欠佳值域区间

style

String

模型参数呈现类型

枚举值:

  • number
  • probability

confidential_interval

Boolean

模型推理是否呈现置信区间

表10 ValueRange

参数

是否必选

参数类型

描述

lower

Number

值域下限

lower_inclusive

Boolean

是否包含值域下限

upper

Number

值域上限

upper_inclusive

Boolean

是否包含值域上限

响应参数

请求示例

创建一个分子生成任务

{ 
  "num_trials" : 10000, 
  "weak_constraints" : [ { 
    "name" : "mw", 
    "type" : "range", 
    "range" : [ 100, 600 ] 
  }, { 
    "name" : "nhet", 
    "type" : "range", 
    "range" : [ 0, 15 ] 
  }, { 
    "name" : "fsp3", 
    "type" : "range", 
    "range" : [ 0.07317, null ] 
  }, { 
    "name" : "qedmean", 
    "type" : "maximize" 
  }, { 
    "name" : "sascore", 
    "type" : "minimize", 
    "quantiles" : [ 0.1, 0.9 ] 
  }, { 
    "name" : "3b2dce64-c244-11ed-acf5-0255ac100017", 
    "type" : "range", 
    "range" : [ 0.2, 0.5 ] 
  } ], 
  "initial_dataset" : [ "c1ccccc1", "C1CCCCC1" ], 
  "custom_props" : [ { 
    "id" : "3b2dce64-c244-11ed-acf5-0255ac100017", 
    "prop_definition" : { 
      "id" : "c4c07032d1934671a0dfe3bd10416eea", 
      "name" : "custom_prop_name", 
      "type" : "numerical", 
      "description" : "custom_prop_description" 
    } 
  } ] 
}

响应示例

状态码: 201

分子生成任务成功提交响应,返回分子生成任务ID

"87ba6b54-2288-4a5d-90a2-3db01c22a9d2"

状态码

状态码

描述

201

分子生成任务成功提交响应,返回分子生成任务ID

错误码

请参见错误码

分享:

    相关文档

    相关产品