OSCR

A systematic evaluation of explainable AI methods for high-dimensional transcriptome-based cancer survival prediction.

Code ↔ Paper

17 matches between paragraphs of the paper and lines of its authors' code, computed by the harvester (lexical-v1). Click a colored paragraph or line to see its counterpart.

The 17 matches · 1 of them tie a paragraph to a whole file, not to given lines: a weak match, whose lines are not tinted
  1. [1] § Materials and methods › Model construction ↔ operation/loss_func.py, lines 31–106 · score 0.87 · Negative Log Likelihood, deep survival prediction, Loss function, discrete survival, batch, network
  2. [2] § Materials and methods › Evaluation metrics ↔ biological_plausibility/scripts/01_download_databases.py, lines 560–640 · score 0.73 · OpenTargets, CancerMine, DGIdb, OncoKB, databases, Biological
  3. [3] § Materials and methods › Model construction ↔ operation/core_utils.py, lines 105–254 · score 0.71 · Adam, L1, Warmup, patience, epoch, optimize
  4. [4] § Results › DeepSHAP outperforms other XAI methods in discovery of prognostic factors from pan-cancer transcriptomic data ↔ biological_plausibility/scripts/01_download_databases.py, lines 281–324 · score 0.71 · Cell Carcinoma, Grade Glioma, Glioblastoma, Papillary, Renal, GBMLGG
  5. [5] § Results › LRP achieves the highest biological consistency with established cancer gene databases ↔ biological_plausibility/scripts/01_download_databases.py, lines 560–640 · score 0.70 · OpenTargets, CancerMine, DGIdb, OncoKB, database, BRCA
  6. [6] § Materials and methods › Dataset description ↔ datasets_csv/preprocessing_cancer_single.py, lines 58–166 · score 0.70 · Molecular Signatures Database, MSigDB, preprocessed, TCGA, censorship, genes
  7. [7] § Materials and methods › Software and environment ↔ biological_plausibility/scripts/01_download_databases.py, lines 450–557 · score 0.66 · Literature mined cancer, CancerMine, gene associations, Zenodo
  8. [8] § Materials and methods › Dataset description ↔ datasets_csv/preprocessing_no_normalization.py, lines 103–142 · score 0.65 · Molecular Signatures Database, MSigDB, preprocessed, cancer
  9. [9] § Results › DeepSHAP delivers the optimal comprehensive performance across prognostic, biological and stability metrics ↔ biological_plausibility/scripts/04_visualize_2.py, lines 1697–1771 · score 0.64 · DB supported Hits, Min Max normalization, XAI categories, radar, biological, Prognostic Factor
  10. [10] § Materials and methods › Software and environment ↔ biological_plausibility/scripts/01_download_databases.py, lines 376–447 · score 0.64 · Gene disease associations, Open Targets Platform, GraphQL, API
  11. [11] § Results › LRP achieves the highest biological consistency with established cancer gene databases ↔ biological_plausibility/scripts/02_calculate_gene_scores.py, lines 275–341 · score 0.63 · DGIdb, OpenTargets, CancerMine, OncoKB, BRCA, database
  12. [12] § Materials and methods › Interpretability framework ↔ operation/lrp_bootstrap_analysis.py, lines 18–69 · score 0.60 · AlphaDropout, bias, weighted, SELU, activations, layers
  13. [13] § Materials and methods › Interpretability framework ↔ operation/lrp_individual_analysis.py, lines 34–85 · score 0.60 · AlphaDropout, bias, weighted, SELU, activations, layers
  14. [14] § Materials and methods › Evaluation metrics ↔ biological_plausibility/scripts/02_calculate_gene_scores.py, lines 1–39 · score 0.59 · CancerMine, DGIdb, OncoKB, databases, Biological
  15. [15] § Results › DeepSHAP outperforms other XAI methods in discovery of prognostic factors from pan-cancer transcriptomic data ↔ biological_plausibility/scripts/database_loader.py, lines 19–37 · score 0.56 · Brain, Cell, Glioblastoma, Kidney, Papillary, Renal
  16. [16] § Materials and methods › Software and environment ↔ operation/command.sh, the whole file · a weak match · score 0.54 · DeepLIFT, DeepSHAP, Python, SNN, IG
  17. [17] § Materials and methods › Software and environment ↔ operation/evaluate_faithfulness.py, lines 335–383 · score 0.53 · GradientSHAP, DeepLIFT, DeepSHAP, IG

Paper

Loaded from Europe PMC by your browser, not stored by OSCR: doi.org · Europe PMC

The paper is loaded when this pane is shown.

The authors' code

