Altera SDC and TimeQuest API - Manual (Page 80)

2–70 Chapter 2: SDC and TimeQuest API Package and Commands
sta
SDC and TimeQuest API Reference Manual © December 2009 Altera Corporation
create_report_histogram
Usage
create_report_histogram [-color_div <color_div>] [-color_list <color_list>] [-max_data
<max_data>] [-min_data <min_data>] [-num_bins <num_bins>] [-panel_name <panel_name>]
[-x_label <x_label>] [-x_unit <x_unit>] [-y_label <y_label>] <data>
Options
-color_div <color_div>: Color divisions for the created histogram
-color_list <color_list>: List of colors for painting the created histogram
-max_data <max_data>: Maximum data value of the created histogram
-min_data <min_data>: Minimum data value of the created histogram
-num_bins <num_bins>: Number of bins
-panel_name <panel_name>: Path and name of the histogram
-x_label <x_label>: Text label on x-axis
-x_unit <x_unit>: Unit to be displayed on x-axis
-y_label <y_label>: Text label on y-axis
<data>: List of data to be analyzed
Description
Create a user defined histogram.
Use <data> to specify the data entries to be displayed on the histogram. It can be a tcl list of either one of
the following two formats or a mix of the two: {time_integer} or {time_integer number_count}, where
time_integer is an integer possibly with a unit representing time (default unit is second), and
number_count is a positive integer specifying number of entries (y value) of the corresponding
time_integer.
Use -num_bins to specify the number of bins, or the number of bars to be displayed on the histogram.
Use -color_div and -color_list to specify the color of each bin. -color_div takes a tcl list of time_integers (see
<data> above). Each entry in the list specifies the upper bound of each color division and therefore is
forced to be a boundary of bins. -color_list takes a tcl list of colors. Each color in the list is used in the order
specified and if less color is given than color divisions, the list will be re-used. For example, if specified
"-color_div {-1 0 1} -color_list {red green}", then bins below -1 will be red, bins between -1 and 0 will be
green, bins between 0 and 1 will be red again, and bins larger than 1 will be blue again. Posssible choices of
colors: black, blue, brown, green, grey, light_grey, orange, purple, red, white. Default -color_div is {0} and
default -color_list is {red blue}.
Use -max_data to specify the upper bound, i.e. largest number to be included in the histogram.
Use -min_data to specify the lower bound, i.e. smallest number to be included in the histogram.
Use -panel_name to specify the path and panel name of the created histogram. e.g. "-panel_name {Folder
1||Histogram 1} will create a histogram named "Histogram 1" and put it in a folder with the name "Folder
1".
Use -x_label to specify the text label on x_axis.
Use -y_label to specify the text label on y_axis.
Use -x_unit to specify a text unit to be attached to x_axis.