ドキュメント版 v2026.10.17.0

2 つの基板リビジョンを比較する（Board Diff）¶

今回確認したのはライブラリの Compare Revisions… 入口だけです。以下の比較手順は 2026-09-11 に再操作していません。このページを、現行ビルドの完全な Diff 受け入れ記録として扱わないでください。

このページの目的¶

ライブラリのリビジョンから Board Diff を始め、Before / After の方向を理解し、オブジェクト単位の変化を確認し、後から見返せる JSON または PNG をエクスポートできるようにします。

対応プラットフォーム¶

macOS 14 以降：現在の Board Diff の主なワイド画面体験と、最初の受け入れプラットフォームです。
iOS / iPadOS 17.0 以降：入口はアプリに含まれます。横向きまたは広いウィンドウを推奨します。狭い画面向けの専用最適化は今後の作業です。

対象読者¶

同一 PCB の 2 つのリビジョンを比較する設計、製造、レビュー担当者
方向、レイヤー、オブジェクト、リスク案内で Diff を受け入れる必要があるテスト担当者

前提条件¶

内容は異なるが、実際に解析された形式が同じ基板の組を選びます。

入力	現在の状態
DSN	対応
単板の KiCad `.kicad_pcb`	対応
Gerber + Excellon フォルダまたはアーカイブ	対応
SES	両側を検証でき、同じ基礎設計を指す場合のみ対応
ODB++、IPC-2581、Altium PCB／ライブラリ、完全な KiCad Project	現時点では Board Diff 非対応と明示

Before と After には方向があります。

Added：After にだけ存在する。
Removed：Before にだけ存在する。
Modified：両側のオブジェクトを対応付けできるが、属性または幾何が異なる。
Unchanged：両側同じで、文脈としてだけ表示する。

拡張子が同じでも形式が同じとは限りません。PCBAtlas は両側を別々に解析してから、比較できるかを決めます。

操作手順¶

ライブラリの 2 つのリビジョンを比較する¶

ライブラリで、リビジョンが 2 つ以上あるドキュメントを見つけます。
ドキュメントカードのその他操作メニューを開きます。
Compare Revisions… をクリックします。
Before と After で、形式が同じ別リビジョンを 2 つ選びます。
Compare をクリックします。

現在リビジョンに親がある場合、ページは parent を Before、current を After として優先します。両側は手動で変えられます。

完了したホスト済み比較は、検証済み artifact を保存します。同じドキュメントの比較ページに次回入るときは、Reopen Saved Comparison で再開できます。

あいまいなレイヤー対応を確認する¶

PcbCore が互換候補を複数見つけると、比較は Layer pairing needs confirmation で止まります。

各 Before レイヤーについて、名前、役割、順序、オブジェクト数を確認します。
右側で正しい After layer を選びます。
すべての項目に選択があることを確認します。
Confirm and Compare をクリックして再実行します。

PCBAtlas は対応があいまいなときにレイヤーを推測せず、自動の平行移動／回転で 2 枚の基板を無理に揃えません。基板全体の平行移動や回転は、実際の変化として残します。

比較を待つかキャンセルする¶

比較は入力検証、Before / After のインポート、レイヤー対応、スナップショット、幾何マッチング、リスク分析、Diff scene、永続化の進捗を順に表示します。

Cancel をクリックしたあとは、Cancelling comparison… が終わるまで待ってください。2 つの native session と一時 staging データが解放されてから、ページは安全な再試行を許可します。

比較ワークスペースを読む¶

表示モード¶

Overlay：1 つの正確な合成シーンに変化を重ねます。Context は未変化の文脈の強さを制御します。
Split：左が Before、右が After。Sync Camera は既定でオンです。オフにすると両側を別々に確認できます。
Blink：同じカメラで Before / After を自動切替します。わずかなずれを見つけるのに向きます。
Fit：現在のシーンを表示領域に合わせ直します。

レイヤーと変化¶

左側の Layer Pairs は対応結果と、各ペアの変化数を示します。
All layers で基板全体を見るか、1 つのレイヤーペアを選んで範囲を絞ります。
右側の Changes では Added / Removed / Modified を切り替え、オブジェクト種類と Net でフィルターできます。
変化行をクリックするとオブジェクトを位置付けてハイライトします。Viewer でオブジェクトを選ぶと、対応する変化も逆引きされます。
Previous / Next は現在のフィルター結果を順にたどります。macOS ショートカットは ⌘[ と ⌘] です。
Risks パネルはリスクレベルで方向付きの案内を絞ります。リスク案内はレビュー位置の手がかりであり、DRC や製造サインオフの代替ではありません。

方向の入れ替え、エクスポート、再開¶

Swap は逆方向の要求を作って再計算します。元の Added / Removed、統計、リスク、詳細は方向とともに反転します。
JSON は安定した版付きの意味結果をエクスポートします。iOS はファイルを他のアプリに渡します。
PNG は現在の Diff ビューのスクリーンショットをエクスポートします。iOS は Photos に直接保存し、macOS はシステムのファイル引き渡し UI を使います。
ホスト済みリビジョン比較が完了したら、Reopen Saved Comparison から検証済み結果を再開できます。
リビジョン内容、形式、方針、レイヤー対応が変わっている場合、古い artifact は無効と判定され、古い結果を黙って出しません。

ワイドシェルとナローシェル¶

どちらのレイアウトも、ライブラリのドキュメント操作メニューから比較に入ります。通常の Viewer Split を Board Diff の代わりに使わないでください。通常プロジェクトの Split は PCB と回路図のデュアルキャンバス、Diff の Split は Before と After です。狭いウィンドウで比較設定や結果パネルが窮屈なら、ウィンドウを広げて読んでください。今回はナローシェルの Diff レイアウトを検証していません。

受け入れチェックリスト¶

現在の明確な境界¶

同形式の入力だけを比較し、形式をまたいだ比較には対応しません。
ODB++、IPC-2581、Altium PCB／ライブラリ、完全な KiCad Project、回路図 Diff、3D Diff には対応しません。
自動マージ、変化の受け入れ、ソースファイルの逆方向修正は行いません。
自動 alignment は提供しません。基板全体の平行移動と回転は、見える差のまま残ります。
正確な幾何 Diff の代替として、画像ピクセル、bbox、ファイルテキストは使いません。

よくある質問¶

なぜ `Compare` ボタンが使えないのですか？¶

両側が選ばれているか、内容が異なるか、同じ対応形式として解析されているかを確認してください。Gerber / Excellon では、完全な package のフォルダまたはアーカイブを両側に渡してください。任意の単層ファイル 2 つで完全な基板の代わりにはなりません。

同じ拡張子なのに形式不一致と出るのはなぜですか？¶

形式は実際の解析結果で決まり、ファイル名だけでは決まりません。ディレクトリ、アーカイブ、SES 基礎設計、実際の board entry が検証に加わります。

キャンセル直後に再比較できないのはなぜですか？¶

ページは PcbCore が Before / After の 2 セッションと一時データを解放するのを待ち、新しい作業が古い作業と同時に資源を使わないようにします。Cancelling comparison… が消えてから再試行してください。

Swap のあと変化数やリスクも変わるのはなぜですか？¶

Added / Removed とリスク案内には方向があります。Swap は表示ラベルの入れ替えではなく、逆の Before / After で再計算します。

結果¶

比較後、同じワークスペースで両側の正確な変化を位置付け、方向付きリスクを確認し、JSON / PNG をエクスポートできます。ライブラリのリビジョン比較は保存し、検証後に再開することもできます。

最終確認日¶

2026-07-30（元の手順記録）。2026-09-11 はライブラリ入口を確認し、比較は再実行していません。