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スクリプトがページの準備、グラフの構築、チェックといったルーチン作業を処理します。

パイプラインは4つのステージで構成されています:

  1. ページの準備。 スクリプトが各ページを検査し、検索可能なテキスト付きデジタル、アウトラインテキスト付きデジタル、スキャン、OCR付きスキャンに分類し、それぞれ異なる処理を行います。ページは正立させられ、図面のテキストサイズに合わせた解像度でレンダリングされ、重なり合うタイルにカットされます(空白の余白はスキップされます)。
  2. Claudeによる各シートの読み取り。 Claudeがシート全体を読み取り、次に各タイルを詳細に読み取り、機器、配管、バルブ、計器、信号線、ページ間コネクタを、シート上の位置と信頼度とともに記録します。読み取れないものはそのようにマークされ、推測は一切行われません。大きな図面セットでClaudeに負荷がかからないよう、各シートは個別に保存されます。
  3. グラフの構築とチェック。 スクリプトがClaudeの読み取り結果を1つの接続されたグラフに組み立てます。配管はバルブ間のセグメントに分割され、ページ間コネクタがシートをリンクしてプラント全体でフローを追跡できるようにし、計器は測定対象の正確なセグメントや容器に取り付けられ、制御ループは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用)にエクスポート可能
  • 機器や計器には、P&IDデータ交換の業界標準であるDEXPIクラスが割り当てられる
  • MITライセンス。READMEには、設計、運用、またはHAZOPやLOPAなどの安全研究で使用する前に、グラフを資格のあるエンジニアがレビューする必要がある旨が警告されています

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト