Pick-and-Place Revisions
When a customer sends a new pick-and-place (PnP, centroid, XY) file, Gerbtrace shows what changed against the previous one: parts added or removed, parts moved to the other side, moved or rotated, and changed values or packages. Both files go through the same import as the SMD and THT tabs, so column mapping, units (mm, mil, inch), the side column and KiCad footprint prefixes are handled the same way.
Where to compare
- SMD or THT tab – click Compare revisions above the component list. Pick the old revision (a pick-and-place file of the project or an upload) and the new one (usually an upload). Editors can then replace the project file with the new one (see Replacing the project file).
- Compare mode – create a compare project with the old file in Packet 1 and the new file in Packet 2. Select the matched pair in the sidebar and the pick-and-place diff replaces the canvas; Text Diff still shows the raw file text.
Side, units and columns
Each side is read with the header row, column mapping and units Gerbtrace detects, or with the project's stored settings for a project file. An uploaded new revision takes the side (top, bottom, or both from a side column) and the unit setting of the old project file; any other upload gets its side from its side column, like an import, else from its file name. If the new file renames or reorders its columns, fields it cannot map are taken from the old revision's mapping by header name, and the summary says how many columns were mapped like the old revision.
Use Columns on either side to change the side, the X/Y units or a column. A top or bottom file ignores rows whose side column names the other side, as the project does. Compare a separate top and bottom file each against its new revision.
How parts are matched
Parts are matched by designator; case and surrounding spaces do not matter. A designator that appears more than once in a file (for example on a panel) is paired with the nearest part of the same name, on the same side first, and flagged above the table. Parts left over are added or removed.
For each matched part Gerbtrace compares:
- Side – top or bottom.
- Position – a move counts when the part moved at least the move tolerance (default 0.05 mm).
- Rotation – a change counts when it is at least the rotation tolerance (default 0.5°). Rotation is compared modulo 360°, so 0° and 360° are the same.
- Value, package and description – only when both files have the column. Case and spacing in package and description are formatting; in a value, case counts (
1mis not1M). - Other columns both files have, except row numbers and extra coordinate columns such as
Pad X.
Change the tolerances in the toolbar; Gerbtrace remembers them in this browser.
Origin changes
When most parts moved by the same distance, the CAD origin probably changed. Gerbtrace says so above the table. Turn on Ignore this shift to subtract it and see only the parts that moved against the rest. After replacing the file, check the origin in the SMD tab.
BOM check
In a project with a BOM, the diff also lists added parts that no BOM line names, and removed parts that a BOM line still names, so the BOM can be updated with the placement file.
Reading the result
The summary counts added, removed, changed and unchanged parts, and how many moved, rotated or changed side. Filter by change type (Added, Removed, Side, Moved, Rotated, Value, Package, Description & other), search by designator, value or package, or turn on Show unchanged. The line column shows each part's row in the parsed files (#3 → #4).
Export
Use Export to download:
- Excel workbook (.xlsx) – a summary sheet (with the tolerances, any common shift and the BOM check) and the changed placements.
- Changed placements (.csv).
File names follow the export naming scheme, for example Board_PnP-Revision-Diff.xlsx.
Replacing the project file
In the SMD or THT tab, an editor can click Replace file with this revision when the old side is a project file and the new side is an upload. This needs that tab and the Files tab unlocked. After you confirm:
- The old file is removed from the project and the new file is added with the side, units and column mapping used in the compare.
- Placement edits (rotation corrections, DNP, package mapping, notes, groups) belong to the designator, so parts that keep their designator keep them. New parts come in without edits, and removed parts are dropped.
- The old file is not kept. The confirmation offers Download old revision and Export diff (.xlsx).
Nothing is stored by the compare itself: the diff exists only while it is open.