文档首页/ 医疗智能体 EIHealth/ API参考/ API（盘古辅助制药平台）/ 分子优化作业管理/ 查询分子优化作业详情
更新时间：2024-07-12 GMT+08:00
查看PDF
分享

查询分子优化作业详情

功能介绍

查询分子优化作业详情。

URI

GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-jobs/optimization/{job_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，您可以从获取项目ID中获取。

最小长度：1

最大长度：128

eihealth_project_id

是

String

平台项目ID。

最小长度：1

最大长度：128

job_id

是

String

作业id。

最小长度：1

最大长度：128

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。

最小长度：1

最大长度：32768

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

basic_info

DrugJobDto object

作业基本信息。

smiles

String

分子SMILES表达式。

最小长度：1

最大长度：512

molecule_file

DrugFile object

分子文件。

num_trials

Integer

生成分子数量。

最小值：0

最大值：5000

binding_site

BindSiteDto object

结合位点。

binding_sites

Array of BindSiteDto objects

受体列表和受体是二选一的关系，受体列表优先级最高。

数组长度：0 - 2

weak_constraints

Array of WeakConstraintDto objects

弱约束集合。

strong_constraints

Array of StrongConstraintDto objects

强约束集合。

sampler_mixin_weight

Float

初始化采样权重。

base_model

BaseModel object

基模型。

models

Array of BasicDrugModel objects

模型列表。

cluster_result

ClusterJobRsp object

聚类结果信息。
表4 DrugJobDto

参数

参数类型

描述

id

String

作业id。

name

String

作业的名称，取值范围：[1,63]，允许大小写字母、数字、以及特殊字符中划线(-)。

labels

Array of strings

作业标签。

status

String

作业状态。

type

String

作业类型。

create_time

String

作业创建时间。

finish_time

String

作业结束时间。

start_time

String

作业开始时间。

failed_message

String

失败提示，当作业执行失败时会返回。

user_name

String

创建任务的用户名称。

output_dir

String

作业结果输出目录。

expect_charge_num

Double

预估功能调用消耗次数。

real_charge_num

Double

实际功能调用消耗次数。

progress

Progress object

作业进度信息。
表5 Progress

参数

参数类型

描述

overall

Float

整体进度。

estimated_finish_time

Long

预计结束时间，毫秒。
表6 DrugFile

参数

参数类型

描述

source

String

受体的数据源：外部网络数据（如RCSB在线数据库）、用户私有数据中心、承载租户公共数据（含样例/公共库）。

枚举值：

  • EXTRANET
  • PRIVATE
  • PUBLIC
  • RAW

url

String

文件URL，当数据源为外部网络数据时为https地址；用户私有数据中心为项目路径、公共数据场景为obs地址。

最小长度：1

最大长度：2000

format

String

文件格式，支持PDB、SDF、MOL2、SMI，仅数据源为RAW时提供。

最小长度：1

最大长度：6

data

String

文件原始数据，仅数据源为RAW时提供。

最小长度：0

最大长度：10000000
表7 BindSiteDto

参数

参数类型

描述

name

String

靶点名称，只能设置为target1或者target2。

最小长度：1

最大长度：128

receptor

ReceptorDrugFile object

受体文件

bounding_box

BoundingBoxDto object

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

remove_ion

Boolean

去除受体中的离子。

缺省值：true

remove_water

Boolean

去除受体中的水分子。

缺省值：true

remove_ligand

Boolean

去除受体中的配体分子。

缺省值：true

add_hydrogen

Boolean

增加氢原子。

缺省值：false
表8 ReceptorDrugFile

参数

参数类型

描述

source

String

受体的数据源：外部网络数据（如RCSB在线数据库）、用户私有数据中心、承载租户公共数据（含样例/公共库）。

枚举值：

  • EXTRANET
  • PRIVATE
  • PUBLIC
  • RAW

url

String

文件URL，当数据源为外部网络数据时为https地址；用户私有数据中心为项目路径、公共数据场景为obs地址。

最小长度：1

最大长度：2000

format

String

文件格式，仅支持PDB，仅数据源为RAW时提供。

最小长度：1

最大长度：6

data

String

文件原始数据，仅数据源为RAW时提供。

最小长度：0

最大长度：10000000
表9 BoundingBoxDto

参数

参数类型

描述

center

Array of floats

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

最小值：-9999999

最大值：99999999

数组长度：3 - 3

size

Array of floats

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

最小值：2

最大值：500

数组长度：3 - 3

padding

Float

填充。

最小值：0

最大值：20
表10 WeakConstraintDto

参数

参数类型

描述

id

String

自定义模型id，仅弱约束为模型时填写。

最小长度：1

最大长度：128

name

String

属性名称。

最小长度：1

最大长度：128

type

String

属性约束类型。

枚举值：

  • bool
  • range
  • struct
  • minimize
  • maximize
  • interaction

bool

Boolean

属性约束类型bool的参数。

range

Array of floats

属性约束类型range的参数。

最小值：-9999

最大值：9999

数组长度：2 - 2

struct

StructureConstraintParamsDto object

结构约束参数。

quantiles

Array of floats

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

最小值：0.0

最大值：1.0

数组长度：2 - 2

interaction

InteractionConstraintDto object

相互作用力约束参数。
表11 StrongConstraintDto

参数

参数类型

描述

id

String

自定义模型id，仅强约束为模型时填写。

最小长度：1

最大长度：128

name

String

属性名称。

最小长度：1

最大长度：128

type

String

属性约束类型。

枚举值：

  • bool
  • range
  • struct
  • interaction

bool

Boolean

属性约束类型bool的参数。

range

Array of floats

属性约束类型range的参数。

最小值：-9999

最大值：9999

数组长度：2 - 2

struct

StructureConstraintParamsDto object

结构约束参数。

interaction

InteractionConstraintDto object

相互作用力约束参数。
表12 StructureConstraintParamsDto

参数

参数类型

描述

structs

Array of strings

子结构SMILES。

最小长度：1

最大长度：120

数组长度：1 - 8

exclusive

Boolean

是否排除子结构。

operator

String

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

枚举值：

  • or
  • and
表13 InteractionConstraintDto

参数

参数类型

描述

interactions

Array of Interaction objects

相互作用力列表。

数组长度：1 - 8

exclusive

Boolean

是否排除指定的约束作用力。

operator

String

多个作用力之间的逻辑关系。

枚举值：

  • or
  • and
表14 Interaction

参数

参数类型

描述

binding_site

String

靶点，只支持target1或target2。

最小长度：1

最大长度：128

type

String

相互作用力类型：氢键、疏水作用、盐桥、π-π堆积、π-阳离子。

枚举值：

  • hydrogen_bond
  • hydrophobic_action
  • salt_bridge
  • pi_stacking
  • pi_cation

amino_acid

String

氨基酸。

最小长度：4

最大长度：16
表15 BaseModel

参数

参数类型

描述

id

String

基模型id。

缺省值：pangu-drug-model

最小长度：1

最大长度：128

name

String

基模型名称。

缺省值：pangu-drug-model

最小长度：1

最大长度：128
表16 BasicDrugModel

参数

参数类型

描述

id

String

模型ID。

task_id

String

任务ID。

name

String

模型名称。

creator

String

模型创建者。

type

String

模型类型。

value_range

ValueRange object

区间上下限，仅回归型存在。

description

String

模型描述信息。
表17 ValueRange

参数

参数类型

描述

lower

Float

区间下限，仅回归型存在。

upper

Float

区间上限，仅回归型存在。
表18 ClusterJobRsp

参数

参数类型

描述

method

String

分子聚类方法。

output_dir

String

分子聚类输出结果。

status

String

作业结果信息。

failed_reasons

Array of FailedReasonRecord objects

部分失败原因和数量。
表19 FailedReasonRecord

参数

参数类型

描述

reason

String

失败原因。

count

Integer

失败数量。

请求示例

无

响应示例

状态码： 200

OK

{
  "basic_info" : {
    "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1",
    "name" : "demo-job",
    "labels" : [ "labelA", "labelB" ],
    "status" : "FINISHED",
    "type" : "OPTIMIZATION",
    "create_time" : "2021-01-30T02:34:36Z",
    "start_time" : "2021-01-30T02:34:37Z",
    "finish_time" : "2021-01-30T02:53:26Z",
    "failed_message" : "null",
    "user_name" : "demo-user-name",
    "output_dir" : "job-analysis/job-name",
    "expect_charge_num" : 1,
    "real_charge_num" : 1
  },
  "smiles" : "string",
  "num_trials" : 500,
  "binding_site" : {
    "name" : "binding_name",
    "receptor" : {
      "source" : "PRIVATE",
      "url" : "project:/test.pdb"
    },
    "bounding_box" : {
      "center" : [ 0, 0, 0 ],
      "size" : [ 500, 500, 500 ]
    },
    "remove_ion" : false,
    "remove_water" : false,
    "remove_ligand" : true
  },
  "weak_constraints" : [ {
    "name" : "eye_corrosion",
    "type" : "bool",
    "bool" : true
  } ],
  "strong_constraints" : [ {
    "name" : "sascore",
    "type" : "range",
    "range" : [ 0, 1 ]
  } ],
  "cluster_result" : {
    "method" : "hiq_mc",
    "output_dir" : "project://bucket/path/to/task/dir/",
    "status" : "finished",
    "failed_reasons" : [ {
      "reason" : "failed reason"
    }, {
      "count" : 1
    } ]
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

相关文档