Product Documentation
Voltus-Fi Custom Power Integrity Solution L User Guide
Product Version IC23.1, August 2023

11


Viewing Results in vsaplot or vfiplot

Overview

The vsaplot/vfiplot utility is used to view the results of the IR drop and EM analysis that is performed in Voltus-Fi, Voltus-Fi-L (VFI-L) and Voltus-Fi-XL (VFI-XL), respectively.

The functionality offered by vsaplot and vfiplot is essentially the same, with the following key differences:

The vsaplot utility has its own display area, menus, and windows that provide options for customizing the display of IR drop and EM violations in the main display area of the tool.

The key benefits of viewing the results of IR drop and EM analysis in vsaplot are as follows:

  1. No dependency on the Virtuoso layout: vsaplot lets you view the results of the analyses in its own display area, which means, you do not need the Virtuoso layout for displaying the plots.
  2. Faster display: In vsaplot, the results are loaded and displayed quickly and when you change your selections, the plots are updated quickly. This performance enhancement is seen because vsaplot is independent of Virtuoso. Therefore, the time that would otherwise be spent in calling the Virtuoso APIs to display the results on the Virtuoso layout is saved.

Launching vsaplot

Launching the vsaplot involves the following steps:

Generating the VSA_RESULTS Database in Voltus-Fi

Before launching the vsaplot, you need to generate the vsaplot database or the VSA_RESULTS directory. This can be done both from the Voltus-Fi GUI and batch mode. Both methods are detailed below.

Generating the VSA_RESULTS Database in the GUI Mode

Generating the VSA_RESULTS Database in the Batch Mode

This section provides details of the commands used to generate the vsaplot db directory or the VSA_RESULTS directory. This directory is then used to run the vsaplot.

To generate the VSA_RESULTS directory, run the following command:

vfibatch -cmd <cmd_file_name>

where the <cmd_file_name> contains the name of the file with various commands.

No environment variable is required for generating the VSA_RESULTS directory when running in the batch mode.

The following commands are used to generate the VSA_RESULTS directory for IR drop and EM analysis in vsaplot for both Voltus-Fi-L and Voltus-Fi-XL. However, there are some parameters that are specific to either Voltus-Fi-L or Voltus-Fi-XL. The distinction is provided in the parameter descriptions.

Specifying the Order of Layers in vsaplot

By default, the layer order used for viewing results in vsaplot is the same as that in the PGDB Layermap file. However, you can specify the order of layers for viewing in vsaplot by specifying the layer order in a file, control_layer file. In this file, the layer name and order is specified in the following format:

layerName <Layerorder>

For layers that are not to be displayed, use the following format in the file:

layerName ~

After generating the control_layer file, specify the following environment variables before launching vsaplot.

For details, see VSAPLOT_USE_DEFAULT_LAYER_ORDER and VSAPLOT_EXTERNAL_LAYER_ORDER_FILE_PATH in the “Environment Variables” chapter.

The software will follow the following order of priority while searching for the control_layer file:

If the control_layer file is provided by the user in one run, the tool saves the layer order and will use the file for the subsequent vsaplot/vfiplot runs.

Launching vsaplot

You can launch vsaplot in two ways, from the Voltus-Fi console menu, or directly from the UNIX, shell, or xterm window.

While vsaplot can be enabled by checking out either the VFI-L or the VFI-XL license, vfiplot requires a VFI-XL License checkout.

Launching vsaplot from the Shell

You can open vsaplot directly from the UNIX, shell, or xterm window as follows:

vsaplot <VSA_Results_DB>

or

vfiplot <VSA_Results_DB>

Where:

<VSA_Results_DB> is the path of the result directory in which the results of the IR drop or EM analysis are saved.

You can also run vsaplot/vfiplot by typing just vsaplot or vfiplot in the shell without specifying the results directory. You can then click the File menu and Open submenu in the vsaplot window to specify the results directory. This is detailed in the File Menu section.

