Product Documentation
Virtuoso Layout Suite XL: Basic Editing User Guide
Product Version IC23.1, November 2023

Find/Replace Form

Use the Find/Replace form to search for and replace objects with specific attributes or property values.

Field Description

Search

This section enables you to specify the search criteria.

Search for

Sets the type of object to be searched, such as a label or pin.

Add Criteria

Adds a line of fields to the form that lets you make your search more specific.

  • Attribute list: Indicates the specific attributes, instance, library, view name, or properties for the selected object type. The list values change to reflect the attributes of the type of object you select in the Search for field.
  • Condition/logic list: Searches for character strings or numerals that are an exact match (==) or not a match (!=), to get matches that contain a string, a leading and/or trailing asterisk must be used. The symbols <, <=, >, >= are used where applicable. EXIST and !EXIST locate or exclude discrete blocks of information anywhere in the string.
  • Value list or text field: Sets the value of the attribute or property to use in the search. In the text field, you can specify the search string using the wildcard characters.

If a layer is selected in the attribute list and the Use Layer Palette LPPs Only option is selected in the Layout Editor Options form, only valid layers displayed in the Layers assistant are populated in the value list. You can search for a specific layer-purpose pair using the search filter.

The search feature does not accept ranges in the Add Criteria fields. For example, if you enter two path widths, you get the error message, “No figures found that meet the current search criteria.”

Delete

Deletes the corresponding line of criteria from the form.

Match all of the above

Displays objects that meet all the search criteria specified in the Add Criteria box.

Match any of the above

Displays objects that meet any of the search criteria specified in the Add Criteria box.

Case Sensitive

Makes the search case sensitive.

Search Hierarchy Range

Sets the levels of hierarchy to be considered for the search.

  • current cellView: Searches in the current edit cellview in the layout window. This is the default option.
  • current to bottom: Searches from the current edit cellview level to the bottom of the hierarchy.
  • current to stop level: Searches from the current edit cellview level to the stop level specified in the Display Levels Stop field in the Display Options form.
  • current to user level: Searches from the current edit cellview level to the level that you specify.

Region

Specifies the area of the cellview that needs to be searched.

  • Entire CellView: Searches the entire cellview. This is the default option.
  • Viewing Area: Searches the portion of the cellview that is displayed in the canvas at that instant.
  • Draw a Rectangle Region on the Canvas or Draw a Polygon Region on the Canvas: Enables you to specify a rectangular or polygonal area for the search. Select the required option, and then click in the canvas to specify the vertices of the rectangle or polygon.

Search

Specifies the scope of object search. This option is available only when the viewing area or the rectangle or polygon area is selected as Region.

  • Enclosed Figures: Searches the objects completely enclosed by the viewing area or the rectangle or polygon area.
  • Enclosed and Crossed Figures: Searches the objects completely or partially enclosed by the viewing area or the rectangle or polygon area.

Replace

This section enables you to specify the values with which search results need to be replaced.

The Replace section is available only in Layout XL and higher tiers.

Replace

Enables you to replace an object’s search results with a new object, attribute value, or property value. In the replace box, the list contains frequently used properties. In the text field, you can specify the value of the property with which you want to replace the original value. The value specified replaces the property values of all the objects matching the search criteria. For example, to replace parameter values for a parameterized cell, set Replace to property and type the parameter name.

Add Criteria

Adds a line of fields to the form that lets you make the replace operation more specific.

For more information, see Object Search Criteria.

Search Results

This section enables you to specify how the search results are displayed.

Zoom To Figure

Centers the cellview around the current object in the search group when you click Find, Previous, or Next.

Current Figure

Enables you to specify the number of the objects in the search group that you want to highlight as you click Previous or Next. The value in this field is the range of the current figures found in the search group. Press Tab after you specify the figure number to highlight the figure.

Figure Count

Displays the number of objects found, after you click Find. When a current-to-bottom search is done, the figure count returns the total number of figures found. In this case, the Current Figure field returns the figures with unique database IDs (dbIds).

Add Select

Selects the current object in the search group.

Deselect

Deselects the current object in the search group.

Replace

Edits or replaces the current object with the settings shown in the Replace section.

Previous

Highlights the previous object in the search group.

Next

Highlights the next object in the search group.

Reports

This section enables you to save the report for find and replace operations to a specified file.

Show Detailed Report in CIW

Displays a detailed report for find and replace operations in the CIW.

Environment variable: showFindReplaceReport

Save Report To

Saves the report of the find and replace operations to a specified file. The default file is “vlsSearchReport.csv.

Environment variable: saveFindReplaceReportToFile, findReplaceReportFileName

Browse

Lets you specify the path where you want to save the report of the find and replace operation.

You can use the following buttons in the Find/Replace form to perform the find and replace operations.

Button Description

Find

Searches for objects matching the settings in the Find/Replace form.

Select All

Selects all objects found by Find/Replace.

Deselect All

Deselects all objects found by Find/Replace.

Replace All

Replaces all objects found by Find/Replace with the settings shown in the Replace section.

Related Topics

Calculating Area and Density

Object Search Criteria


Return to top
 ⠀
X