Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 12/13/2021
Public

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

Document Table of Contents

3.1.26.13. load_report (::quartus::report)

The following table displays information for the load_report Tcl command:

Tcl Package and Version

Belongs to ::quartus::report

Syntax load_report [-h | -help] [-long_help] [-simulator]
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-simulator Option to load the Simulation Report. If this option isn't specified, the Compilation Report is loaded instead.
Description
By default, loads the Compilation Report for the current revision or
the specified revision name. If the -simulator option is
specified, loads the Simulation Report instead.

After the report is loaded or reloaded, the cached panel ids,
and row and column indices may become outdated or invalid. 
Intel recommends that you update them before using them.
Example Usage
# Load report package
load_package report
# Open chiptrip project
project_open chiptrip
# Load the current revision report
load_report

# Set panel name and id
set panel {Fitter||Fitter Summary}
set id    [get_report_panel_id $panel]

# Get total registers
set rname  {Total [Rr]egisters}
set rindex [get_report_panel_row_index -id $id $rname]
set rname  [get_report_panel_data -id $id -row $rindex -col 0]
set data   [get_report_panel_data -id $id -row $rindex -col 1]
puts "$rname: $data"

# Get total pins
set rname  {Total [Pp]ins}
set rindex [get_report_panel_row_index -id $id $rname]
set rname  [get_report_panel_data -id $id -row $rindex -col 0]
set data   [get_report_panel_data -id $id -row $rindex -col 1]
puts "$rname: $data"

# Unload the report
unload_report
# Close the project
project_close
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_ERROR 1 ERROR: Can't load report for revision: <string>. A different, active revision already exists: <string>. To specify another active revision name, type set_current_revision <string>.
TCL_ERROR 1 ERROR: Can't find active revision. Specify an active revision name using set_current_revision <string>.
TCL_ERROR 1 ERROR: Can't find active revision. Specify an active revision name using set_current_revision <revision name>.
TCL_ERROR 1 ERROR: Revision name does not exist: <string>. Run Analysis and Synthesis (quartus_map) with the specified revision name before using this Tcl command.
TCL_ERROR 1 ERROR: Compilation database is newer than the last call to create_timing_netlist. Use the delete_timing_netlist Tcl command before using <string>.
TCL_ERROR 1 ERROR: You must open a project before you can use this command.
TCL_ERROR 1 ERROR: Can't load report data for revision name: <string>. Make sure the report database exists for the specified revision name.
TCL_ERROR 1 ERROR: Existing report was not unloaded. Ensure that your load_report commands have matching unload_report commands.