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 애플리케이션이 추론할 수 있도록 합니다. 이를 통해 "이 청징기(clarifier)에는 무엇이 공급되는가?" 또는 "FIC-0502는 무엇을 조작하는가?"와 같은 질문을 던지고 도면에서 직접 답변을 얻을 수 있습니다.
작동 원리
이것은 Claude skill입니다. Claude Code에 설치하고 P&ID PDF를 폴더에 넣은 다음 Claude에게 변환을 요청하면 됩니다. Claude가 시각적 읽기(심볼 인식 및 선 추적에는 인간과 같은 판단력이 필요)를 수행하고, 테스트된 Python 스크립트가 페이지 준비, 그래프 구축, 검사 등의 일상적인 작업을 처리합니다.
파이프라인은 4단계로 구성됩니다:
- 페이지 준비. 스크립트가 각 페이지를 검사하여 검색 가능한 텍스트가 있는 디지털, 윤곽선 텍스트가 있는 디지털, 스캔, OCR이 있는 스캔으로 분류하고 각각 다르게 처리합니다. 페이지는 똑바로 회전되고 도면의 텍스트 크기에 맞는 해상도로 렌더링되며 겹치는 타일로 잘립니다(빈 여백은 건너뜁니다).
- Claude가 각 시트를 읽음. Claude가 전체 시트를 읽은 다음 각 타일을 자세히 읽어 장비, 배관, 밸브, 계기, 신호선 및 페이지 간 커넥터를 시트상의 위치 및 신뢰도와 함께 기록합니다. 읽을 수 없는 것은 그대로 표시하며 추측하지 않습니다. 큰 도면 세트로 인해 Claude에 과부하가 걸리지 않도록 각 시트는 별도로 저장됩니다.
- 그래프 구축 및 검사. 스크립트가 Claude의 읽기 결과를 하나의 연결된 그래프로 조립합니다. 배관은 밸브 사이의 세그먼트로 분할되고, 페이지 간 커넥터는 시트를 연결하여 전체 공장에서 흐름을 추적할 수 있게 하며, 계기는 측정하는 정확한 세그먼트나 용기에 부착되고, 제어 루프는 ISA-5.1 태그 번호와 신호선에서 조립됩니다. QA 보고서에는 의심스러운 항목(위치 정보가 없는 센서, 고립된 커넥터 등)이 나열되며, 보고서가 깨끗해질 때까지 Claude가 도면의 각 항목을 다시 확인합니다.
- 질문하기. 결과는
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용)로 내보내기 가능
- 장비 및 계기는 P&ID 데이터 교환의 산업 표준인 DEXPI 클래스를 가짐
- MIT 라이선스; README는 설계, 운영 또는 HAZOP이나 LOPA와 같은 안전 연구에 사용하기 전에 자격을 갖춘 엔지니어가 그래프를 검토해야 한다고 경고합니다
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트