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

查询分子生成作业详情

功能介绍

查询分子生成作业详情。

URI

GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-jobs/generation/{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_list

Array of strings

分子表达式列表。

最小长度：1

最大长度：512

数组长度：10 - 10000

molecule_file

DrugFile object

分子文件，分子表达式列表和分子文件二选一，分子文件优先级最高。

num_trials

Integer

生成分子数量。

最小值：0

最大值：5000

initial_dataset_size

Integer

初始化数据集的分子数目。当为-1时，表示分子数目未知。

最小值：-1

最大值：100000

binding_sites

Array of BindSiteDto objects

靶点列表。

数组长度：0 - 2

weak_constraints

Array of WeakConstraintDto objects

弱约束集合。

数组长度：0 - 16

strong_constraints

Array of StrongConstraintDto objects

强约束集合。

数组长度：0 - 5

base_model

BaseModel object

基模型。

models

Array of BasicDrugModel objects

模型列表。
表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

实际功能调用消耗次数。

progressProgress

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 doubles

口袋中心坐标； 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

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

请求示例

无

响应示例

状态码： 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 
  }, 
  "molecule_file" : { 
    "source" : "PRIVATE", 
    "url" : "project:/dir/file" 
  }, 
  "num_trials" : 500, 
  "binding_sites" : [ { 
    "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 ] 
  } ] 
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

相关文档