2 つの基板リビジョンを比較する（Board Diff）¶
ページの目的¶
管理済みリビジョンから Board Diff を開始し、Before / After の方向を理解して、オブジェクト単位の変更を確認し、JSON または PNG を書き出します。
対応プラットフォーム¶
- macOS 14 以降：現在の主要なワイド画面体験および初回受け入れプラットフォームです。
- iOS / iPadOS 17.0 以降：アプリ内に入口があります。横向きまたは広いウィンドウを推奨し、狭い画面向け最適化は今後も改善します。
対象ユーザー¶
- 同じ PCB の 2 リビジョンを比較する設計、製造、レビュー担当者
- 方向、レイヤーペア、オブジェクト、リスクヒントを検証するテスター
前提条件¶
内容は異なるが、実際の解決形式が同じ 2 つの基板を選びます。
| 入力 | 現在の状態 |
|---|---|
| DSN | 対応 |
単体 KiCad .kicad_pcb |
対応 |
| Gerber + Excellon のフォルダーまたはアーカイブ | 対応 |
| SES | 両側が同一の検証済みベース設計を特定できる場合のみ対応 |
| ODB++、IPC-2581、完全な KiCad Project | Board Diff では明示的に非対応 |
Before と After には方向があります。
Added：Afterにだけ存在。Removed：Beforeにだけ存在。Modified：両側で対応するが、属性または形状が異なる。Unchanged：両側で同一で、コンテキストとしてのみ表示。
拡張子が一致しても形式の一致は保証されません。PCBAtlas は両側を個別に解決してから比較可否を決めます。
操作手順¶
ライブラリの 2 リビジョンを比較する¶
- 2 件以上のリビジョンを持つライブラリ文書を探します。
- 文書カードの追加操作メニューを開きます。
Compare Revisions…を選択します。BeforeとAfterで、異なる同一形式のリビジョンを選びます。Compareを選択します。
現在のリビジョンに親がある場合、parent が Before、current が After として優先されます。どちらも変更できます。
完了した管理比較は検証済み artifact として保存されます。同じ文書の比較ページで Reopen Saved Comparison を使うと再度開けます。
曖昧なレイヤーペアを確認する¶
PcbCore が複数の互換候補を見つけると、Layer pairing needs confirmation で一時停止します。
- 各
Beforeレイヤーの名前、役割、順序、オブジェクト数を確認します。 - 正しい
After layerを選びます。 - すべての曖昧項目に選択があることを確認します。
Confirm and Compareを選びます。
曖昧な場合にレイヤーを推測せず、自動平行移動 / 回転で基板を強制的に合わせません。基板全体の移動や回転は実際の差分として残ります。
比較を待つ、またはキャンセルする¶
入力検証、Before / After インポート、レイヤーペア、スナップショット、形状マッチング、リスク分析、正確な Diff scene、永続化の進行状況が順に表示されます。
Cancel 後は Cancelling comparison… が終わるまで待ちます。両方の 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 では引き続きシステムのファイル受け渡し画面を使います。- 管理リビジョン比較は
Reopen Saved Comparisonから再度開けます。 - リビジョン内容、形式、ポリシー、レイヤーペアが変わると、古い artifact は無効になり、黙って表示されません。
受け入れチェックリスト¶
- リビジョンが 1 件だけの文書では
Compare Revisions…が無効。 - 同一形式の 2 管理リビジョンを実行し、
Reopen Saved Comparisonで再表示できる。 - 同一入力、異形式、非対応形式、SES base 不一致で理由を示して
Compareをブロックする。 - 曖昧レイヤーは手動ペア後にのみ続行する。
-
Overlay / Split / Blink間でカメラ位置が一貫する。 - Split の
Sync Cameraの両状態が正しく、Fitが基板全体を復元する。 - 変更種類、オブジェクト種類、Net、リスクの各フィルターが結果を絞れる。
- リスト、Viewer pick、
Previous / Nextが同じ変更を双方向に特定する。 -
Swapが方向、色、統計、詳細、リスクを正しく反転する。 - 大きな比較を中止するとクリーンアップを待ち、その後再実行できる。
- JSON と PNG を書き出せ、入力変更後に古い管理 artifact を誤使用しない。
現在の明確な境界¶
- 同一形式のみで、形式をまたぐ比較は非対応です。
- ODB++、IPC-2581、完全な KiCad Project、回路図 Diff、3D Diff は非対応です。
- 自動マージ、変更承認、ソースへの書き戻しは行いません。
- 自動 alignment はなく、基板全体の平行移動や回転も差分です。
- 正確な形状 Diff の代替として画像ピクセル、bbox、ファイルテキストを使いません。
よくある質問¶
Compare が無効なのはなぜですか？¶
両側が選択済みで内容が異なり、同じ対応形式へ解決されるか確認します。Gerber / Excellon は任意の単一レイヤーファイル 2 つではなく、両側に完全な package フォルダーまたはアーカイブを渡してください。
拡張子が同じでも形式不一致になるのはなぜですか？¶
形式はファイル名だけでなく実際の解決結果で決まります。ディレクトリ、アーカイブ、SES ベース設計、解決された board entry も検証対象です。
キャンセル直後に再試行できないのはなぜですか？¶
新旧タスクの資源重複を防ぐため、PcbCore が Before / After の両セッションと一時データを解放するまで待ちます。Cancelling comparison… が消えてから再試行してください。
Swap 後に件数やリスクも変わるのはなぜですか？¶
Added / Removed とリスクは方向性があります。Swap はラベル交換ではなく、逆の Before / After で再計算します。
結果¶
1 つのワークスペースで両側の正確な変更を特定し、方向性リスクを確認し、JSON / PNG を書き出せます。管理比較は検証済み状態で保存し、再表示できます。
最終確認日¶
2026-07-30