Altium NEXUS Documentation

Merge

Modified by Jason Howie on Apr 11, 2017

Parent page: PCB Commands

The following pre-packaged resources, derived from this base command, are available:


Applied Parameters: MergeActionIndex=n|Mode=RightClick (where n is in the range 0 to 20)

Summary

This command is used to perform the indicated merge operation, within the current cell containing one or more detected differences, when using Altium NEXUS's Collaborative PCB Design functionality.

After performing a comparison - from the Collaborate, Compare and Merge panel - between your own local document and another revision of that document under version control - typically the HEAD revision - any detected differences are presented in a Difference Map in the panel, and through use of a Differences Overlay in the main design workspace. To manage the display of differences the board is temporarily divided up into cells. The cell reference is displayed when you hover the cursor over the cell in the Difference Map in the panel, and is also displayed in a corner of the cell in the main design window. When multiple people are working on the same document, and changes by others have been made, the panel will show that a merge is required. By showing the merge resolution view, a variety of merge-based commands will be available, where applicable, to merge in differences detected in the reference document, into the current board. If a cell includes some changes that you want to keep and others that you want to bring in, then you can selectively merge the changes in the main PCB editor, using the merge action commands described here.

Access

These indexed commands are accessed from the PCB Editor by right-clicking within the current differences cell in the workspace, and selecting the required merge action from the Merge sub-menu.

The commands are only available provided a comparison has been initiated through the Collaborate, Compare and Merge panel, and differences have been detected that require merge actions. A richer set of available commands will be available when opting to show the merge resolution view.

Use

To resolve differences in the main workspace, right-click on an object that is flagged as a difference. The popup context menu will include a Merge submenu, offering merge actions tailored to the primitive that was clicked on.

There are 3 possible levels the commands in the Merge submenu can operate on:

  • Primitive - only the actual track segment/via/component that you right-clicked on will be modified by this action.
  • Route - for the connection you clicked on, all track segments that are different will be modified by this action.
  • Cell - all track segments passing through the cell that are part of this difference, are modified by this action.

The commands available in the right-click Merge sub-menu support the following types of actions:

  • Add - displayed when clicking on a primitive that exists in the reference document, but not in your document. Adds the primitives from the reference document into the current document, but does not remove primitives. When the Add Component action is performed, it will attempt to remove an existing component that would cause an UniqueID conflict.
  • Remove - modifies primitives so the changes made to the current document are removed.
  • Replace - adds and removes primitives so the end result matches the reference document used for comparison.

Tips

  1. Merging at a coarser level can also be performed directly from the Difference Map region of the Collaborate, Compare and Merge panel. Simply right-click on a modified cell to display the Add/Remove to match [ReferenceDocument] command. Selecting the command will modify the primitives in that cell to match the reference document. Note that the name of the reference document will be displayed in the square brackets. Multiple cells can be highlighted at the same time (Shift+click or drag+click to multi-select) allowing as many or as few changes from the reference to be brought across to the current board.


Applied Parameters: DeleteWIP=True

Summary

This command is used to delete an intended work area that you have previously created within the main design workspace. A work area is simply a polygonal object that is drawn around an area of the board you intend to work on, and provides a beneficial heads-up to other designers working on that same board using Altium NEXUS's Collaborative PCB Design functionality.

Access

This command is accessed from the PCB Editor by right-clicking within a placed work area object and choosing the Delete Work In Progress Region command from the context menu.

Use

After launching the command, the defined work area will be deleted from the workspace.

Tips

  1. The Collaborate, Compare and Merge panel provides the controls for displaying marked work regions on the Difference Map (within the panel), and in the main design workspace. It also provides a control to quickly delete all of your intended work areas.

 

Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

You are reporting an issue with the following selected text
and/or image within the active document:
ALTIUM DESIGNER FREE TRIAL
Altium Designer Free Trial
Let’s get started. First off, are you or your organization already using Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

In that case, why do you need an evaluation license?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You actually don’t need an evaluation license for that.

Click the button below to download the latest Altium Designer installer.

Download Altium Designer Installer

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Please fill out the form below to get a quote for a new seat of Altium Designer.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

If you are on Altium Subscription, you don’t need an evaluation license.

If you are not an active Altium Subscription member, please fill out the form below to get your free trial.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Why are you looking to evaluate Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

You came to the right place! Please fill out the form below to get your free trial started.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Great News!

Valid students can get their very own 6-month Altium Designer Student License for FREE! Just fill out the form below to request your Student License today.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

That’s great! Making things is awesome. We have the perfect program for you.

Upverter is a free community-driven platform designed specifically to meet the needs of makers like you.

Click here to give it a try!

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.