[{"data":1,"prerenderedAt":494},["ShallowReactive",2],{"docs-navigation":3,"\u002Fdocs\u002Ftools\u002Fpnp-revisions":202,"\u002Fdocs\u002Ftools\u002Fpnp-revisions-surround":489},[4],{"title":5,"path":6,"stem":7,"children":8},"Docs","\u002Fdocs","docs",[9,12,16,20,73,102,135,156,177],{"title":10,"path":6,"stem":11},"Gerbtrace Documentation","docs\u002Findex",{"title":13,"path":14,"stem":15},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",{"title":17,"path":18,"stem":19},"Licensing","\u002Fdocs\u002Flicensing","docs\u002F2.licensing",{"title":21,"path":22,"stem":23,"children":24,"page":72},"Viewer","\u002Fdocs\u002Fviewer","docs\u002F3.viewer",[25,29,33,37,41,45,49,53,57,60,64,68],{"title":26,"path":27,"stem":28},"Files","\u002Fdocs\u002Fviewer\u002Ffiles","docs\u002F3.viewer\u002F01.files",{"title":30,"path":31,"stem":32},"PCB","\u002Fdocs\u002Fviewer\u002Fpcb","docs\u002F3.viewer\u002F02.pcb",{"title":34,"path":35,"stem":36},"Panel","\u002Fdocs\u002Fviewer\u002Fpanel","docs\u002F3.viewer\u002F03.panel",{"title":38,"path":39,"stem":40},"Assembly","\u002Fdocs\u002Fviewer\u002Fassembly","docs\u002F3.viewer\u002F04.assembly",{"title":42,"path":43,"stem":44},"Jetprint","\u002Fdocs\u002Fviewer\u002Fjetprint","docs\u002F3.viewer\u002F05.jetprint",{"title":46,"path":47,"stem":48},"SMD","\u002Fdocs\u002Fviewer\u002Fsmd","docs\u002F3.viewer\u002F06.smd",{"title":50,"path":51,"stem":52},"THT","\u002Fdocs\u002Fviewer\u002Ftht","docs\u002F3.viewer\u002F07.tht",{"title":54,"path":55,"stem":56},"BOM","\u002Fdocs\u002Fviewer\u002Fbom","docs\u002F3.viewer\u002F08.bom",{"title":5,"path":58,"stem":59},"\u002Fdocs\u002Fviewer\u002Fdocs","docs\u002F3.viewer\u002F09.docs",{"title":61,"path":62,"stem":63},"Conversation","\u002Fdocs\u002Fviewer\u002Fconversation","docs\u002F3.viewer\u002F10.conversation",{"title":65,"path":66,"stem":67},"Summary","\u002Fdocs\u002Fviewer\u002Fsummary","docs\u002F3.viewer\u002F11.summary",{"title":69,"path":70,"stem":71},"Pricing","\u002Fdocs\u002Fviewer\u002Fpricing","docs\u002F3.viewer\u002F12.pricing",false,{"title":74,"path":75,"stem":76,"children":77,"page":72},"Tools","\u002Fdocs\u002Ftools","docs\u002F4.tools",[78,82,86,90,94,98],{"title":79,"path":80,"stem":81},"Exports","\u002Fdocs\u002Ftools\u002Fexports","docs\u002F4.tools\u002F1.exports",{"title":83,"path":84,"stem":85},"Compare","\u002Fdocs\u002Ftools\u002Fcompare","docs\u002F4.tools\u002F2.compare",{"title":87,"path":88,"stem":89},"Package Manager","\u002Fdocs\u002Ftools\u002Fpackage-manager","docs\u002F4.tools\u002F3.package-manager",{"title":91,"path":92,"stem":93},"Draw Tool","\u002Fdocs\u002Ftools\u002Fdraw-tool","docs\u002F4.tools\u002F4.draw-tool",{"title":95,"path":96,"stem":97},"BOM Revisions","\u002Fdocs\u002Ftools\u002Fbom-revisions","docs\u002F4.tools\u002F5.bom-revisions",{"title":99,"path":100,"stem":101},"Pick-and-Place Revisions","\u002Fdocs\u002Ftools\u002Fpnp-revisions","docs\u002F4.tools\u002F6.pnp-revisions",{"title":103,"path":104,"stem":105,"children":106,"page":72},"Collaboration","\u002Fdocs\u002Fcollaboration","docs\u002F5.collaboration",[107,111,115,119,123,127,131],{"title":108,"path":109,"stem":110},"Team Settings","\u002Fdocs\u002Fcollaboration\u002Fteam-settings","docs\u002F5.collaboration\u002F1.team-settings",{"title":112,"path":113,"stem":114},"Team Members","\u002Fdocs\u002Fcollaboration\u002Fteam-members","docs\u002F5.collaboration\u002F2.team-members",{"title":116,"path":117,"stem":118},"User Profile","\u002Fdocs\u002Fcollaboration\u002Fuser-profile","docs\u002F5.collaboration\u002F3.user-profile",{"title":120,"path":121,"stem":122},"Spaces","\u002Fdocs\u002Fcollaboration\u002Fspaces","docs\u002F5.collaboration\u002F4.spaces",{"title":124,"path":125,"stem":126},"Notifications","\u002Fdocs\u002Fcollaboration\u002Fnotifications","docs\u002F5.collaboration\u002F6.notifications",{"title":128,"path":129,"stem":130},"Plans & Billing","\u002Fdocs\u002Fcollaboration\u002Fplans-and-billing","docs\u002F5.collaboration\u002F7.plans-and-billing",{"title":132,"path":133,"stem":134},"MCP server","\u002Fdocs\u002Fcollaboration\u002Fconnected-apps","docs\u002F5.collaboration\u002F8.connected-apps",{"title":136,"path":137,"stem":138,"children":139,"page":72},"App","\u002Fdocs\u002Fapp","docs\u002F6.app",[140,144,148,152],{"title":141,"path":142,"stem":143},"Desktop App","\u002Fdocs\u002Fapp\u002Fdesktop","docs\u002F6.app\u002F1.desktop",{"title":145,"path":146,"stem":147},"Light & Dark Mode","\u002Fdocs\u002Fapp\u002Flight-dark-mode","docs\u002F6.app\u002F2.light-dark-mode",{"title":149,"path":150,"stem":151},"Performance Monitor","\u002Fdocs\u002Fapp\u002Fperformance-monitor","docs\u002F6.app\u002F3.performance-monitor",{"title":153,"path":154,"stem":155},"Report a Bug","\u002Fdocs\u002Fapp\u002Freport-a-bug","docs\u002F6.app\u002F4.report-a-bug",{"title":157,"path":158,"stem":159,"children":160,"page":72},"Guides","\u002Fdocs\u002Fguides","docs\u002F7.guides",[161,165,169,173],{"title":162,"path":163,"stem":164},"Importing Files","\u002Fdocs\u002Fguides\u002Fimporting-files","docs\u002F7.guides\u002F1.importing-files",{"title":166,"path":167,"stem":168},"Supported Formats","\u002Fdocs\u002Fguides\u002Fsupported-formats","docs\u002F7.guides\u002F2.supported-formats",{"title":170,"path":171,"stem":172},"Package Library","\u002Fdocs\u002Fguides\u002Fpackage-library","docs\u002F7.guides\u002F3.package-library",{"title":174,"path":175,"stem":176},"Panel Checks","\u002Fdocs\u002Fguides\u002Fpanel-checks","docs\u002F7.guides\u002F4.panel-checks",{"title":178,"path":179,"stem":180,"children":181,"page":72},"Reference","\u002Fdocs\u002Freference","docs\u002F8.reference",[182,186,190,194,198],{"title":183,"path":184,"stem":185},"BOM File Format","\u002Fdocs\u002Freference\u002Fbom-format","docs\u002F8.reference\u002F1.bom-format",{"title":187,"path":188,"stem":189},"Package Definitions","\u002Fdocs\u002Freference\u002Fpackage-definitions","docs\u002F8.reference\u002F2.package-definitions",{"title":191,"path":192,"stem":193},"Package Naming","\u002Fdocs\u002Freference\u002Fpackage-naming","docs\u002F8.reference\u002F3.package-naming",{"title":195,"path":196,"stem":197},"TPSys Format","\u002Fdocs\u002Freference\u002Ftpsys-format","docs\u002F8.reference\u002F4.tpsys-format",{"title":199,"path":200,"stem":201},"Jet Printing","\u002Fdocs\u002Freference\u002Fjet-printing","docs\u002F8.reference\u002F5.jet-printing",{"id":203,"title":99,"body":204,"description":482,"extension":483,"links":484,"meta":485,"navigation":486,"path":100,"seo":487,"stem":101,"__hash__":488},"docs\u002Fdocs\u002F4.tools\u002F6.pnp-revisions.md",{"type":205,"value":206,"toc":469},"minimark",[207,211,227,232,275,279,282,289,293,296,299,349,352,356,363,367,370,374,407,411,416,429,439,442,449,466],[208,209,99],"h1",{"id":210},"pick-and-place-revisions",[212,213,214,215,219,220,219,223,226],"p",{},"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 (",[216,217,218],"code",{},"mm",", ",[216,221,222],{},"mil",[216,224,225],{},"inch","), the side column and KiCad footprint prefixes are handled the same way.",[228,229,231],"h2",{"id":230},"where-to-compare","Where to compare",[233,234,235,253],"ul",{},[236,237,238,242,243,246,247,252],"li",{},[239,240,241],"strong",{},"SMD or THT tab"," – click ",[239,244,245],{},"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 ",[248,249,251],"a",{"href":250},"#replacing-the-project-file","Replacing the project file",").",[236,254,255,258,259,262,263,266,267,270,271,274],{},[239,256,257],{},"Compare mode"," – create a ",[248,260,261],{"href":84},"compare project"," with the old file in ",[239,264,265],{},"Packet 1"," and the new file in ",[239,268,269],{},"Packet 2",". Select the matched pair in the sidebar and the pick-and-place diff replaces the canvas; ",[239,272,273],{},"Text Diff"," still shows the raw file text.",[228,276,278],{"id":277},"side-units-and-columns","Side, units and columns",[212,280,281],{},"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.",[212,283,284,285,288],{},"Use ",[239,286,287],{},"Columns"," on either side to change the side, the X\u002FY 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.",[228,290,292],{"id":291},"how-parts-are-matched","How parts are matched",[212,294,295],{},"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.",[212,297,298],{},"For each matched part Gerbtrace compares:",[233,300,301,307,313,319,339],{},[236,302,303,306],{},[239,304,305],{},"Side"," – top or bottom.",[236,308,309,312],{},[239,310,311],{},"Position"," – a move counts when the part moved at least the move tolerance (default 0.05 mm).",[236,314,315,318],{},[239,316,317],{},"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.",[236,320,321,219,324,327,328,331,332,335,336,252],{},[239,322,323],{},"Value",[239,325,326],{},"package"," and ",[239,329,330],{},"description"," – only when both files have the column. Case and spacing in package and description are formatting; in a value, case counts (",[216,333,334],{},"1m"," is not ",[216,337,338],{},"1M",[236,340,341,344,345,348],{},[239,342,343],{},"Other columns"," both files have, except row numbers and extra coordinate columns such as ",[216,346,347],{},"Pad X",".",[212,350,351],{},"Change the tolerances in the toolbar; Gerbtrace remembers them in this browser.",[228,353,355],{"id":354},"origin-changes","Origin changes",[212,357,358,359,362],{},"When most parts moved by the same distance, the CAD origin probably changed. Gerbtrace says so above the table. Turn on ",[239,360,361],{},"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.",[228,364,366],{"id":365},"bom-check","BOM check",[212,368,369],{},"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.",[228,371,373],{"id":372},"reading-the-result","Reading the result",[212,375,376,377,219,380,219,383,219,385,219,388,219,391,219,393,219,396,399,400,403,404,252],{},"The summary counts added, removed, changed and unchanged parts, and how many moved, rotated or changed side. Filter by change type (",[239,378,379],{},"Added",[239,381,382],{},"Removed",[239,384,305],{},[239,386,387],{},"Moved",[239,389,390],{},"Rotated",[239,392,323],{},[239,394,395],{},"Package",[239,397,398],{},"Description & other","), search by designator, value or package, or turn on ",[239,401,402],{},"Show unchanged",". The line column shows each part's row in the parsed files (",[216,405,406],{},"#3 → #4",[228,408,410],{"id":409},"export","Export",[212,412,284,413,415],{},[239,414,410],{}," to download:",[233,417,418,424],{},[236,419,420,423],{},[239,421,422],{},"Excel workbook (.xlsx)"," – a summary sheet (with the tolerances, any common shift and the BOM check) and the changed placements.",[236,425,426,348],{},[239,427,428],{},"Changed placements (.csv)",[212,430,431,432,435,436,348],{},"File names follow the ",[248,433,434],{"href":80},"export naming scheme",", for example ",[216,437,438],{},"Board_PnP-Revision-Diff.xlsx",[228,440,251],{"id":441},"replacing-the-project-file",[212,443,444,445,448],{},"In the SMD or THT tab, an editor can click ",[239,446,447],{},"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:",[233,450,451,454,457],{},[236,452,453],{},"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.",[236,455,456],{},"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.",[236,458,459,460,327,463,348],{},"The old file is not kept. The confirmation offers ",[239,461,462],{},"Download old revision",[239,464,465],{},"Export diff (.xlsx)",[212,467,468],{},"Nothing is stored by the compare itself: the diff exists only while it is open.",{"title":470,"searchDepth":471,"depth":472,"links":473},"",3,2,[474,475,476,477,478,479,480,481],{"id":230,"depth":472,"text":231},{"id":277,"depth":472,"text":278},{"id":291,"depth":472,"text":292},{"id":354,"depth":472,"text":355},{"id":365,"depth":472,"text":366},{"id":372,"depth":472,"text":373},{"id":409,"depth":472,"text":410},{"id":441,"depth":472,"text":251},"Compare two revisions of a pick-and-place file part by part, export the changes, and replace the project file.","md",null,{},true,{"title":99,"description":482},"Qc8vWdZZKjdBNE4LcEboGteLRJ21407EivmlkUY03XY",[490,492],{"title":95,"path":96,"stem":97,"description":491,"children":-1},"Compare two revisions of a customer BOM line by line and designator by designator, export the changes, and replace the project BOM.",{"title":108,"path":109,"stem":110,"description":493,"children":-1},"Configure team name, defaults, integrations (Elexess pricing, Spark AI), and panel defaults.",1794744947013]