Python · 644 lines · 30 KB · MIT · 5 matches

  1. #!/usr/bin/env python3
  2. """
  3. Step 1: 下载并准备各数据库
  4. - OncoKB: 癌症基因临床分级 (需API Token)
  5. - CGC: Cancer Gene Census (需COSMIC账号)
  6. - DGIdb: 药物-基因互作 (需手动下载)
  7. - CIViC: 临床变异解读 (可自动下载)
  9. 运行方式:
  10. python scripts/01_download_databases.py
  11. python scripts/01_download_databases.py --skip_existing # 跳过已存在的文件
  12. """
  14. import os
  15. import sys
  16. import time
  17. import argparse
  18. import requests
  19. import pandas as pd
  20. from pathlib import Path
  21. from io import StringIO
  23. # 添加父目录到路径
  24. sys.path.insert(0, str(Path(__file__).parent.parent))
  25. from config import DATABASE_DIR, ONCOKB_API_TOKEN
  28. def check_file_valid(filepath, min_rows=5):
  29. """检查文件是否存在且有效（非HTML，有足够行数）"""
  30. if not filepath.exists():
  31. return False
  32. try:
  33. # 检查是否为HTML（下载失败的情况）
  34. with open(filepath, 'r') as f:
  35. first_line = f.readline()
  36. if first_line.strip().startswith('<!') or first_line.strip().startswith('<html'):
  37. return False
  38. # 检查行数
  39. df = pd.read_csv(filepath, sep='\t' if filepath.suffix == '.tsv' else ',', nrows=min_rows)
  40. return len(df) >= min_rows
  41. except:
  42. return False
  45. def write_version_file(data_file: Path, lines):
  46. """为数据文件生成/更新一个 *_VERSION.txt 说明文件
  48. 版本文件命名规则: basename + "_VERSION.txt"，例如:
  49. - oncokb_genes.tsv -> oncokb_genes_VERSION.txt
  50. - opentargets_associations.tsv -> opentargets_associations_VERSION.txt
  51. """
  52. version_path = data_file.with_name(f"{data_file.stem}_VERSION.txt")
  53. timestamp = time.strftime("%Y-%m-%d %H:%M:%S")
  54. header = [f"Generated: {timestamp}"]
  55. content = header + list(lines)
  56. try:
  57. with open(version_path, "w", encoding="utf-8") as f:
  58. for line in content:
  59. f.write(str(line).rstrip("\n") + "\n")
  60. except Exception as e:
  61. print(f" ⚠ 写入版本说明文件失败: {version_path} ({e})")
  63. def download_oncokb():
  64. """
  65. 下载 OncoKB 癌症基因列表
  67. 注意: OncoKB 需要 API token，请先申请:
  68. https://www.oncokb.org/account/register
  69. """
  70. print("\n" + "="*60)
  71. print("下载 OncoKB 数据")
  72. print("="*60)
  74. output_file = DATABASE_DIR / "oncokb_genes.tsv"
  76. if ONCOKB_API_TOKEN:
  77. # 使用 API 获取完整数据
  78. headers = {"Authorization": f"Bearer {ONCOKB_API_TOKEN}"}
  79. url = "https://www.oncokb.org/api/v1/utils/allCuratedGenes"
  81. try:
  82. response = requests.get(url, headers=headers)
  83. response.raise_for_status()
  84. genes = response.json()
  86. df = pd.DataFrame(genes)
  87. df.to_csv(output_file, sep="\t", index=False)
  88. print(f"✓ 已保存 {len(df)} 个 OncoKB 基因到 {output_file}")
  89. write_version_file(output_file, [
  90. f"Source: {url}",
  91. "Description: OncoKB curated genes downloaded via official API",
  92. ])
  93. return True
  94. except Exception as e:
  95. print(f"✗ OncoKB API 请求失败: {e}")
  97. # 如果没有 API token，创建模板文件
  98. print("⚠ 未设置 ONCOKB_API_TOKEN 环境变量")
  99. print(" 请手动下载数据或设置环境变量后重试")
  100. print(" 申请地址: https://www.oncokb.org/account/register")
  102. # 创建模板文件，包含常见癌症基因
  103. template_genes = [
  104. {"hugoSymbol": "TP53", "highestSensitiveLevel": "1", "oncogene": False, "tsg": True},
  105. {"hugoSymbol": "EGFR", "highestSensitiveLevel": "1", "oncogene": True, "tsg": False},
  106. {"hugoSymbol": "BRAF", "highestSensitiveLevel": "1", "oncogene": True, "tsg": False},
  107. {"hugoSymbol": "KRAS", "highestSensitiveLevel": "1", "oncogene": True, "tsg": False},
  108. {"hugoSymbol": "PIK3CA", "highestSensitiveLevel": "1", "oncogene": True, "tsg": False},
  109. {"hugoSymbol": "ERBB2", "highestSensitiveLevel": "1", "oncogene": True, "tsg": False},
  110. {"hugoSymbol": "ALK", "highestSensitiveLevel": "1", "oncogene": True, "tsg": False},
  111. {"hugoSymbol": "ROS1", "highestSensitiveLevel": "1", "oncogene": True, "tsg": False},
  112. {"hugoSymbol": "MET", "highestSensitiveLevel": "1", "oncogene": True, "tsg": False},
  113. {"hugoSymbol": "RET", "highestSensitiveLevel": "1", "oncogene": True, "tsg": False},
  114. {"hugoSymbol": "BRCA1", "highestSensitiveLevel": "1", "oncogene": False, "tsg": True},
  115. {"hugoSymbol": "BRCA2", "highestSensitiveLevel": "1", "oncogene": False, "tsg": True},
  116. {"hugoSymbol": "ATM", "highestSensitiveLevel": "2", "oncogene": False, "tsg": True},
  117. {"hugoSymbol": "PTEN", "highestSensitiveLevel": "2", "oncogene": False, "tsg": True},
  118. {"hugoSymbol": "AKT1", "highestSensitiveLevel": "2", "oncogene": True, "tsg": False},
  119. ]
  121. print("\n ⚠ 创建模板文件（仅包含示例基因，请替换为完整数据）")
  122. df = pd.DataFrame(template_genes)
  123. df.to_csv(output_file, sep="\t", index=False)
  124. print(f" 模板已保存到 {output_file}")
  125. write_version_file(output_file, [
  126. "Source: local template (no ONCOKB_API_TOKEN)",
  127. "Description: example curated genes only, please replace with full OncoKB data",
  128. "Manual action: download full data from https://www.oncokb.org/ and overwrite this file",
  129. ])
  131. return False
  134. def download_dgidb():
  135. """
  136. 下载 DGIdb 药物-基因互作数据
  138. 注意: DGIdb 网站已改版 (2024)，旧API失效，需手动下载
  139. 下载地址: https://dgidb.org/downloads
  140. """
  141. print("\n" + "="*60)
  142. print("下载 DGIdb 数据")
  143. print("="*60)
  145. output_file = DATABASE_DIR / "dgidb_interactions.tsv"
  147. # 检查是否已有有效文件
  148. if check_file_valid(output_file, min_rows=100):
  149. print(f" ✓ 已存在有效数据文件: {output_file}")
  150. df = pd.read_csv(output_file, sep="\t")
  151. print(f" 包含 {len(df)} 条记录")
  152. # 保留用户手动下载版本，不覆盖版本说明，只在缺失时创建一个简短说明
  153. if not (output_file.parent / f"{output_file.stem}_VERSION.txt").exists():
  154. write_version_file(output_file, [
  155. "Source: user-provided DGIdb interactions.tsv",
  156. "Description: manually downloaded from https://dgidb.org/downloads",
  157. ])
  158. return True
  160. # DGIdb 网站已改版，API不可用，需要手动下载
  161. print(" ⚠ DGIdb 网站已改版，需要手动下载数据")
  162. print("")
  163. print(" 【手动下载步骤】:")
  164. print(" 1. 浏览器访问: https://dgidb.org/downloads")
  165. print(" 2. 找到并下载: interactions.tsv")
  166. print(" 3. 将文件保存到:")
  167. print(f" {output_file}")
  168. print("")
  170. # 创建扩展模板（包含常见 FDA 批准靶点药物）
  171. print(" 创建临时模板文件（包含常见靶点药物）...")
  173. template = [
  174. # EGFR 抑制剂
  175. {"gene_name": "EGFR", "drug_name": "Erlotinib", "interaction_types": "inhibitor", "approved": True},
  176. {"gene_name": "EGFR", "drug_name": "Gefitinib", "interaction_types": "inhibitor", "approved": True},
  177. {"gene_name": "EGFR", "drug_name": "Osimertinib", "interaction_types": "inhibitor", "approved": True},
  178. {"gene_name": "EGFR", "drug_name": "Afatinib", "interaction_types": "inhibitor", "approved": True},
  179. # BRAF 抑制剂
  180. {"gene_name": "BRAF", "drug_name": "Vemurafenib", "interaction_types": "inhibitor", "approved": True},
  181. {"gene_name": "BRAF", "drug_name": "Dabrafenib", "interaction_types": "inhibitor", "approved": True},
  182. {"gene_name": "BRAF", "drug_name": "Encorafenib", "interaction_types": "inhibitor", "approved": True},
  183. # HER2/ERBB2 抑制剂
  184. {"gene_name": "ERBB2", "drug_name": "Trastuzumab", "interaction_types": "antibody", "approved": True},
  185. {"gene_name": "ERBB2", "drug_name": "Pertuzumab", "interaction_types": "antibody", "approved": True},
  186. {"gene_name": "ERBB2", "drug_name": "Lapatinib", "interaction_types": "inhibitor", "approved": True},
  187. {"gene_name": "ERBB2", "drug_name": "Neratinib", "interaction_types": "inhibitor", "approved": True},
  188. # ALK 抑制剂
  189. {"gene_name": "ALK", "drug_name": "Crizotinib", "interaction_types": "inhibitor", "approved": True},
  190. {"gene_name": "ALK", "drug_name": "Alectinib", "interaction_types": "inhibitor", "approved": True},
  191. {"gene_name": "ALK", "drug_name": "Brigatinib", "interaction_types": "inhibitor", "approved": True},
  192. {"gene_name": "ALK", "drug_name": "Lorlatinib", "interaction_types": "inhibitor", "approved": True},
  193. # PARP 抑制剂 (BRCA)
  194. {"gene_name": "BRCA1", "drug_name": "Olaparib", "interaction_types": "inhibitor", "approved": True},
  195. {"gene_name": "BRCA2", "drug_name": "Olaparib", "interaction_types": "inhibitor", "approved": True},
  196. {"gene_name": "BRCA1", "drug_name": "Rucaparib", "interaction_types": "inhibitor", "approved": True},
  197. {"gene_name": "BRCA2", "drug_name": "Rucaparib", "interaction_types": "inhibitor", "approved": True},
  198. {"gene_name": "BRCA1", "drug_name": "Niraparib", "interaction_types": "inhibitor", "approved": True},
  199. {"gene_name": "BRCA2", "drug_name": "Niraparib", "interaction_types": "inhibitor", "approved": True},
  200. # PIK3CA
  201. {"gene_name": "PIK3CA", "drug_name": "Alpelisib", "interaction_types": "inhibitor", "approved": True},
  202. # KRAS
  203. {"gene_name": "KRAS", "drug_name": "Sotorasib", "interaction_types": "inhibitor", "approved": True},
  204. {"gene_name": "KRAS", "drug_name": "Adagrasib", "interaction_types": "inhibitor", "approved": True},
  205. # RET
  206. {"gene_name": "RET", "drug_name": "Selpercatinib", "interaction_types": "inhibitor", "approved": True},
  207. {"gene_name": "RET", "drug_name": "Pralsetinib", "interaction_types": "inhibitor", "approved": True},
  208. # MET
  209. {"gene_name": "MET", "drug_name": "Capmatinib", "interaction_types": "inhibitor", "approved": True},
  210. {"gene_name": "MET", "drug_name": "Tepotinib", "interaction_types": "inhibitor", "approved": True},
  211. # ROS1
  212. {"gene_name": "ROS1", "drug_name": "Crizotinib", "interaction_types": "inhibitor", "approved": True},
  213. {"gene_name": "ROS1", "drug_name": "Entrectinib", "interaction_types": "inhibitor", "approved": True},
  214. # NTRK
  215. {"gene_name": "NTRK1", "drug_name": "Larotrectinib", "interaction_types": "inhibitor", "approved": True},
  216. {"gene_name": "NTRK2", "drug_name": "Larotrectinib", "interaction_types": "inhibitor", "approved": True},
  217. {"gene_name": "NTRK3", "drug_name": "Larotrectinib", "interaction_types": "inhibitor", "approved": True},
  218. {"gene_name": "NTRK1", "drug_name": "Entrectinib", "interaction_types": "inhibitor", "approved": True},
  219. # FGFR
  220. {"gene_name": "FGFR2", "drug_name": "Pemigatinib", "interaction_types": "inhibitor", "approved": True},
  221. {"gene_name": "FGFR2", "drug_name": "Erdafitinib", "interaction_types": "inhibitor", "approved": True},
  222. {"gene_name": "FGFR3", "drug_name": "Erdafitinib", "interaction_types": "inhibitor", "approved": True},
  223. # IDH
  224. {"gene_name": "IDH1", "drug_name": "Ivosidenib", "interaction_types": "inhibitor", "approved": True},
  225. {"gene_name": "IDH2", "drug_name": "Enasidenib", "interaction_types": "inhibitor", "approved": True},
  226. # BCR-ABL
  227. {"gene_name": "BCR", "drug_name": "Imatinib", "interaction_types": "inhibitor", "approved": True},
  228. {"gene_name": "ABL1", "drug_name": "Imatinib", "interaction_types": "inhibitor", "approved": True},
  229. {"gene_name": "ABL1", "drug_name": "Dasatinib", "interaction_types": "inhibitor", "approved": True},
  230. {"gene_name": "ABL1", "drug_name": "Nilotinib", "interaction_types": "inhibitor", "approved": True},
  231. # KIT
  232. {"gene_name": "KIT", "drug_name": "Imatinib", "interaction_types": "inhibitor", "approved": True},
  233. {"gene_name": "KIT", "drug_name": "Sunitinib", "interaction_types": "inhibitor", "approved": True},
  234. # PDGFRA
  235. {"gene_name": "PDGFRA", "drug_name": "Imatinib", "interaction_types": "inhibitor", "approved": True},
  236. {"gene_name": "PDGFRA", "drug_name": "Avapritinib", "interaction_types": "inhibitor", "approved": True},
  237. # FLT3
  238. {"gene_name": "FLT3", "drug_name": "Midostaurin", "interaction_types": "inhibitor", "approved": True},
  239. {"gene_name": "FLT3", "drug_name": "Gilteritinib", "interaction_types": "inhibitor", "approved": True},
  240. # BTK
  241. {"gene_name": "BTK", "drug_name": "Ibrutinib", "interaction_types": "inhibitor", "approved": True},
  242. {"gene_name": "BTK", "drug_name": "Acalabrutinib", "interaction_types": "inhibitor", "approved": True},
  243. # BCL2
  244. {"gene_name": "BCL2", "drug_name": "Venetoclax", "interaction_types": "inhibitor", "approved": True},
  245. # VEGFR
  246. {"gene_name": "KDR", "drug_name": "Bevacizumab", "interaction_types": "antibody", "approved": True},
  247. {"gene_name": "KDR", "drug_name": "Sorafenib", "interaction_types": "inhibitor", "approved": True},
  248. {"gene_name": "KDR", "drug_name": "Sunitinib", "interaction_types": "inhibitor", "approved": True},
  249. # ESR1 (雌激素受体)
  250. {"gene_name": "ESR1", "drug_name": "Tamoxifen", "interaction_types": "antagonist", "approved": True},
  251. {"gene_name": "ESR1", "drug_name": "Fulvestrant", "interaction_types": "antagonist", "approved": True},
  252. # AR (雄激素受体)
  253. {"gene_name": "AR", "drug_name": "Enzalutamide", "interaction_types": "antagonist", "approved": True},
  254. {"gene_name": "AR", "drug_name": "Abiraterone", "interaction_types": "inhibitor", "approved": True},
  255. # CDK4/6
  256. {"gene_name": "CDK4", "drug_name": "Palbociclib", "interaction_types": "inhibitor", "approved": True},
  257. {"gene_name": "CDK6", "drug_name": "Palbociclib", "interaction_types": "inhibitor", "approved": True},
  258. {"gene_name": "CDK4", "drug_name": "Ribociclib", "interaction_types": "inhibitor", "approved": True},
  259. {"gene_name": "CDK6", "drug_name": "Ribociclib", "interaction_types": "inhibitor", "approved": True},
  260. # MTOR
  261. {"gene_name": "MTOR", "drug_name": "Everolimus", "interaction_types": "inhibitor", "approved": True},
  262. {"gene_name": "MTOR", "drug_name": "Temsirolimus", "interaction_types": "inhibitor", "approved": True},
  263. # SMO (Hedgehog)
  264. {"gene_name": "SMO", "drug_name": "Vismodegib", "interaction_types": "inhibitor", "approved": True},
  265. {"gene_name": "SMO", "drug_name": "Sonidegib", "interaction_types": "inhibitor", "approved": True},
  266. ]
  268. df = pd.DataFrame(template)
  269. df.to_csv(output_file, sep="\t", index=False)
  270. print(f" ✓ 模板已保存: {output_file}")
  271. write_version_file(output_file, [
  272. "Source: local template (DGIdb manual download required)",
  273. "Description: contains common FDA-approved targeted agents only, please replace with full DGIdb interactions.tsv",
  274. "Manual action: download interactions.tsv from https://dgidb.org/downloads and overwrite this file",
  275. ])
  276. print(f" 包含 {len(template)} 条 FDA 批准靶向药物记录")
  277. print(" ⚠ 请尽快下载完整数据替换此模板")
  278. return False
  281. def download_opentargets():
  282. """
  283. 下载 Open Targets Platform 基因-疾病关联数据
  285. Open Targets API 免费无需注册
  286. 为每个 TCGA 癌症类型下载相关基因列表
  287. """
  288. print("\n" + "="*60)
  289. print("下载 Open Targets 数据")
  290. print("="*60)
  292. output_file = DATABASE_DIR / "opentargets_associations.tsv"
  294. # 检查是否已有有效文件
  295. if check_file_valid(output_file, min_rows=100):
  296. print(f" ✓ 已存在有效数据文件: {output_file}")
  297. df = pd.read_csv(output_file, sep="\t")
  298. print(f" 包含 {len(df)} 条记录")
  299. if not (output_file.parent / f"{output_file.stem}_VERSION.txt").exists():
  300. write_version_file(output_file, [
  301. "Source: user-provided or previously downloaded Open Targets associations",
  302. "Description: gene-disease associations for TCGA cancer types via EFO/MONDO IDs",
  303. "URL: https://api.platform.opentargets.org/api/v4/graphql",
  304. ])
  305. return True
  307. # TCGA 癌种到 Open Targets EFO/MONDO ID 的映射 (已通过 API 验证)
  308. TCGA_TO_EFO = {
  309. "BLCA": ("MONDO_0001187", "bladder carcinoma"),
  310. "BRCA": ("EFO_0000305", "breast carcinoma"),
  311. "COADREAD": ("MONDO_0005575", "colorectal cancer"),
  312. "GBMLGG": ("EFO_0000519", "glioblastoma"),
  313. "HNSC": ("EFO_0000181", "head and neck squamous cell carcinoma"),
  314. "KIRC": ("EFO_0000349", "renal cell carcinoma"),
  315. "KIRP": ("EFO_0000640", "papillary renal cell carcinoma"),
  316. "LGG": ("EFO_0005543", "low grade glioma"),
  317. "LIHC": ("EFO_0000182", "hepatocellular carcinoma"),
  318. "LUAD": ("EFO_0000571", "lung adenocarcinoma"),
  319. "LUSC": ("EFO_0000708", "lung squamous cell carcinoma"),
  320. "PAAD": ("EFO_1000044", "pancreatic adenocarcinoma"),
  321. "SKCM": ("EFO_0000389", "melanoma"),
  322. "STAD": ("EFO_0000503", "stomach carcinoma"),
  323. "UCEC": ("EFO_1001512", "endometrial carcinoma"),
  324. }
  326. # API 分页限制
  327. MAX_PAGE_SIZE = 2500 # API 最大允许 3000，保守设置 2500
  329. GRAPHQL_URL = "https://api.platform.opentargets.org/api/v4/graphql"
  331. # GraphQL 查询 - 获取疾病关联的所有靶点
  332. query = """
  333. query DiseaseAssociations($efoId: String!, $size: Int!) {
  334. disease(efoId: $efoId) {
  335. id
  336. name
  337. associatedTargets(page: { index: 0, size: $size }) {
  338. count
  339. rows {
  340. target {
  341. id
  342. approvedSymbol
  343. }
  344. score
  345. }
  346. }
  347. }
  348. }
  349. """
  351. all_associations = []
  353. print(f" 将下载 {len(TCGA_TO_EFO)} 种癌症类型的关联数据...")
  355. for tcga_code, (efo_id, disease_name) in TCGA_TO_EFO.items():
  356. print(f" {tcga_code} ({disease_name})...", end=" ", flush=True)
  358. try:
  359. # 分页下载关联数据
  360. page_index = 0
  361. total_rows = 0
  363. while True:
  364. response = requests.post(
  365. GRAPHQL_URL,
  366. json={
  367. "query": query,
  368. "variables": {"efoId": efo_id, "size": MAX_PAGE_SIZE}
  369. },
  370. timeout=120,
  371. headers={"Content-Type": "application/json"}
  372. )
  373. response.raise_for_status()
  374. data = response.json()
  376. # 检查是否有错误
  377. if "errors" in data:
  378. error_msg = data['errors'][0].get('message', '')[:100]
  379. print(f"API错误: {error_msg}")
  380. break
  382. # 安全解析
  383. disease_data = data.get("data", {})
  384. if disease_data is None:
  385. print("data 为空")
  386. break
  388. disease_info = disease_data.get("disease")
  389. if disease_info is None:
  390. print(f"未找到疾病 {efo_id}")
  391. break
  393. associated = disease_info.get("associatedTargets")
  394. if associated is None:
  395. print("无关联靶点")
  396. break
  398. rows = associated.get("rows", [])
  399. if not rows:
  400. break
  402. for row in rows:
  403. target = row.get("target", {}) or {}
  404. gene_symbol = target.get("approvedSymbol", "")
  405. if gene_symbol:
  406. all_associations.append({
  407. "tcga_code": tcga_code,
  408. "efo_id": efo_id,
  409. "disease_name": disease_name,
  410. "gene_symbol": gene_symbol,
  411. "ensembl_id": target.get("id", ""),
  412. "association_score": row.get("score", 0),
  413. })
  415. total_rows += len(rows)
  417. # 只取第一页 (2500 个基因已经足够覆盖 Top 100)
  418. break
  420. if total_rows > 0:
  421. print(f"{total_rows} 个基因")
  423. # 避免 API 限流
  424. time.sleep(0.3)
  426. except requests.exceptions.RequestException as e:
  427. print(f"网络错误: {e}")
  428. except Exception as e:
  429. print(f"失败: {type(e).__name__}: {e}")
  431. if all_associations:
  432. df = pd.DataFrame(all_associations)
  433. df.to_csv(output_file, sep="\t", index=False)
  434. print(f"\n ✓ 已保存 {len(df)} 条关联记录到 {output_file}")
  436. # 统计
  437. gene_count = df['gene_symbol'].nunique()
  438. print(f" 涵盖 {gene_count} 个独立基因")
  439. write_version_file(output_file, [
  440. "Source: Open Targets Platform GraphQL API",
  441. "Description: gene-disease associations for TCGA cancer types (first page up to 2500 targets per disease)",
  442. "URL: https://api.platform.opentargets.org/api/v4/graphql",
  443. ])
  444. return True
  445. else:
  446. print(" ✗ 未能下载任何数据")
  447. return False
  450. def download_cancermine():
  451. """
  452. 下载 CancerMine 文献挖掘数据
  454. CancerMine 是基于文献挖掘的癌症基因数据库，包含三种角色:
  455. - Driver: 驱动基因
  456. - Oncogene: 癌基因
  457. - Tumor_Suppressor: 抑癌基因
  459. 数据下载地址: https://zenodo.org/records/7689627
  460. (原网站 http://bionlp.bcgsc.ca/cancermine/ 已下线)
  461. """
  462. print("\n" + "="*60)
  463. print("下载 CancerMine 数据")
  464. print("="*60)
  466. output_file = DATABASE_DIR / "cancermine.tsv"
  468. # 检查是否已有有效文件
  469. if check_file_valid(output_file, min_rows=100):
  470. print(f" ✓ 已存在有效数据文件: {output_file}")
  471. df = pd.read_csv(output_file, sep="\t")
  472. print(f" 包含 {len(df)} 条记录")
  473. if not (output_file.parent / f"{output_file.stem}_VERSION.txt").exists():
  474. write_version_file(output_file, [
  475. "Source: user-provided or previously downloaded CancerMine data",
  476. "Description: literature-mined cancer gene associations (Driver/Oncogene/Tumor_Suppressor)",
  477. "URL: https://zenodo.org/records/7689627",
  478. ])
  479. return True
  481. # CancerMine 公开下载链接 (Zenodo - 原网站已下线)
  482. url = "https://zenodo.org/records/7689627/files/cancermine_collated.tsv?download=1"
  484. try:
  485. print(f" 下载: {url}")
  486. response = requests.get(url, timeout=300)
  487. response.raise_for_status()
  489. # 检查是否为有效TSV
  490. if response.text.strip().startswith('<!') or '<html' in response.text[:100].lower():
  491. print(" ✗ 返回HTML而非数据")
  492. raise Exception("Invalid response")
  494. df = pd.read_csv(StringIO(response.text), sep="\t")
  495. if len(df) > 100:
  496. df.to_csv(output_file, sep="\t", index=False)
  497. print(f" ✓ 已保存 {len(df)} 条 CancerMine 记录到 {output_file}")
  499. # 统计角色分布
  500. if 'role' in df.columns:
  501. role_counts = df['role'].value_counts()
  502. print(f" 角色分布:")
  503. for role, count in role_counts.items():
  504. print(f" - {role}: {count}")
  506. # 统计基因和癌症数量
  507. gene_col = 'gene_normalized' if 'gene_normalized' in df.columns else 'gene'
  508. cancer_col = 'cancer_normalized' if 'cancer_normalized' in df.columns else 'cancer'
  509. if gene_col in df.columns:
  510. print(f" 独立基因数: {df[gene_col].nunique()}")
  511. if cancer_col in df.columns:
  512. print(f" 独立癌症类型数: {df[cancer_col].nunique()}")
  514. write_version_file(output_file, [
  515. f"Source: {url}",
  516. "Description: CancerMine collated data - literature-mined cancer gene associations",
  517. "Roles: Driver, Oncogene, Tumor_Suppressor",
  518. f"Total records: {len(df)}",
  519. ])
  520. return True
  521. else:
  522. print(" ✗ 数据行数不足")
  524. except Exception as e:
  525. print(f" ✗ 下载失败: {e}")
  527. # 下载失败，创建模板
  528. print(" ⚠ 自动下载失败，创建模板文件...")
  529. print(" 请手动下载: https://zenodo.org/records/7689627")
  530. print(" 选择 cancermine_collated.tsv 并保存为 databases/cancermine.tsv")
  532. template = [
  533. {"gene_normalized": "TP53", "cancer_normalized": "breast cancer", "role": "Tumor_Suppressor", "citation_count": 100},
  534. {"gene_normalized": "BRCA1", "cancer_normalized": "breast cancer", "role": "Tumor_Suppressor", "citation_count": 80},
  535. {"gene_normalized": "BRCA2", "cancer_normalized": "breast cancer", "role": "Tumor_Suppressor", "citation_count": 70},
  536. {"gene_normalized": "EGFR", "cancer_normalized": "lung cancer", "role": "Oncogene", "citation_count": 90},
  537. {"gene_normalized": "KRAS", "cancer_normalized": "colorectal cancer", "role": "Driver", "citation_count": 85},
  538. {"gene_normalized": "BRAF", "cancer_normalized": "melanoma", "role": "Oncogene", "citation_count": 75},
  539. {"gene_normalized": "PIK3CA", "cancer_normalized": "breast cancer", "role": "Oncogene", "citation_count": 60},
  540. {"gene_normalized": "PTEN", "cancer_normalized": "prostate cancer", "role": "Tumor_Suppressor", "citation_count": 55},
  541. {"gene_normalized": "APC", "cancer_normalized": "colorectal cancer", "role": "Tumor_Suppressor", "citation_count": 50},
  542. {"gene_normalized": "IDH1", "cancer_normalized": "glioma", "role": "Driver", "citation_count": 45},
  543. {"gene_normalized": "ERBB2", "cancer_normalized": "breast cancer", "role": "Oncogene", "citation_count": 65},
  544. {"gene_normalized": "MYC", "cancer_normalized": "lymphoma", "role": "Oncogene", "citation_count": 70},
  545. {"gene_normalized": "RB1", "cancer_normalized": "retinoblastoma", "role": "Tumor_Suppressor", "citation_count": 40},
  546. {"gene_normalized": "VHL", "cancer_normalized": "kidney cancer", "role": "Tumor_Suppressor", "citation_count": 35},
  547. {"gene_normalized": "ALK", "cancer_normalized": "lung cancer", "role": "Oncogene", "citation_count": 55},
  548. ]
  549. df = pd.DataFrame(template)
  550. df.to_csv(output_file, sep="\t", index=False)
  551. print(f" 模板已保存到 {output_file}")
  552. write_version_file(output_file, [
  553. "Source: local template (CancerMine manual download required)",
  554. "Description: example cancer gene associations only, please replace with full CancerMine data",
  555. "Manual action: download cancermine_collated.tsv from http://bionlp.bcgsc.ca/cancermine/ and overwrite this file",
  556. ])
  557. return False
  560. def main():
  561. parser = argparse.ArgumentParser(description="下载生物学数据库")
  562. parser.add_argument('--skip_existing', action='store_true',
  563. help='跳过已存在的有效文件')
  564. args = parser.parse_args()
  566. print("="*60)
  567. print("XAI 生物学合理性评估 - 数据库下载")
  568. print("="*60)
  570. # 确保目录存在
  571. DATABASE_DIR.mkdir(parents=True, exist_ok=True)
  572. print(f"数据库目录: {DATABASE_DIR}")
  574. # 下载各数据库
  575. results = {
  576. "OncoKB": download_oncokb(),
  577. "DGIdb": download_dgidb(),
  578. "OpenTargets": download_opentargets(),
  579. "CancerMine": download_cancermine()
  580. }
  582. # 汇总
  583. print("\n" + "="*60)
  584. print("下载汇总")
  585. print("="*60)
  587. success_count = 0
  588. for db, success in results.items():
  589. if success:
  590. status = "✓ 完整数据"
  591. success_count += 1
  592. else:
  593. status = "⚠ 模板数据 (需替换)"
  594. print(f" {db}: {status}")
  596. print(f"\n 完整数据: {success_count}/6")
  598. # 检查文件大小
  599. print("\n" + "="*60)
  600. print("文件详情")
  601. print("="*60)
  603. files_info = [
  604. ("oncokb_genes.tsv", "OncoKB"),
  605. ("dgidb_interactions.tsv", "DGIdb"),
  606. ("opentargets_associations.tsv", "OpenTargets"),
  607. ("cancermine.tsv", "CancerMine"),
  608. ]
  610. for filename, db_name in files_info:
  611. filepath = DATABASE_DIR / filename
  612. if filepath.exists():
  613. try:
  614. sep = '\t' if filename.endswith('.tsv') else ','
  615. df = pd.read_csv(filepath, sep=sep)
  616. print(f" {db_name}: {len(df)} 条记录")
  617. except:
  618. print(f" {db_name}: 文件存在但无法读取")
  619. else:
  620. print(f" {db_name}: 文件不存在")
  622. # 下一步提示
  623. print("\n" + "="*60)
  624. print("下一步")
  625. print("="*60)
  627. if success_count < 6:
  628. print(" 需要补充的数据:")
  629. if not results["OncoKB"]:
  630. print(" - OncoKB: 申请 API Token → https://www.oncokb.org/account/register")
  631. if not results["DGIdb"]:
  632. print(" - DGIdb: 下载数据 → https://dgidb.org/downloads")
  633. if not results["OpenTargets"]:
  634. print(" - OpenTargets: 重新运行脚本 (API 免费)")
  635. if not results["CancerMine"]:
  636. print(" - CancerMine: 下载数据 → https://zenodo.org/records/7689627")
  637. print("")
  639. print(" 继续下一步 (可使用模板数据测试):")
  640. print(" python scripts/02_calculate_gene_scores.py --cancer BRCA --xai DeepLIFT")
  643. if __name__ == "__main__":
  644. main()