Launching vsaplot from the GUI

You can launch the vsaplot from the IR/EM Analysis menu in the Voltus-Fi console in the following ways:

  1. Click the Connect To vsaplot submenu of the IR/EM analysis menu. When you click this option, the Connect pop-up window opens. Provide the name of the MW Server Port and click Connect. This is shown in the images below.
    For vfiplot, the submenu name is Connect to vfiplot.
    Figure 11-1 Launching vsaplot from IR/EM Analysis – Connect To vsaplot/vfiplot Menu
    Figure 11-2 Opening the Connect Pop-Up Window
  2. Click Open vsaplot submenu of the IR/EM Analysis menu. When you click this option, the vsaplot window opens.
    For vfiplot, the submenu name is Open vfiplot.
    Figure 11-3 Launching vsaplot from IR/EM Analysis – Open vsaplot/vfiplot Menu

Viewing Results in vsaplot

When you launch vsaplot either from the GUI or in the batch mode, the vsaplot window opens. Before detailing the options available for viewing and customizing results in vsaplot, let us first look at the main menus, submenus, and components of vsaplot.

The following topics are covered in this section:

The main window of the vsaplot is shown in the figure below.

Figure 11-4 The vsaplot Window

Main Menus of vsaplot

The following main menus are available in vsaplot.

File Menu

The File menu has the following submenus:

These submenus are detailed below.

View Menu

The View menu has the following submenus:

The RelativeR menu is only available for vfiplot. It is not available in vsaplot.

These options are detailed below.

Options Menu

When you click the Options menu, the Options form shown below opens. You can use this form to specify whether you want to view the analysis results in the pR-View (presistor view) or the Node-View (node view).

The Options menu is available only if your results directory has both IR drop and EM analysis results. If the results directory has only IR drop analysis results, the Options menu is not available in the main menu of vsaplot because the IR drop violations only have a node view.

Figure 11-11 The Options Form

By default, the Results window displays results in the node view.

When you change your view selection, the Results window is updated accordingly. The updated “Name” column in the Results window for both views is shown below.

Figure 11-12 Viewing Results in Presistor View and Node View

Toolbar Widgets

The following row of widgets, located below the menus and above the design display area, includes shortcuts for the menu options detailed in the above section.

The descriptions of the widgets are provided in the table below.

Table 11-1 Toolbar Widgets of vsaplot

Widget

Description

Open – opens the result directory.

zoomIn – zooms into the design in the display area.

zoomOut – zooms out of the design in the display area.

zoomFit – fits the entire design within the design display area.

Search Maximum Value – zooms into and highlights the worst violation in the selected area of the design in the display area.

Enables region-to-region mapping.

This widget is enabled only if a particular net is specified in the Net(s): field. It is disabled if ALL nets are selected.

Partial/Full Results – updates the Results window to show partial or full results. In partial view, only the Pass/Fail, Layer, and J/Jmax columns are displayed. In full view, all the columns are displayed. This is shown in Figure 11-20.

By default, the Results window opens in partial view.

Open/Close Results – toggles the Results window.

Click to reset results markings – clears the markers in the display area.

Auto Zoom – click to select a node or a presistor in the Results window. The display area will zoom into the selected presistor or node as shown below.

Shows markers on screen – shows the markers for the selected layers in the display area.

Opens the Main Window pop-up window that lets you launch a sub-window and synchronize connected windows.

Opens the Connect pop-up window that lets you provide the IP address and the port number for the window you want to connect to the current window.

Opens the Settings pop-up window that lets you specify whether you want to synchronize zoom, or probe, or both for connected windows.

Main Components of vsaplot

In addition to the menus and widgets provided in the vsaplot, the main window of vsaplot includes a display area and the following sub-windows that are used to customize the display of violations.

The main window of the tool highlighting the sub-windows is shown below.

Figure 11-13 Main Components of vsaplot

You can dock any sub-window to the side, top, or bottom of the display area. Click the dock/undock handle (highlighted in red in image above) and drag it to the desired location.

The sub-windows are described in detail below.

Selecting the Layers

The Select Layers window is shown below.

Figure 11-14 Select Layers

In the Select Layers window:

Specifying the Slider Range

In this window, a slider is provided to let you customize the violation range you want to view using a continuous RGB gradient. The vast range of color options provided by the RGB gradient makes it easier to view a specific range of violations. The ruler range of violation values for all or selected layers is provided next to the color spectrum as shown below.

Figure 11-15 The Slider Range

Min and Max slider buttons (the blue and red button, respectively) are provided for customizing the ruler range for viewing the violations that fall within the specified range. You can move the Min Max slider buttons up and down to update the ruler ranges according to the new slider button positions.

When the slider buttons are used to specify the ruler range for violations, the selection is updated in the Customize Range fields in the Set Range sub-window. The violations above and below the slider marks are displayed in “deep red” and “deep blue”, respectively.

Select Display Out of Range to view the violations with values outside the specified range.

Specifying the Violation Range

In the Set Range sub-window, you can specify the violation range you want to view.

The figure below shows the IR drop violations for the selected layers within the specified slider range.

Figure 11-16 Customizing the Slider Range for Viewing IR Drop Violations for Selected Layers

Selecting the Type of Analysis and Plots

In this window, you can select the type of analysis and the type of plot for which you want to view violations. The following three cyclic fields are available in this window, as shown below:

The analysis types available in the Analysis: cyclic field depends upon the selection of analysis types on the EM tab of the IR/EM form in the GUI mode while loading results or those specified using the -type parameter of the write_em_vsaplot_db command in the batch mode. When all analysis types are selected on the EM tab, the following types are displayed in the Analysis: field of the Selection window.

Figure 11-18 The Analysis Types in the Selection Window

The following types of plots are available for the above analysis in the Plots cyclic field:

The results for Current Density ratio violations based on the average current for selected layers is shown in the figure below. The range of violations is customized using the slider.

Figure 11-19 Viewing Current Density Violations for the Average Current for Selected Layers

Viewing the Results

The Results window displays the results of the IR drop or EM analysis. By default, the Results window opens in partial view, in which only the layer name, net name, and plot type columns are visible. You can click the Partial/Full Results widget to display the full results, which includes all the columns shown in the figure below.

Figure 11-20 The Results Window Displaying Full Results in pR-View

You can save your markings in the Results window. Select the check box against the node or resistor for which you have viewed the violation. When you open the vsaplot the next time, your markings will be visible in the Results window. This feature helps you save time by identifying violations that have already been viewed.

Querying IR Drop and EM Results

The following layout query features are supported:

Zooming into the Worst Violation in the Selected Area

You can select an area on the layout and zoom into the worst violation in the selected area by using the searchMax submenu in the View menu, or by clicking the corresponding toolbar widget.

The display area zooms into the worst violation in the selected area. The location of the maximum violation (x and y coordinates) is displayed in the bar at the bottom of the vsaplot window as shown below.

Figure 11-21 Zooming into the Worst Violation in the Selected Area

Retrieving the Values of All the Violations at a Specified Point on the Layout

You can click anywhere on the design in the display area and retrieve the values of all the violations at that point. The results are displayed in the Selected Results section of the Results window. This section is only visible when you click anywhere on the design in the display area. The vsaplot window displays the violations at that point and the worst violation value is marked by an arrow on the ruler range as shown below.

Figure 11-22 Retrieving the Values of the Violations at a Specified Point

Displaying the Colormap for Point-to-Point and Region-to-Region Selection

The vsaplot or vfiplot utility supports the display of the colormap between two points or the regions selected on the layout. For this, the Region2Region submenu of the View menu is provided with four options; Point, Rectangle, Ellipse, and Clear. The Clear option is used to clear the selection.

