From 0157e773b5235adef3658272ef673a37d7526639 Mon Sep 17 00:00:00 2001 From: mikael-lovqvists-claude-agent Date: Fri, 27 Mar 2026 19:21:49 +0000 Subject: [PATCH] Update README with full workflow including trace/via replication Co-Authored-By: Claude Sonnet 4.6 --- README.md | 26 +++++++++++++++++++++----- 1 file changed, 21 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index c0a0c06..659dcd6 100644 --- a/README.md +++ b/README.md @@ -6,15 +6,31 @@ A KiCad PCB editor plugin that replicates component placement across hierarchica When a schematic uses multiple instances of the same hierarchical sheet (e.g. four identical amplifier channels), you can place and arrange one instance manually, then use this plugin to copy that exact layout to the other instances — preserving relative positions and rotations. -## How it works +## Workflow -1. Pick a **source sheet** (the fully placed reference layout) and a **target sheet** -2. Pick a **reference component** from the source sheet — this acts as the anchor point -3. The corresponding component in the target sheet defines where the copy should land and at what orientation -4. All other components in the target sheet are placed using a rigid body transform: rotated around the source reference position, then translated to the target reference position +### 1. Replicate component placement + +1. Open **Layout Replicator** from **Tools → External Plugins** +2. Pick a **source sheet** (the fully placed reference layout) and a **target sheet** +3. Pick a **reference component** from the source sheet — this acts as the anchor point +4. The corresponding component in the target sheet defines where the copy should land and at what orientation +5. Hit **Apply** — all other components in the target sheet are placed using a rigid body transform: rotated around the source reference position, then translated to the target reference position The reference component in the target sheet must already be placed — it defines the destination and orientation of the replicated layout. +Note: this only moves components. Traces and vias are not copied. + +### 2. Replicate traces and vias + +To bring the routing across as well: + +1. In the source layout, select all the traces and vias you want to replicate +2. Copy and paste the selection +3. In the properties of the pasted selection, clear the net assignment (set to no net) +4. Move the selection into position over the target components — traces will reconnect automatically, vias will remain unconnected +5. Select just the vias +6. Run **Assign Via Nets from Nearest Copper** — this assigns each via to the net of the closest copper item, reconnecting them + ## Installation Symlink the plugin directory into your KiCad scripting plugins folder: