新建分子优化任务接口

功能介绍

输入起始小分子以及属性约束，创建分子优化任务。

URI

POST /v1/{project_id}/task/optimization

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	华为云项目id

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户 token

表3 请求Body参数
参数	是否必选	参数类型	描述
smiles	是	String	分子SMILES表达式
num_trials	否	Integer	生成分子数量
strong_constraints	否	Array of MoleculeConstraint objects	强约束集合
weak_constraints	否	Array of MoleculeConstraint objects	弱约束集合
num_expected	否	Integer	期望最大返回条目数（排序后取Top）
binding_site	否	BindingSite object	结合位点
custom_props	否	Array of CustomProp objects	用户已开启的自定义属性集合

表4 MoleculeConstraint
参数	是否必选	参数类型	描述
name	否	String	属性名称
type	是	String	属性约束类型枚举值： bool range struct minimize maximize
bool	否	Boolean	属性约束类型bool的参数
range	否	Array of numbers	属性约束类型range的参数
struct	否	StructureConstraintParams 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	否	BoundingBox 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	否	PropDefinition object	属性定义的元信息

表9 PropDefinition
参数	是否必选	参数类型	描述
id	否	String	属性业务侧ID 最小长度：1 最大长度：128
name	否	String	属性名称最小长度：1 最大长度：32
type	否	String	属性类型枚举值： binary numerical
description	否	String	属性具体描述信息最小长度：0 最大长度：256
value_range	否	ValueRange object	属性有效值域区间
optimal_range	否	ValueRange object	属性最优值域区间
warning_range	否	ValueRange object	属性欠佳值域区间
style	否	String	模型参数呈现类型枚举值： number probability
confidential_interval	否	Boolean	模型推理是否呈现置信区间

**表10** ValueRange
参数	是否必选	参数类型	描述
lower	否	Number	值域下限
lower_inclusive	否	Boolean	是否包含值域下限
upper	否	Number	值域上限
upper_inclusive	否	Boolean	是否包含值域上限

响应参数

无

请求示例

创建一个分子优化任务

POST https://{endpoint}/v1/{project_id}/task/optimization

{
  "smiles" : "c1ccccc1",
  "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.07317073170731707, 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 ]
  } ],
  "binding_site" : {
    "protein" : "H4sIAK8LamMC/3MM8fdVAANDBQU/IOUY7KfgqKBgYgEVNdAzMDACMfRMTAwUFIyN9EwsDUFcAyDPQA+mDgz8AHV0WkpOAAAA",
    "bounding_box" : {
      "center" : [ 1.3, 23.4, -14.5 ],
      "size" : [ 10.0, 10.0, 10.0 ]
    }
  },
  "custom_props" : [ {
    "id" : "3b2dce64-c244-11ed-acf5-0255ac100017",
    "prop_definition" : {
      "id" : "c4c07032d1934671a0dfe3bd10416eea",
      "name" : "custom_prop_name",
      "type" : "numerical",
      "description" : "custom_prop_description"
    }
  } ]
}