用途:查询 EBI 电子显微镜数据库(EMDB)中的三维电镜密度图(主要为冷冻电镜与冷冻电子断层扫描)及其拟合的 PDB 原子模型,适用于按关键词查找密度图、获取下载链接、识别拟合模型、检索元数据与引文、按物种或分辨率筛选结构。
主要能力:1) 关键词检索走 EBI Search WS(https://www.ebi.ac.uk/ebisearch/ws/rest/emdb),支持 query、size、start、fields、format 参数分页;2) 单条目详情走 https://www.ebi.ac.uk/emdb/api/entry/{EMD-XXXXX},返回元数据、map 头、拟合 PDB 列表与引文;3) 可读取分辨率、重构方法、物种、样品、map 文件名与格式、轮廓阈值、DOI/PubMed ID;4) 推导密度图下载地址 https://ftp.ebi.ac.uk/pub/databases/emdb/structures/{EMDB_ID}/map/{file}。
必要用法:需 Python 包 requests、pandas、matplotlib,安装命令 pip install requests pandas matplotlib;无需认证或 API 密钥。检索示例:requests.get(EBI_SEARCH, params={"query":"sars-cov-2 spike","size":5,"format":"json","fields":"id,name,resolution,em_method,organism"})。
限制:官方未公布速率限制,批量循环建议每次请求间加 time.sleep(0.2);/emdb/api/search/ 会忽略 q= 并返回最新条目,应改用 EBI Search WS;条目 API 无 /map、/fitted、/publications 等子端点;resolution.valueOf_ 为字符串需显式转 float;EBI Search 字段值以列表返回,需取 [0]。仅覆盖实验电镜图,原子坐标应改用 pdb-database,AI 预测结构应改用 alphafold-database-access。