• Skip to main content
  • Skip to search
  • Skip to footer
Cadence Home
  • This search text may be transcribed, used, stored, or accessed by our third-party service providers per our Cookie Policy and Privacy Policy.

  1. Blogs
  2. System, PCB, & Package Design
  3. BoardSurfers - Aerials and Bails: How to Rename Reference…
Monika
Monika

Community Member

Blog Activity
Options
  • Subscribe by email
  • More
  • Cancel
CDNS - RequestDemo

Try Cadence Software for your next design!

Free Trials
PCB Editor
Allegro PCB Editor

BoardSurfers - Aerials and Bails: How to Rename Reference Designators Using Batch Command

6 Aug 2019 • 2 minute read

BoardSurfers: Cadence Allegro BlogComponents on a board are often placed per their functional group and hence their reference designators are all jumbled up. It is a common practice to rename reference designators before sending out the design data to manufacturers. Reference designator renumbering is a process for renaming the reference designators on the board so that it is easier to locate components on the boards during assembly, test, and troubleshooting. 

There are several industry standards that represent reference designators in different formats, like IEC 60617, IEEE 200-1975, and ASME Y14.44-2008. Design houses may also use formats that do not comply with the standards. To ensure reference designators are accurate before generating manufacturing files, you can rename reference designators to a specific standard/format using a batch program reftxt, which is available with the Cadence® Allegro® layout editors. This batch command uses a text file that contains a list of reference designators in two columns. The first column shows the existing reference designators and the second column shows the new/renamed reference designators. The command renames any number and type of reference designators simultaneously and applies new ones with any number of characters.

Creating List of Existing Reference Designator

 To create a list of the existing reference designators, enter extract_ui command in the Command window of the layout editor.  In the Extract UI form, under the Data Fields tab, select Database View as Component. From the Available Fields section, select REFDES to move it to the right window. You can select REFDES_SORT instead if you want a sorted list of reference designators. Save the settings in text file refdes.txt and close the Extract UI form.

Extract UI

Creating List of New Reference Designators

 Open refdes.txt in an ASCII text editor or Excel. Copy the first column and paste it into a second column. Specify the new REFDES values in the second column and save the file as refdes_ch.txt.

was/is reference designator list

Running Batch Command

To run the reftxt command, open command prompt and change directory to the location where the input board design and a was/is list of reference designators are located. Use the following command syntax to run the command:

reftxt rename_file design_name [output_name]

An example is shown in the following figure:

reftxt batch command output

The output design file name is optional. If not specified, then the command uses the input design name to overwrite the changes. The reference designators will be renamed in the output board design as specified in refdes_ch.txt file and a reftxt.log file is created that contains errors, warnings, and successful reference designators names that were changed.


CDNS - RequestDemo

Have a question? Need more information?

Contact Us

© 2025 Cadence Design Systems, Inc. All Rights Reserved.

  • Terms of Use
  • Privacy
  • Cookie Policy
  • US Trademarks
  • Do Not Sell or Share My Personal Information