靶点、药物与关联证据查询:参数与补充说明¶
用法和示例见功能教程。
各功能按作用、API、输入、输出、示例代码和结果说明介绍。运行前按说明准备凭据、本地文件与可选依赖;远程结果随数据库版本与查询时间变化。
按药物名称或编号查询作用机制¶
dnakit.databases.ch_embl_get_drug_mechanisms(*, limit=None, offset=None, drug_chembl_id=None, drug_name=None, molecule_chembl_id=None, chembl_id=None, drug_chembl_id__exact=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
limit |
integer | None | 当前请求的返回数量上限;不是全库命中总数。 |
offset |
integer | None | 分页起始偏移;对应当前查询结果。 |
drug_chembl_id |
string | None | ChEMBL drug/molecule ID (e.g., "CHEMBL1201580" for adalimumab, "CHEMBL4535757" for sotorasib). |
drug_name |
string | None | Drug name for automatic ChEMBL ID lookup (e.g., "trastuzumab", "lapatinib", "aspirin"). Case-insensitive. Triggers internal ChEMBL molecule search — use drug_chembl_id if you already know the ID. |
molecule_chembl_id |
string | None | Alias for drug_chembl_id. ChEMBL molecule ID (e.g., "CHEMBL25" for aspirin). |
chembl_id |
string | None | Alias for drug_chembl_id. ChEMBL ID (e.g., "CHEMBL3301622"). |
drug_chembl_id__exact |
string | None | DNAKit optional alias for drug_chembl_id |
verbose |
bool | True | 运行提示开关。 |
查询 ChEMBL 分子结构与性质¶
dnakit.databases.ch_embl_get_molecule(*, chembl_id=None, format=None, molecule_chembl_id=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
chembl_id |
string | None | ChEMBL molecule ID, e.g., 'CHEMBL25' |
format |
string | None | Response format |
molecule_chembl_id |
string | None | Alias for chembl_id. ChEMBL molecule ID, e.g., CHEMBL1229517. |
verbose |
bool | True | 运行提示开关。 |
查询靶点相关的生物活性测量值¶
dnakit.databases.ch_embl_get_target_activities(*, target_chembl_id__exact=None, limit=None, offset=None, target_chembl_id=None, chembl_id=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
target_chembl_id__exact |
string | None | ChEMBL target ID (e.g., 'CHEMBL2074'). To find a target ID, use ChEMBL_search_targets with a target name or gene symbol. |
limit |
integer | None | 当前请求的返回数量上限;不是全库命中总数。 |
offset |
integer | None | 分页起始偏移;对应当前查询结果。 |
target_chembl_id |
string | None | Alias for target_chembl_id__exact. ChEMBL target ID (e.g., CHEMBL213). |
chembl_id |
string | None | DNAKit optional alias for target_chembl_id |
verbose |
bool | True | 运行提示开关。 |
以下参数组必须且只能提供一组:target_chembl_id__exact; target_chembl_id。
按名称与研发阶段检索药物¶
dnakit.databases.ch_embl_search_drugs(*, query=None, max_phase=None, limit=None, offset=None, molecule_chembl_id=None, q=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
query |
string | None | Drug name to search for (partial match, case-insensitive). E.g., "sotorasib", "olaparib", "imatinib". |
max_phase |
integer | None | Filter by maximum development phase (0-4) |
limit |
integer | None | 当前请求的返回数量上限;不是全库命中总数。 |
offset |
integer | None | 分页起始偏移;对应当前查询结果。 |
molecule_chembl_id |
string | None | Filter by ChEMBL molecule ID (e.g., "CHEMBL1201580" for adalimumab). |
q |
string | None | DNAKit optional alias for query |
verbose |
bool | True | 运行提示开关。 |
按名称、物种或类型检索药物靶点¶
dnakit.databases.ch_embl_search_targets(*, target_chembl_id=None, pref_name__contains=None, organism=None, target_type=None, fields=None, limit=None, offset=None, q=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
target_chembl_id |
string | None | Filter by target ChEMBL ID |
pref_name__contains |
string | None | Filter by target name (contains) |
organism |
string | None | Filter by organism (e.g., 'Homo sapiens') |
target_type |
string | None | Filter by target type (e.g., 'SINGLE PROTEIN', 'PROTEIN COMPLEX') |
fields |
array | None | Optional list of ChEMBL target fields to include in each returned target object (projection). ToolUniverse maps this to ChEMBL's only query parameter (comma-separated). Supported fields: target_chembl_id, pref_name, organism, target_type, target_components. {"uniqueItems": true, "items": {"type": "string", "enum": ["target_chembl_id", "pref_name", "organism", "target_type", "target_components"]}} |
limit |
integer | None | 当前请求的返回数量上限;不是全库命中总数。 |
offset |
integer | None | 分页起始偏移;对应当前查询结果。 |
q |
string | None | DNAKit optional alias for pref_name__contains |
verbose |
bool | True | 运行提示开关。 |
查看已不可用的 CTD 化学物基因互作查询¶
dnakit.databases.ctd_get_chemical_gene_interactions(*, input_terms, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
input_terms |
string | 必填 | Chemical name, CAS RN, or MeSH ID. Unused -- this tool always returns an error; see the tool description. |
verbose |
bool | True | 运行提示开关。 |
批量查询药物与基因互作证据¶
dnakit.databases.dgidb_get_drug_gene_interactions(*, genes=None, gene_name=None, gene=None, interaction_sources=None, interaction_types=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
genes |
array | None | List of gene symbols (e.g., ['EGFR', 'BRAF']). Also accepts a single gene as string. Aliases: gene_name, gene. {"items": {"type": "string"}} |
gene_name |
string | None | Alias for genes. Single gene symbol (e.g., 'EGFR'). |
gene |
string | None | Alias for genes. Single gene symbol (e.g., 'EGFR'). |
interaction_sources |
array | None | Optional filter by data sources (e.g., ['DrugBank', 'ChEMBL']). {"items": {"type": "string"}} |
interaction_types |
array | None | Optional filter by interaction types (e.g., ['inhibitor', 'antagonist']). {"items": {"type": "string"}} |
verbose |
bool | True | 运行提示开关。 |
查询基因的可成药类别¶
dnakit.databases.dgidb_get_gene_druggability(*, genes=None, gene_name=None, gene=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
genes |
array | None | List of gene symbols to check druggability. Aliases: gene_name, gene. {"items": {"type": "string"}} |
gene_name |
string | None | Alias for genes. Single gene symbol (e.g., 'EGFR'). |
gene |
string | None | Alias for genes. Single gene symbol (e.g., 'EGFR'). |
verbose |
bool | True | 运行提示开关。 |
查询药物基本信息与批准状态¶
dnakit.databases.drugbank_get_drug_basic_info_by_drug_name_or_id(*, query, case_sensitive=None, exact_match=None, limit=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
query |
string | 必填 | Drug name or DrugBank ID to search for |
case_sensitive |
boolean | None | Select True to perform a case-sensitive search |
exact_match |
boolean | None | Select True to require an exact match with the queried name or ID |
limit |
integer | None | Maximum number of results to return |
verbose |
bool | True | 运行提示开关。 |
查询药效学、作用机制与药代动力学¶
dnakit.databases.drugbank_get_pharmacology_by_drug_name_or_drugbank_id(*, query, case_sensitive=None, exact_match=None, limit=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
query |
string | 必填 | Drug name or Drugbank ID to search for |
case_sensitive |
boolean | None | Select True to perform a case-sensitive search |
exact_match |
boolean | None | Select True to require an exact match |
limit |
integer | None | Maximum number of results to return |
verbose |
bool | True | 运行提示开关。 |
查询药物靶点、酶、载体与转运体¶
dnakit.databases.drugbank_get_targets_by_drug_name_or_drugbank_id(*, query, case_sensitive=None, exact_match=None, limit=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
query |
string | 必填 | Drug name or Drugbank ID to search for |
case_sensitive |
boolean | None | Select True to perform a case-sensitive search |
exact_match |
boolean | None | Select True to require an exact match |
limit |
integer | None | Maximum number of results to return |
verbose |
bool | True | 运行提示开关。 |
按名称与同义词检索 DrugBank 词表¶
dnakit.databases.drugbank_vocab_search(*, query, search_fields=None, case_sensitive=None, exact_match=None, limit=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
query |
string | 必填 | Search query string. Can be drug name, synonym, DrugBank ID, or any text to search for. |
search_fields |
array | None | Fields to search in. Available fields: 'DrugBank ID', 'Accession Numbers', 'Common name', 'CAS', 'UNII', 'Synonyms', 'Standard InChI Key'. Defaults to ['Common name', 'Synonyms', 'DrugBank ID']. {"items": {"type": "string"}} |
case_sensitive |
boolean | None | Whether the search should be case sensitive. |
exact_match |
boolean | None | Whether to perform exact matching instead of substring matching. |
limit |
integer | None | Maximum number of results to return. |
verbose |
bool | True | 运行提示开关。 |
查询文献支持的疾病靶点关联评分¶
dnakit.databases.europepmc_disease_target_score(*, efoId, pageSize=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
efoId |
string | 必填 | The EFO (Experimental Factor Ontology) ID of the disease, e.g., 'MONDO_0011996' for chronic myelogenous leukemia |
pageSize |
integer | None | Upstream fetch batch size (max 100), NOT a limit on results returned. The tool pages through all of the disease's associated targets regardless of this value -- 'pageSize': 10 on MONDO_0005011 (Crohn disease) still returns 390 scored targets. Lower it only to make each upstream request smaller. |
verbose |
bool | True | 运行提示开关。 |
查询表达数据支持的疾病靶点关联评分¶
dnakit.databases.expression_atlas_disease_target_score(*, efoId, pageSize=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
efoId |
string | 必填 | The EFO (Experimental Factor Ontology) ID of the disease, e.g., 'MONDO_0011996' for chronic myelogenous leukemia |
pageSize |
integer | None | Number of results per page (default: 100, max: 100) |
verbose |
bool | True | 运行提示开关。 |
查询药品有效成分¶
dnakit.databases.fda_get_active_ingredient_info_by_drug_name(*, drug_name, limit=None, skip=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
drug_name |
string | 必填 | The name of the drug. |
limit |
integer | None | The number of records to return. |
skip |
integer | None | The number of records to skip. |
verbose |
bool | True | 运行提示开关。 |
查询药品标签中的不良反应信息¶
dnakit.databases.fda_get_adverse_reactions_by_drug_name(*, drug_name, limit=None, skip=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
drug_name |
string | 必填 | The name of the drug. |
limit |
integer | None | The number of records to return. |
skip |
integer | None | The number of records to skip. |
verbose |
bool | True | 运行提示开关。 |
查询药品黑框警告与相关安全信息¶
dnakit.databases.fda_get_boxed_warning_info_by_drug_name(*, drug_name, limit=None, skip=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
drug_name |
string | 必填 | The name of the drug. |
limit |
integer | None | The number of records to return. |
skip |
integer | None | The number of records to skip. |
verbose |
bool | True | 运行提示开关。 |
查询药品标签中的临床研究信息¶
dnakit.databases.fda_get_clinical_studies_info_by_drug_name(*, drug_name, limit=None, skip=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
drug_name |
string | 必填 | The name of the drug. |
limit |
integer | None | The number of records to return. |
skip |
integer | None | The number of records to skip. |
verbose |
bool | True | 运行提示开关。 |
查询药品适应证与使用说明¶
dnakit.databases.fda_get_indications_by_drug_name(*, drug_name, limit=None, skip=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
drug_name |
string | 必填 | The name of the drug. |
limit |
integer | None | The number of records to return. |
skip |
integer | None | The number of records to skip. |
verbose |
bool | True | 运行提示开关。 |
查询药品标签中的作用机制¶
dnakit.databases.fda_get_mechanism_of_action_by_drug_name(*, drug_name, limit=None, skip=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
drug_name |
string | 必填 | The name of the drug. |
limit |
integer | None | The number of records to return. |
skip |
integer | None | The number of records to skip. |
verbose |
bool | True | 运行提示开关。 |
查询代谢物的疾病关联¶
dnakit.databases.hmdb_get_diseases(*, operation=None, hmdb_id=None, compound_name=None, pubchem_cid=None, limit=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
operation |
string | None | 提供方操作模式;默认值与允许值见本行约束。 |
hmdb_id |
string | None | HMDB ID (e.g., HMDB0000122) |
compound_name |
string | None | Compound name (e.g., glucose) |
pubchem_cid |
string | None | PubChem CID as an alternative identifier to hmdb_id or compound_name. |
limit |
integer | None | Maximum number of disease associations to return (default 50). |
verbose |
bool | True | 运行提示开关。 |
按编号或名称查询代谢物信息¶
dnakit.databases.hmdb_get_metabolite(*, operation=None, hmdb_id=None, compound_name=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
operation |
string | None | 提供方操作模式;默认值与允许值见本行约束。 |
hmdb_id |
string | None | HMDB ID (e.g., HMDB0000122) |
compound_name |
string | None | Compound name (e.g., glucose) |
verbose |
bool | True | 运行提示开关。 |
按名称或分子式检索代谢物¶
dnakit.databases.hmdb_search(*, operation=None, query, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
operation |
string | None | 提供方操作模式;默认值与允许值见本行约束。 |
query |
string | 必填 | Compound name or molecular formula to search |
verbose |
bool | True | 运行提示开关。 |
按疾病查询已知相关药物¶
dnakit.databases.open_targets_get_associated_drugs_by_disease_efo_id(*, efoId, size=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
efoId |
string | 必填 | The EFO ID of the disease. |
size |
integer | None | 当前返回页的数量上限;不自动遍历后续页。 |
verbose |
bool | True | 运行提示开关。 |
按靶点查询相关药物与研发阶段¶
dnakit.databases.open_targets_get_associated_drugs_by_target_ensembl_id(*, ensemblId, size=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
ensemblId |
string | 必填 | The Ensembl ID of the target. |
size |
integer | None | 当前返回页的数量上限;不自动遍历后续页。 |
verbose |
bool | True | 运行提示开关。 |
查询疾病相关的 HPO 表型¶
dnakit.databases.open_targets_get_associated_phenotypes_by_disease_efo_id(*, efoId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
efoId |
string | 必填 | The efoId of a disease or phenotype. |
verbose |
bool | True | 运行提示开关。 |
分页查询疾病关联靶点¶
dnakit.databases.open_targets_get_associated_targets_by_disease_efo_id(*, efoId, size=None, index=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
efoId |
string | 必填 | The efoId of a disease or phenotype. |
size |
integer | None | Number of top-scored associated targets to return (default 50). A disease can have thousands of associated targets; raise this to retrieve more than the first page. |
index |
integer | None | Zero-based page index for paginating beyond the first size targets (default 0). |
verbose |
bool | True | 运行提示开关。 |
查询 GWAS 可信集合与位点基因映射¶
dnakit.databases.open_targets_get_credible_set_detail(*, studyLocusId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
studyLocusId |
string | 必填 | Credible set identifier (studyLocusId), a 32-character hash (e.g., 'b758d8fb10924f5338cbad8d27c7dee8'). Obtain from variant credible sets or study credible sets queries. |
verbose |
bool | True | 运行提示开关。 |
查询疾病本体的父级与祖先概念¶
dnakit.databases.open_targets_get_disease_ancestors_parents_by_efo_id(*, efoId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
efoId |
string | 必填 | The EFO ID of the disease. |
verbose |
bool | True | 运行提示开关。 |
查询疾病本体的子级与后代概念¶
dnakit.databases.open_targets_get_disease_descendants_children_by_efo_id(*, efoId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
efoId |
string | 必填 | The EFO ID of the disease. |
verbose |
bool | True | 运行提示开关。 |
查询疾病名称、描述与跨库引用¶
dnakit.databases.open_targets_get_disease_description_by_efo_id(*, efoId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
efoId |
string | 必填 | The EFO ID of the disease. |
verbose |
bool | True | 运行提示开关。 |
按疾病名称解析本体编号与描述¶
dnakit.databases.open_targets_get_disease_id_description_by_name(*, diseaseName=None, query=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
diseaseName |
string | None | The name of the disease to search for. |
query |
string | None | DNAKit optional alias for diseaseName |
verbose |
bool | True | 运行提示开关。 |
查询疾病同义名称¶
dnakit.databases.open_targets_get_disease_synonyms_by_efo_id(*, efoId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
efoId |
string | 必填 | The EFO ID of the disease. |
verbose |
bool | True | 运行提示开关。 |
查询疾病所属的治疗领域¶
dnakit.databases.open_targets_get_disease_therapeutic_areas_by_efo_id(*, efoId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
efoId |
string | 必填 | The EFO ID of the disease. |
verbose |
bool | True | 运行提示开关。 |
分页查询靶点关联疾病与表型¶
dnakit.databases.open_targets_get_diseases_phenotypes_by_target_ensembl(*, ensemblId, page=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
ensemblId |
string | 必填 | The ensemblId of a target. |
page |
object | None | Pagination parameters. count in the response is the total across all pages; omit this to get the first page only. {"properties": {"index": {"type": "integer", "description": "The index of the page to retrieve (0-based)."}, "size": {"type": "integer", "description": "The number of associations per page."}}} |
verbose |
bool | True | 运行提示开关。 |
查询药物显著不良事件记录¶
dnakit.databases.open_targets_get_drug_adverse_events_by_chembl_id(*, chemblId, page=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
chemblId |
string | 必填 | The ChEMBL ID of the drug. |
page |
object | None | Pagination settings. {"properties": {"index": {"type": "integer", "description": "Index of the page to fetch, starting from 0."}, "size": {"type": "integer", "description": "Number of entries per page."}}} |
verbose |
bool | True | 运行提示开关。 |
按通用名称解析药物 ChEMBL 编号¶
dnakit.databases.open_targets_get_drug_chemb_id_by_generic_name(*, drugName=None, query=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
drugName |
string | None | The generic name of the drug for which the ID is required. |
query |
string | None | DNAKit optional alias for drugName |
verbose |
bool | True | 运行提示开关。 |
按 ChEMBL 编号查询药物适应证¶
dnakit.databases.open_targets_get_drug_indications_by_chembl_id(*, chemblId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
chemblId |
string | 必填 | The chemblId of the drug for which to retrieve treatable phenotypes information. |
verbose |
bool | True | 运行提示开关。 |
按 ChEMBL 编号查询药物作用机制¶
dnakit.databases.open_targets_get_drug_mechanisms_of_action_by_chembl_id(*, chemblId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
chemblId |
string | 必填 | The ChEMBL ID of the drug. |
verbose |
bool | True | 运行提示开关。 |
按 ChEMBL 编号查询药物警告¶
dnakit.databases.open_targets_get_drug_warnings_by_chembl_id(*, chemblId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
chemblId |
string | 必填 | The ChEMBL ID of the drug. |
verbose |
bool | True | 运行提示开关。 |
按证据来源筛选靶点疾病关联¶
dnakit.databases.open_targets_get_evidence_by_datasource(*, efoId=None, ensemblId=None, gene_symbol=None, disease_name=None, datasourceIds=None, size=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
efoId |
string | None | Disease EFO/MONDO ID (e.g., 'MONDO_0005011' for Crohn disease). Alternative to disease_name. |
ensemblId |
string | None | Target Ensembl gene ID (e.g., 'ENSG00000141510' for TP53). Alternative to gene_symbol. |
gene_symbol |
string | None | HGNC gene symbol (e.g., 'TP53', 'BRCA1'). Auto-resolved to ensemblId. |
disease_name |
string | None | Disease or phenotype name (e.g., 'Crohn disease'). Auto-resolved to efoId. |
datasourceIds |
array | None | List of datasource IDs to filter evidence. Examples: ['gwas_credible_sets', 'europepmc'], ['eva', 'clinical_precedence'], ['intogen', 'cancer_gene_census']. For genetic (GWAS) association evidence use 'gwas_credible_sets' — the retired 'ot_genetics_portal' name is remapped automatically. Omit or pass empty array for all sources. {"items": {"type": "string"}} |
size |
integer | None | Maximum evidence rows to return (default: 50) |
verbose |
bool | True | 运行提示开关。 |
查询 GWAS 研究队列与统计元数据¶
dnakit.databases.open_targets_get_gwas_study(*, studyId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
studyId |
string | 必填 | GWAS study accession ID (e.g., 'GCST000392' for T1D Barrett et al., 'GCST90029024' for T2D Loh et al.) |
verbose |
bool | True | 运行提示开关。 |
查询靶点相关文献记录¶
dnakit.databases.open_targets_get_publications_by_target_ensembl_id(*, entityId, additionalIds=None, startYear=None, startMonth=None, endYear=None, endMonth=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
entityId |
string | 必填 | The ID of the entity (ensemblID). |
additionalIds |
array | None | List of additional IDs to include in the search. {"items": {"type": "string"}} |
startYear |
integer | None | Year at the lower end of the filter. |
startMonth |
integer | None | Month at the lower end of the filter. |
endYear |
integer | None | Year at the higher end of the filter. |
endMonth |
integer | None | Month at the higher end of the filter. |
verbose |
bool | True | 运行提示开关。 |
查询与疾病相似的生物医学实体¶
dnakit.databases.open_targets_get_similar_entities_by_disease_efo_id(*, efoId, threshold, size, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
efoId |
string | 必填 | The EFO ID of the disease. |
threshold |
number | 必填 | Threshold similarity between 0 and 1. Only results above threshold are returned. |
size |
integer | 必填 | Number of similar entities to fetch. |
verbose |
bool | True | 运行提示开关。 |
查询指定 GWAS 研究的可信集合¶
dnakit.databases.open_targets_get_study_credible_sets(*, studyIds, size=None, index=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
studyIds |
array | 必填 | GWAS study accession IDs (e.g., ['GCST000392']) {"items": {"type": "string"}} |
size |
integer | None | Number of credible sets to return (default 20) |
index |
integer | None | Page index for pagination (0-based, default 0) |
verbose |
bool | True | 运行提示开关。 |
查询靶点的功能类别¶
dnakit.databases.open_targets_get_target_classes_by_ensembl_id(*, ensemblId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
ensemblId |
string | 必填 | The Ensembl ID of the target. |
verbose |
bool | True | 运行提示开关。 |
查询靶点的 GO 功能注释¶
dnakit.databases.open_targets_get_target_gene_ontology_by_ensembl_id(*, ensemblId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
ensemblId |
string | 必填 | The Ensembl ID of the target for which to retrieve Gene Ontology annotations. |
verbose |
bool | True | 运行提示开关。 |
查询靶点的基因组位置与方向¶
dnakit.databases.open_targets_get_target_genomic_location_by_ensembl_id(*, ensemblId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
ensemblId |
string | 必填 | The Ensembl ID of the target for which to retrieve genomic location information. |
verbose |
bool | True | 运行提示开关。 |
查询靶点的同源基因¶
dnakit.databases.open_targets_get_target_homologues_by_ensembl_id(*, ensemblId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
ensemblId |
string | 必填 | The Ensembl ID of the target for which to retrieve homologues. |
verbose |
bool | True | 运行提示开关。 |
按名称解析靶点标识与描述¶
dnakit.databases.open_targets_get_target_id_description_by_name(*, targetName, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
targetName |
string | 必填 | The name of the target for which the ID is required. |
verbose |
bool | True | 运行提示开关。 |
分页查询靶点互作伙伴与证据¶
dnakit.databases.open_targets_get_target_interactions_by_ensembl_id(*, ensemblId, page=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
ensemblId |
string | 必填 | The Ensembl ID of the target. |
page |
object | None | Pagination parameters. {"properties": {"index": {"type": "integer", "description": "The index of the page to retrieve."}, "size": {"type": "integer", "description": "The number of items per page."}}} |
verbose |
bool | True | 运行提示开关。 |
查询靶点已知安全性风险记录¶
dnakit.databases.open_targets_get_target_safety_profile_by_ensembl_id(*, ensemblId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
ensemblId |
string | 必填 | The Ensembl ID of the target for which to retrieve safety liabilities. |
verbose |
bool | True | 运行提示开关。 |
查询靶点对不同治疗方式的可开发性¶
dnakit.databases.open_targets_get_target_tractability_by_ensembl_id(*, ensemblId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
ensemblId |
string | 必填 | The Ensembl ID of the target. |
verbose |
bool | True | 运行提示开关。 |
查询包含指定变异的 GWAS 可信集合¶
dnakit.databases.open_targets_get_variant_credible_sets(*, variantId=None, size=None, variant_id=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
variantId |
string | None | Open Targets variant ID in format chr_position_ref_alt (e.g., '10_112998590_C_T' for rs7903146) |
size |
integer | None | Number of credible sets to return (default 10) |
variant_id |
string | None | DNAKit optional alias for variantId |
verbose |
bool | True | 运行提示开关。 |
查询变异坐标、频率与功能后果¶
dnakit.databases.open_targets_get_variant_info(*, variantId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
variantId |
string | 必填 | Open Targets variant ID in format chr_position_ref_alt (e.g., '10_112998590_C_T' for rs7903146, '19_44908684_T_C' for rs429358). Use the search tool to find variant IDs from rsIDs. |
verbose |
bool | True | 运行提示开关。 |
转换疾病与表型的跨数据库标识¶
dnakit.databases.open_targets_map_any_disease_id_to_all_other_ids(*, inputId, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
inputId |
string | 必填 | Any known disease ID (e.g. OMIM:604302, UMLS:C0003873, ICD10:M05, MONDO_0008383, etc.) |
verbose |
bool | True | 运行提示开关。 |
联合检索疾病、靶点与药物实体¶
dnakit.databases.open_targets_multi_entity_search_by_query_string(*, queryString, entityNames=None, page=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
queryString |
string | 必填 | The search string for querying information. |
entityNames |
array | None | List of entity names to search for (e.g., target, disease, drug). {"items": {"type": "string"}} |
page |
object | None | Pagination settings with index and size. {"properties": {"index": {"type": "integer", "description": "Pagination index."}, "size": {"type": "integer", "description": "Pagination size."}}} |
verbose |
bool | True | 运行提示开关。 |
按疾病或性状查找 GWAS 研究¶
dnakit.databases.open_targets_search_gwas_studies_by_disease(*, diseaseIds=None, enableIndirect=None, disease_name=None, disease=None, trait=None, size=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
diseaseIds |
array | None | Disease ontology IDs (e.g., ['MONDO_0005148'] for type 2 diabetes, ['MONDO_0004975'] for Alzheimer disease) {"items": {"type": "string"}} |
enableIndirect |
boolean | None | Include studies for child disease terms (default true) |
disease_name |
string | None | Disease or trait name for auto-resolution (e.g., 'type 2 diabetes'). Resolved to diseaseIds automatically. |
disease |
string | None | Alias for disease_name. |
trait |
string | None | Alias for disease_name. |
size |
integer | None | 当前返回页的数量上限;不自动遍历后续页。 |
verbose |
bool | True | 运行提示开关。 |
查询 IntOGen 肿瘤驱动基因关联证据¶
dnakit.databases.open_targets_target_disease_evidence(*, efoId=None, ensemblId=None, gene_symbol=None, disease_name=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
efoId |
string | None | EFO/MONDO disease ID (e.g., MONDO_0005011). Alternative to disease_name. |
ensemblId |
string | None | Ensembl gene ID (e.g., ENSG00000141510). Alternative to gene_symbol. |
gene_symbol |
string | None | HGNC gene symbol (e.g., 'TP53', 'BRCA1'). Auto-resolved to ensemblId. |
disease_name |
string | None | Disease or phenotype name (e.g., 'Crohn disease', 'breast carcinoma'). Auto-resolved to efoId. |
verbose |
bool | True | 运行提示开关。 |
将化合物名称解析为 PubChem CID¶
dnakit.databases.pub_chem_get_cid_by_compound_name(*, name=None, compound_name=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
name |
string | None | Chemical compound name (e.g., "Aspirin", "Acetaminophen") or IUPAC name. Do not use disease names or medical conditions. |
compound_name |
string | None | Alias for name. The compound name to look up. |
verbose |
bool | True | 运行提示开关。 |
按 CID 查询化合物分子性质¶
dnakit.databases.pub_chem_get_compound_properties_by_cid(*, cid, properties=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
cid |
integer | 必填 | PubChem compound ID to query, e.g., 2244 (Aspirin). |
properties |
array | string | null | None | Optional list of PubChem property names to retrieve (e.g. ['MolecularFormula','InChIKey','XLogP','IUPACName','MolecularWeight']). If omitted, returns a default set (MolecularWeight, IUPACName, ConnectivitySMILES). For SMILES use the current names 'ConnectivitySMILES' (was 'CanonicalSMILES') or 'SMILES' (was 'IsomericSMILES') — a legacy name still returns data, but under the current key, not the one requested. See PubChem PUG-REST property tables for valid names. Accepts a list or a comma-separated string. {"items": {"type": "string"}} |
verbose |
bool | True | 运行提示开关。 |
查询通路支持的疾病靶点关联评分¶
dnakit.databases.reactome_disease_target_score(*, efoId, pageSize=None, verbose=True)
| 参数 | 类型 | 必填 / 默认值 | 说明与约束 |
|---|---|---|---|
efoId |
string | 必填 | The EFO (Experimental Factor Ontology) ID of the disease, e.g., 'MONDO_0011996' for chronic myelogenous leukemia |
pageSize |
integer | None | Number of results per page (default: 100, max: 100) |
verbose |
bool | True | 运行提示开关。 |