Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 9/26/2022
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

4.1.32.11. get_report_panel_row (::quartus::report)

The following table displays information for the get_report_panel_row Tcl command:

Tcl Package and Version

Belongs to ::quartus::report

Syntax get_report_panel_row [-h | -help] [-long_help] [-id <table_id> ] [-name <table_name> ] [-row <row> ] [-row_name <row_name> ]
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-id <table_id> Id of panel from which to get data
-name <table_name> Name of panel from which to get data
-row <row> Row (or Y) coordinate
-row_name <row_name> Row (or Y) name
Description
Reports data of the specified panel row.

Using the panel id and row index provides faster data access 
than using panel name and row name, respectively.

Panel ids and row indices that you have cached may become outdated
or invalid if the report gets unloaded or reloaded. This error
occurs after compilation or with calls to the "project_close",
"unload_report", and "load_report" commands.

Panel and row names support wildcards.

The table of content portion of the UI Compilation Report
window shows short panel names for better readability.
However, the panel name used by this command is the full
panel name as shown in the right-hand side frame of the
UI Compilation Report window or the .rpt file of the
corresponding command-line executable. For example, the
table of content shows the path "Analysis & Synthesis||Summary".
However, the corresponding full path used by this Tcl command
is "Analysis & Synthesis||Analysis & Synthesis Summary".
Example Usage
load_package report
project_open chiptrip
load_report

# Set panel name and id
set panel {Flow Settings}
set id    [get_report_panel_id $panel]
# Set row name
set rname {Revision Name}

# Get row {Revision Name} data (use panel id)
get_report_panel_row -row_name $rname -id $id
# Get row 2 data (use panel id)
get_report_panel_row -row 2 -id $id
# Get row 3 data (use panel name)
get_report_panel_row -row 3 -name $panel

## Get the last row data
set row_cnt     [get_number_of_rows -id $id]
set last_rindex [expr $row_cnt - 1]
get_report_panel_row -row $last_rindex -id $id

unload_report
project_close
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_OK 0 INFO: Report automatically reloaded because it was not up-to-date after use of Tcl command execute_flow or execute_module (which belong to ::quartus::flow package). No action is required.
TCL_ERROR 1 ERROR: Found conflicting row options. Specify either the -row or -row_name option.
TCL_ERROR 1 ERROR: Table is empty. Add rows to the table before accessing its data.
TCL_ERROR 1 ERROR: Illegal row name: <string>.
TCL_ERROR 1 ERROR: Illegal row number: <string>. Specify a legal row number from <string> to <string>.
TCL_ERROR 1 ERROR: No row option specified.
TCL_ERROR 1 ERROR: The option specified <string> , is unknown. Recheck the command options.
TCL_ERROR 1 ERROR: Can't access report panel. Use this command only for report panels with rows or columns.