Working with Unions
Parent page: PCB Placement & Editing Techniques
A union is a collection of objects that have been grouped together. When grouped as a union, they can be moved, modified or deleted as a single object. For example, any set of objects can be selected and a union created from them using the Tools » Convert » Create Union from Selected Objects, or the right-click Union sub-menu. Or if you place via stitching on the board, the software is able to recognize the stitching vias as a single object because it has automatically created a union for them.
Managing Unions
The Unions mode of the PCB panel allows you to access a hierarchical view of union types, unions, and union primitives for easy reference. The unions and the primitives contained within can also be edited from this mode of the panel.
Set the PCB panel mode to Unions, then use it to locate, examine and rename a Union.
In the PCB panel’s Union mode, its three main regions change to reflect the following (in order from the top):
- All the Union Types (user-defined union, layer stack table, etc.,) in the PCB document.
- Specific Unions within the selected union type from the above section.
- Union Primitive(s) that make up a selected union.
When the Unions mode of the PCB panel is selected, the panel lists all unions detected in the PCB editor design space. The following types of unions will be listed when present:
| Union Type | Behaviors |
|---|---|
| Drill Table | Click and drag to move; click to select and display resize handles; double-click to open the Properties panel; right-click on the union name in the panel to rename it. |
| Length Tuning Object (Accordion, Trombone, Sawtooth) | Click to select; click and drag on edge/vertex to reshape; double-click to open the Properties panel; right-click on the union name in the panel to rename it. |
| Layer Stack Table | Click and drag to move; click to select and display resize handles; double-click to open the Properties panel; right-click on the union name in the panel to rename it. |
| Rectangle | Click and drag to move; click to select and display resize handles; double-click to open the Properties panel; right-click on the union name in the panel to rename it. |
| Smart Paste (Pasted OLE Object) | Click and drag to move; click to select and display resize handles; double-click to open the Properties panel; right-click on the union name in the panel to rename it. |
| User-defined Union | Right-click on any object in the union then choose Unions » Select All In Union. Use standard selection behavior for copying, deleting, moving, rotating, etc. Note that standard left-click will select the object under the cursor, not the union. Right-click on the union name in the panel to rename it. |
| Via Shielding | Click to select; double-click to open the Add Shielding to Net dialog; right-click on the union name in the panel to rename it. |
| Via Stitching | Click to select; click and drag on edge/vertex to reshape; click and drag to move; double-click to open the Add Stitching to Net dialog; right-click on the union name in the panel to rename it. |
Union Types
The top region of the panel displays all the Union Types (User-defined Union, Layer Stack Table, etc.,) in the PCB document.
The following right-click menu commands are available in this region of the panel (as well as the other two regions):
- Select All – use this command to select all entries in the panel region.
- Clear Filter – use this command to remove all filtering from the design space.
Unions
The middle region of the panel displays the individual unions within the selected Union Type.
In addition to the commands available in the Union Types region of the panel, the following right-click menu commands are available in this region of the panel:
- Break objects from Union – click to open the Confirm Break Objects Union dialog to remove selected objects from the specified union.
- Select All In Union – click to select all primitives from the union in the design space.
- Deselect All In Union – click to deselect all selected primitives from the union in the design space.
- Resize Union – click to manually resize the selected union. After running the command, the pointer becomes a crosshair with which you can select objects to add to the Union.
- Explode Length Tuning To Free Primitives – click to break the chosen length tuning accordion union into the track and arc segments from which it is constructed.
- Delete Selected Unions – click to delete the selected union from the panel.
- Rename – click to open the Rename Union dialog to manually enter a new name for the union.
Right-click in the region then use the Columns sub-menu to add the following column:
-
Ignore Dead Copper – click to enable the Ignore Dead Copper option for the selected union. When this option is enabled, the union objects with no net assigned will not be reported as dead copper during DRC if the Report Dead Copper larger than option is enabled in the Design Rule Checker dialog.
Union Primitives
The bottom region of the panel displays all the primitives contained within the Union selected in the panel.
In addition to the commands available in the Union Types region of the panel, the following right-click menu commands are available:
- Zoom Selected – use to zoom in on and filter a selected primitive(s) in the design space.
- Properties – click to open the Properties panel mode for the selected primitive, such as the Track mode. The Properties panel can also be accessed by double-clicking on a primitive.
Union Language Keywords
The following two query language keywords are available for working with Unions:
InUnion(<Union Index>)- each union is assigned a numeric Index, use this to identify the target union. A list of indices will appear as you type in a number.InNamedUnion(<Union Name>)- each union has a system-assigned name, such as Union 1, use this or the user-defined name to identify the target union. For example,InNamedUnion('Logo-Altium'), as shown in the image below.
Targeting a union by the user-defined name