01_download_databases.py at commit 6d50a98, under MIT · at the source

Overview

Authors: Yiyi Zuo1, Shuting Yang2, Wenxue Zhao1
  1. Shenzhen Campus of Sun Yat-sen University, Molecular Cancer Research Center, School of Medicine, Shenzhen, China
  2. Sun Yat-sen University Sixth Affiliated Hospital, Department of Neurosurgery, Graceland Medical Center, Guangzhou, China
Institutions: Sun Yat-sen University (China); Sixth Affiliated Hospital of Sun Yat-sen University (China)
Journal: Frontiers in physiology, volume 17, article 1830956
Dates: received 15 March 2026; accepted 26 March 2026; published online 22 April 2026
Type: Research article · Language: English
License: CC BY
Identifiers: DOI 10.3389/fphys.2026.1830956 · PMID 42099920 · PMCID PMC13143651 · OpenAlex W7155191053
Open access: gold, a free copy (OpenAlex)
Status: code verified
Categories: genetics / omics (modality), other condition (population), clinical / translational (subfield)
Methods: Statistics, Machine learning, Connectivity
Keywords: cancer, deep learning, explainable AI (XAI), survival prediction, transcriptomics
Journal subjects: Technology and Code
Topic: Explainable Artificial Intelligence (XAI) (Artificial Intelligence, Computer Science), according to OpenAlex
Funding: Basic and Applied Basic Research Foundation of Guangdong Province
Citations: cited by 2 papers (Europe PMC); 34 references in the paper

Abstract

Explainable Artificial Intelligence (XAI) holds the promise to compensate for the “black-box” nature of deep learning which impedes transcriptome-based cancer survival prediction. However, there is a lack of systematic benchmarking XAI frameworks tailored for high-dimensional survival data. To bridge this gap, we systematically evaluated six representative XAI methods in three main categories: gradient-based, propagation-based, and perturbation-based approaches by using a Self-Normalizing Neural Network (SNN) as the baseline survival model. 6,248 samples across 15 cancer types from The Cancer Genome Atlas (TCGA) was analysed in this evaluation with a unified framework we developed. The evaluation metrics encompassed three key dimensions: prognostic factor enrichment (univariate Cox regression significance), biological consistency (supported by four authoritative databases, including OpenTargets), and explanation stability (Kuncheva Index). Among the six XAI methods, we find that DeepSHAP achieved the best overall performance, identifying the highest number of statistically significant prognostic factors while maintaining superior explanation stability; LRP (Layer-wise Relevance Propagation) showed slightly lower prognostic specificity but the highest consensus with biological databases in capturing general cancer genes, making it suitable for validating biological plausibility. In contrast, the perturbation-based method, PFI (Permutation Feature Importance) exhibited systematic failure and extremely low stability due to its inability to handle feature collinearity in high-dimensional transcriptomic data. Furthermore, we identified explanation stability as a robust proxy for the biological validity of the XAI. Collectively, this study establishes an empirical framework for selecting trustworthy AI explanation tools for precision medicine.