Select Point to specify two points on the layout, or specify Rectangle or Ellipse to specify regions as rectangular shapes or ellipses in the display area, respectively. The tool resets the violation range, displaying colors from blue to red, between the two specified points or regions. Rectangular regions are specified in the figure below.

You can also enable the region-to-region mapping using the toolbar widget.

Figure 11-23 Displaying Region-to-Region Selection – Rectangular Shapes

To clear the point or region selection, click the Clear option in the View - Region2Region submenu or click the Esc button. The rectangles or ellipses will be cleared.

Click Reset in the Set Range group box to clear the colormap display between the selected points or regions.

Calculating Relative Resistance Values between the Nodes on a Net in vfiplot

This feature is only available for vfiplot. The vfiplot utility supports the calculation of relative resistance between two specified points or nodes on the specified net and plots a colormap for these in the display area. This feature uses the colormap feature of vfiplot for point-to-point and region-to-region selection to specify the points for which relative resistance is to be calculated and plotted.

For pairs of selected nodes, the software calculates the relative resistance value between the selected nodes and displays the colormap with colors ranging from blue to red, between the two nodes.

For pairs of selected regions, the software uses the lowest voltage value from the high voltage region and the highest voltage value for the low voltage region to calculate the relative resistance between the specified regions.

This feature is only enabled when the following are specified:

The flow, including the requirements and the reports generated for relative resistance calculations, is documented in detail in subsequent sections.

Requirements for Running the Relative-R Flow

To run the relative resistance (Relative-R) flow, ensure the settings for Voltus-Fi-L that are listed below.

The vfiplot option will check out the VFI-XL license and allow you to use the Relative-R or the R Map feature. If the license is not available, it will error out.

Running the Relative-R Flow

Follow these steps to run the relative resistance flow in vfiplot.

  1. In the Selection group box, as shown below:
    1. Select the net on which you want to perform the relative resistance analysis.
    2. Select R as the plot type.
      Figure 11-24 Selecting the Net and Plot Type for the Relative-R Flow
  2. The RelativeR submenu is enabled as shown below.
  3. In the View menu, click RelativeR. The Select DSPF File for Relative-R pop-up window opens. The VSA_RESULTS directory opens by default.
  4. Select the DSPF file that you want to use. This file will get copied to the basic.dspf file, which is present in the VSA_RESULTS directory.
    Figure 11-25 Selecting the DSPF File
  5. Click Open. The Relative-R form opens.
    Figure 11-26 The Relative-R Form
    The above form displays the relative resistance results for the pairs of selected nodes. the steps are detailed below.
  6. Click Select Region to specify how you want to select the region. You can choose from the Point, Rectangle, and Ellipse options.
  7. Click Input Region to select the region in the display area. When two points, rectangles, or ellipses are selected in the Display region, the table in the Relative-R form is populated with the information for the two points or nodes, including their x- and -y coordinates, node names, and layer names as shown below.
    Figure 11-27 The Relative-R form – Displaying Information for Selected Pairs of Nodes
    You can select multiple pairs of nodes in the display area by using the Input Region button. These pairs will be listed in the Relative-R form.
  8. In the Relative-R form, click any row and then click Calculate R to calculate the relative resistance between the pair of specified nodes in the form. The software uses the static power grid solver (SPGS) feature of Spectre to calculate the value of the resistance and populates the “R” column in the table of the Relative-R form as shown below.
    Figure 11-28 The Relative-R form – Calculating Relative-R between Specified Pairs of Nodes
  9. Click Save to save the information filled out in the Relative-R form in a file. You can load this file in subsequent runs to populate the Relative-R form. The Save SPGS Report window opens as shown below.
    Figure 11-29 The Save SPGS Report Window
    Specify a name for the file. By default, the file is saved in your working directory (VSAPLOT_SPGS_FILES). A sample file is shown below.
    Figure 11-30 A Sample File with the Relative-R Information
  10. Click Load to load an already saved configuration file in the form. All pairs of nodes listed in the file are added to the table in the Relative-R form.
  11. Click Generate Pin total Report to generate the total resistance report for all pins. This feature is described in detail in the section below.

