ScottDuncanAI/PID-to-Knowledge-Graph

P&ID to Knowledge Graph: a Claude skill that turns P&ID PDFs (digital or scanned) into a process knowledge graph of flow, instruments and control loops.

解决的问题

管道仪表图 (P&IDs) 是展示化工厂管道和控制方式的标准图纸,通常仅以 PDF 格式存在。其中的信息(哪个储罐连接哪个泵、仪表测量什么、控制回路如何布线)被锁定在计算机无法直接查询的图片和标签中。本项目将这些 PDF 转换为结构化的 knowledge graph,供 LLM 应用程序进行推理,这样你就可以询问诸如“什么为这个澄清器供料?”或“FIC-0502 控制什么?”之类的问题,并直接从图纸中获得答案。

工作原理

这是一个 Claude skill:你将其安装到 Claude Code 中,将 P&ID PDF 放入文件夹,并要求 Claude 进行转换。Claude 负责视觉阅读(识别符号和追踪线条需要类似人类的判断力),而经过测试的 Python 脚本处理常规工作——准备页面、构建图谱并进行检查。

该流水线分为四个阶段:

  1. 准备页面。 脚本检查每一页并将其分类为:数字版(带可搜索文本)、数字版(带轮廓文本)、扫描版或扫描版(带 OCR)——每种类型都有不同的处理方式。页面会被旋转至正向,以匹配图纸文本大小的分辨率进行渲染,并切割成重叠的图块(跳过空白页边距)。
  2. Claude 读取每一张图纸。 Claude 读取整张图纸,然后近距离读取每个图块,记录设备、管道、阀门、仪表、信号线和跨页连接器——每个都带有其在图纸上的位置和置信度。任何无法读取的内容都会被标记,绝不猜测。每张图纸单独保存,以免大型图纸集导致 Claude 过载。
  3. 构建并检查图谱。 脚本将 Claude 的读取结果组装成一个连接的图谱:管道被拆分为阀门之间的段,跨页连接器连接图纸以便在整个工厂范围内追踪流程,仪表被连接到它们测量的确切段或容器,控制回路则根据 ISA-5.1 标签编号和信号线进行组装。质量保证 (QA) 报告会列出任何可疑项(没有位置的传感器、孤立的连接器),Claude 会重新检查图纸上的每一项,直到报告清理完毕。
  4. 提问。 结果存放在 work/<plant name>/kg/ 中:summary.md(供 LLM 阅读的工厂概览)、graph.json(完整图谱)和 graph.duckdb(用于 SQL 查询的小型数据库文件,包括递归的上游/下游搜索)。每一项都记录了其来源图纸,因此答案可以追溯到原始图纸。

适用人群

拥有 P&ID 或 PFD PDF(数字版或扫描版)并希望使这些信息可供 LLM 应用程序查询的工艺和化学工程师。无需编程:你只需要 Claude Code 和 Python 3.10+(推荐 3.12;在 3.13+ 上该技能可以运行,但会丢失 OCR 交叉检查和自动页面方向调整功能)。README 还提供了来自真实许可设施的公共 P&ID 数据集,如果你想在没有自己图纸的情况下进行尝试,可以参考这些数据集。

亮点

  • 处理数字版(CAD 导出)和扫描版 P&ID,包括横向页面、轮廓文本和低对比度扫描件(放大至 2.5 倍并增强对比度)
  • 捕捉工艺流程、测量位置和控制回路——从传感器到控制器再到最终元件,包括 I/P 继电器、级联、联锁和 VFD 驱动
  • 输出可读摘要、完整的 JSON 图谱和用于精确 SQL 查询的 DuckDB 数据库——无需服务器
  • QA 报告标记任何不确定的内容,Claude 会重新检查图纸上的每个标记项,直到报告清理完毕
  • 在大型项目中可将图谱导出到 Neo4j 或 GraphML(用于 yEd、Gephi 或 NetworkX)
  • 设备和仪表带有最接近的 DEXPI 类,这是交换 P&ID 数据的行业标准
  • MIT 许可;README 警告在用于设计、操作或 HAZOP 或 LOPA 等安全研究之前,图谱必须由合格的工程师进行审查

相关

  • 项目
  • 项目
  • 项目
  • 项目