Reproduced under the paper's license (CC BY), from the paper cited above.

Repository

Its files are read in the Code ↔ Paper reader above, with 17 matches between paragraphs and lines of code.

ZYyli/xai-cancer-survival

License: MIT
State: the link answers, verified on 29 September 2026
Evidence: files inventoried
Commit: 6d50a980ab6a93475ff441b725970c9a554ef180, 1 April 2026
Languages: Python (44), Shell (1)
Size: 50 files, 45 scripts
Software Heritage: not archived
Found in: the text, “Software and environment”
Holds: README, license file, environment (requirements.txt)
Not found: CITATION.cff, tests, continuous integration, documentation
Tools: pandas (35 files), NumPy (34 files), Matplotlib (27 files), SciPy (26 files), PyTorch (23 files), statsmodels (19 files), seaborn (14 files), scikit-learn (7 files), SHAP (4 files)
Availability: 1 check, the latest on 29 September 2026: the link answers
  • 29 September 2026: the link answers
47 files
At the source: github.com/ZYyli/xai-cancer-survival.git

Tracing map

Proposed by the machine: these links were found in the paper and verified at the source, without human review. The map will receive a Zenodo DOI once one of the paper's authors has validated it with their ORCID.

What the map holds:

  • 1 repository of the authors' code, each at its verified commit, with its license and how the link was found in the paper;
  • 45 scripts, each with its path and the digest of its content;
  • 17 matches between paragraphs of the paper and lines of the code (method lexical-v1);
  • neither the text of the paper nor the code itself.