Calculating the Total Resistance for All Pins

The vfiplot utility lets you calculate the total resistance for all the pins in your design. For every pin, resistance is calculated for all the wires on every layer of the pin, and the percentage of the resistance on each layer of the pin as compared to the total resistance on the pin.

This feature is useful because it lets you view the resistance for every layer of the pin and the percentage resistance for each layer so that you can identify the layers contributing the highest resistance percentage in the pin.

The total pin report includes the following information:

Pin: <name of pin>
/* ------------------------------------------------------- */
/*   Wire & Via Name  |    Resistance    |   Percentage      
/* ------------------------------------------------------- */

where,

The Wire & Via Name column lists the names of all layers of the pin

The Resistance column lists the resistance values of all wires of each layer, and

The Percentage column lists the percentage resistance – the resistance on each layer as a percentage of the total resistance on the pin – on each layer

The following set of equations show how the resistances are calculated:

Step 1: Calculating the total resistance on the pin

where,

Ptotal is the total wire power – the summation of power dissipated on all parasitic resistors belonging to the pin – drawn by the pin

Itotal is the total current drawn from the pin, and

Rtotal is the total wire resistance on the pin

Step 2: Calculating the resistance on a particular layer, say M1:

where,

PM1 is the summation of power dissipated on all parasitic resistors belonging to the pin lying on layer M1

RM1 is the total wire resistance on layer M1

A sample report is shown below.

Example 11-1 A Sample Pin Report

Pin Total Report:
Pin: gnd!
/* ------------------------------------------------------- */
/*   Wire & Via Name  |    Resistance    |   Percentage      
/* ------------------------------------------------------- */
                   mt1        7.66013e-05         6.02065
                   mt3                  0               0
                  poly                  0               0
                   mt2        0.000676434         53.1658
                  Via1        0.000519275         40.8135
                  Via2                  0               0
/* ------------------------------------------------------- */
                 Total         0.00127231             100
/* ------------------------------------------------------- */
Pin: ibias
/* ------------------------------------------------------- */
/*   Wire & Via Name  |    Resistance    |   Percentage      
/* ------------------------------------------------------- */
                   mt1        9.94715e-05         35.4389
                   mt3                  0               0
                  poly        4.07399e-10     0.000145145
                   mt2        0.000101207         36.0572
                  Via1        8.00056e-05         28.5037
                  Via2                  0               0
/* ------------------------------------------------------- */
                 Total        0.000280685             100
/* ------------------------------------------------------- */

Synchronizing Multiple vsaplot Windows

The vsaplot/vfiplot utility supports the synchronism function, which involves opening multiple windows and synchronizing them using the menu options provided in the GUI. Three main synchronism functions are provided through the Open submenu of the File menu. These are the following:

The above functions can also be performed using the toolbar widgets. For details, see Toolbar Widgets.

The synchronism function is detailed in the following sections:

Opening a Sub-Window to Initiate Synchronism

To initiate synchronism and start the comparison, follow any of these methods:

Synchronizing Options

Once the windows are open for comparison, you can select the options for synchronism depending upon your requirements. The following options are available:

Synchronizing vsaplot with the Layout or Extracted View

In addition to synchronizing multiple vsaplot windows, you can synchronize a vsaplot window with the Virtuoso layout/extracted cellview window. Once they are synchronized, the actions of zooming or scrolling in the vsaplot window are replicated in the Virtuoso layout/extracted cellview window. This helps you map problematic areas seen in the vsaplot to those in the Virtuoso layout/extracted cellview window correctly.

To synchronize the vsaplot window with the layout/extracted view, follow these steps:


Return to top
 ⠀
X