Its JSON (tracing-map.json) is deposited on Zenodo with its DOI once the map is validated.

Data

No dataset and no data link were found in the paper.

Data availability statement

The data presented in the study are deposited in the UCSC Xena repository. The RNA-seq datasets for the TCGA-COAD and TCGA-READ cohorts were obtained from the GDC Hub (https://xenabrowser.net/datapages/?dataset=TCGA-COAD.star_fpkm.tsv&host, https://xenabrowser.net/datapages/?dataset=TCGA-READ.star_fpkm.tsv&host). General access to other cancer datasets within the GDC hub is available at the UCSC Xena Browser (https://xenabrowser.net/datapages/). The original contributions presented in the study are included in the article/Supplementary Material. Further inquiries can be directed to the corresponding authors.

Reproduced under the paper's license (CC BY), from the paper cited above.

Versions

The history of this record: each version stored by the harvester or made by a correction of its authors or of the maintainers of its code, and what changed in its facts. The texts of the paper (its abstract, its availability statements) are not part of it; versions that changed only those are not listed.

Version 1, 29 September 2026: the first record

Recorded: type, language, journal, volume, pages, dates, 3 authors, 5 keywords, 1 funder, 30 references.

Cite

This paper

Zuo, Y., Yang, S., & Zhao, W. (2026). A systematic evaluation of explainable AI methods for high-dimensional transcriptome-based cancer survival prediction. Frontiers in physiology, 17, 1830956. https://doi.org/10.3389/fphys.2026.1830956

BibTeX

@article{zuo2026systematic,
author = {Zuo, Yiyi and Yang, Shuting and Zhao, Wenxue},
title = {{A systematic evaluation of explainable AI methods for high-dimensional transcriptome-based cancer survival prediction}},
journal = {Frontiers in physiology},
year = {2026},
month = apr,
volume = {17},
pages = {1830956},
publisher = {Frontiers Media SA},
issn = {1664-042X},
doi = {10.3389/fphys.2026.1830956},
url = {https://doi.org/10.3389/fphys.2026.1830956},
pmid = {42099920},
pmcid = {PMC13143651}
}

RIS

TY - JOUR
AU - Zuo, Yiyi
AU - Yang, Shuting
AU - Zhao, Wenxue
TI - A systematic evaluation of explainable AI methods for high-dimensional transcriptome-based cancer survival prediction
T2 - Frontiers in physiology
J2 - Front Physiol
PY - 2026
DA - 2026/04/22
VL - 17
SP - 1830956
SN - 1664-042X
PB - Frontiers Media SA
DO - 10.3389/fphys.2026.1830956
UR - https://doi.org/10.3389/fphys.2026.1830956
LA - en
ER -

CSL-JSON

{
"id": "10.3389/fphys.2026.1830956",
"type": "article-journal",
"title": "A systematic evaluation of explainable AI methods for high-dimensional transcriptome-based cancer survival prediction",
"container-title": "Frontiers in physiology",
"author": [
{
"family": "Zuo",
"given": "Yiyi"
},
{
"family": "Yang",
"given": "Shuting"
},
{
"family": "Zhao",
"given": "Wenxue"
}
],
"container-title-short": "Front Physiol",
"volume": "17",
"page": "1830956",
"DOI": "10.3389/fphys.2026.1830956",
"PMID": "42099920",
"PMCID": "PMC13143651",
"ISSN": "1664-042X",
"publisher": "Frontiers Media SA",
"URL": "https://doi.org/10.3389/fphys.2026.1830956",
"language": "en",
"issued": {
"date-parts": [
[
2026,
4,
22
]
]
}
}

The tracing map gets a citation of its own once an author has validated it and it has a DOI.

Similar papers

The papers with a page that share the most with this one: the tools found in their code, their categories, datasets, cited references and authors, the rarest counting most.

[1] doi:10.3389/fgene.2026.1799530 [code]
Sex-dependent prediction of autism.
Journal: Frontiers in genetics
In common: SHAP, statsmodels, seaborn, 5 other tools, genetics / omics, 1 reference
[2] doi:10.1038/s41467-026-71555-0 [code]
A deep representation learning model to predict response to vagus nerve stimulation.
Journal: Nature communications
In common: SHAP, PyTorch, seaborn, 5 other tools, clinical / translational, 1 reference
[3] doi:10.1038/s43856-026-01606-6 [code]
Validation of remote multimodal AI screening for Parkinson disease across diverse settings.
Journal: Communications medicine
In common: SHAP, statsmodels, PyTorch, 6 other tools, clinical / translational
[4] doi:10.1016/j.isci.2026.116825 [code]
Social hierarchy shapes behavioral and transcriptional responses to chronic stress and ketamine in male mice.
Journal: iScience
In common: SHAP, statsmodels, PyTorch, 6 other tools, genetics / omics
[5] doi:10.1186/s13059-026-04125-8 [code]
MLMarker: a machine learning framework for tissue inference and biomarker discovery.
Journal: Genome biology
In common: SHAP, statsmodels, PyTorch, 6 other tools, genetics / omics
[6] doi:10.1038/s42003-026-10957-8 [code]
Brain defence by the extracellular matrix protein Cochlin.
Journal: Communications biology
In common: SHAP, statsmodels, PyTorch, 6 other tools
[7] doi:10.1523/eneuro.0362-25.2026 [code]
Similarities between &lt;i&gt;Ciona&lt;/i&gt; Dorsal Motor Ganglion and Vertebrate Cerebellum: Did a Chordate Ancestor Already Show D/V Subdivision within a Hindbrain Precursor?
Journal: eNeuro
In common: SHAP, statsmodels, PyTorch, 6 other tools
[8] doi:10.1371/journal.pcbi.1014615 [code]
Toward reliable machine learning models for neural circuit inference: A diagnostic study of CNNs on spike trains.
Journal: PLoS computational biology
In common: SHAP, statsmodels, PyTorch, 6 other tools
[9] doi:10.1093/nargab/lqag050 [code]
TSProm: deep learning framework to predict tissue-specific regulatory logic.
Journal: NAR genomics and bioinformatics
In common: SHAP, statsmodels, PyTorch, 6 other tools
[10] doi:10.1093/bioinformatics/btag213 [code]
Interpretable deep survival analysis of Alzheimer's disease via metabolic genetic variants.
Journal: Bioinformatics (Oxford, England)
In common: SHAP, PyTorch, seaborn, 5 other tools, clinical / translational, genetics / omics

Contribute

The authors of this paper can claim it, correct its record and validate its tracing map, and the maintainers of its code (its owner, or a public member of its organization) correct what it says of their repository; anyone signed in can ask for its removal. Every request goes to OSCR's own machine, which answers it; your account page follows them.

Sign in with ORCID to claim this paper as one of its authors, correct its record or validate its tracing map: when the paper's metadata lists your ORCID iD, you are recognized at once. Maintainers of its code: sign in with GitHub, then claim the repository on your account page.

Request its removal

To ask OSCR to remove this record, the copies of its authors' scripts or its tracing map, use the removal request page: signed in, you say who you are, what to remove and why, then review and confirm the request. Published rules decide every request (how).

Discussion, reproductions, activity

Discussion: questions and error reports about this paper and its code, from signed-in readers and its authors. It opens with sign-in.

Reproductions: reports from readers who ran the authors' code: what they reproduced, with which environment, commit and data. It opens with sign-in.

Activity: what happens around this paper: new versions of its record, its map's validation, discussions and reproductions. It opens with sign-in.