Optional Arguments

You can specify as many options as needed and list them in any order.

ACTIVECOLORS=(color–1 color–2 ...color–n)

specifies the list of active colors for each qualitative range. This list is the colors that you want to use for each range when that range contains the actual KPI value. You do not have to specify a color for each range in the KPI chart. The default colors shown in GKPI Procedure Default Colors (or the colors specified by the COLORS= option) are used for each range for which active colors are not specified. The number of entries in the ACTIVECOLORS= list cannot exceed the number of ranges that are defined. That is, the maximum number of active colors is one less than the number of entries in the BOUNDS= list. Separate each color with either a blank space or a comma.

See:Controlling Qualitative Range Colors

Example:Using the Default Colors as the Active Colors

AFONT=(<F=“fontname”</BOLD></ITALIC>> <C=color> <H=text-height<units>>)

specifies the name, color, and text height for the font used for the actual KPI value label.

Style reference:Font attribute of the GraphLabelText element

See:Font Suboptions

Example:

AFONT=(f="Comic Sans MS" c=red h=15pt)

Example:Creating a Dial KPI Chart

AVALUE | NOAVALUE

specifies whether to display the actual KPI value label.

Alias:AVAL | NOAVAL

Default:AVALUE

Example:Creating a Traffic Light

BFONT=(<F=“fontname”</BOLD></ITALIC>> <C=color> <H=text-height<units>>)

specifies the name, color, and text height of the font used for the boundary and tick mark values. If you increase the size of the font to the point where labels would collide, then the intermediate labels are not displayed. The GKPI procedure displays only the lowest and highest boundary labels.

Style reference:Font attribute of the GraphValueText element

See:Font Suboptions

Example:

BFONT=(font="Arial" color=H14055FF height=.25in)

Example:Creating a Dial KPI Chart

BVALUE | NOBVALUE

specifies whether to display the boundary values.

Alias:BVAL | NOBVAL

Default:BVALUE

COLORS=(color–1 color–2 ...color–n)

specifies the list of inactive colors for each qualitative range. This list is the colors that you want to be used for each range when that range does not contain the actual KPI value. You must specify a color for each range in the KPI chart. That is, the number of entries in the COLORS= list must be one less than the number of entries in the BOUNDS= list. Separate each color with either a blank space or a comma.

For all KPI charts except traffic lights, if you define two to five ranges, the GKPI procedure applies a default set of colors ranging from red to green. If you define only one or more than five ranges, the default color for all ranges is gray.

For traffic lights, the default color for all ranges is gray. This option is ignored by the TRAFFICLIGHT statement if the ACTIVECOLORS= option is specified.

See:Controlling Qualitative Range Colors

Examples:Using the Default Colors as the Active Colors

Creating a Gray Scale Bullet Graph

Defining a Speedometer with Reversed Colors

Creating a Traffic Light

DESCRIPTION= “description”

specifies the description of the output. The maximum length for the description is 256 characters. The description does not appear on the graph. The default is “Key performance indicator”.

The descriptive text is shown in the “description” portion of each of the following:

• the Results window.
• the Table of Contents that is generated when you use the CONTENTS= option on an ODS HTML statement.
• the chart description for Web output. See Chart Descriptions for Web Presentations for more information.

Alias:DES=

FORMAT=“SAS-format”

specifies a SAS format for the boundary and actual values. The default format is BEST. For example, you can use format="percent8.0" to display values as percentages or format="datetime7." to display SAS datetime values in the format ddmmmyy.

See:SAS Formats Supported for Java

Examples:Creating a Dial KPI Chart

Defining a Speedometer

LABEL= “string”

specifies a label for the graphic. The label is displayed at the top of graph, beneath the title, if a title is specified.

Note:By default, labels are displayed at the top center of the graphics output area, and the KPI chart is displayed in the center of the output area. To reduce the space between labels and the KPI chart, reduce the size of the graphics output area by specifying the XPIXELS=/YPIXELS= or HSIZE=/VSIZE= options in the GOPTIONS statement. See The Graphics Output and Device Display Areas for more information.

Examples:Defining a Speedometer

Defining a Speedometer with Reversed Colors

Creating a Traffic Light

LFONT=(<F=“fontname”</BOLD></ITALIC>> <C=color> <H=text-height<units>> <J=LEFT | RIGHT | CENTER>)

specifies the name, color, and text height of the font to use for the label that is specified by the LABEL= option. You can also specify whether the label is left-justified, centered, or right-justified within the graphics output area.

Style reference:Font attribute of the GraphLabelText element

See:LABEL= “string” and Font Suboptions

Example:

LFONT=(f="Albany AMT/italic" c=cornflowerblue height=.25cm j=right)

Example:Defining a Speedometer

LINK=“url”

adds a drill-down link to the KPI chart. Enclose the URL in quotes.

LOWBOUNDARY | NOLOWBOUNDARY

specifies whether the KPI chart displays as if the KPI value falls in the lower range or the upper range when the actual KPI value falls directly on a range boundary. This option controls the color that is used for dial centers, traffic lights, and actual value indicators. It also controls which range is displayed in the active color, if an active color list is specified. The default is LOWBOUNDARY, which tells the GKPI procedure to use the color of the lower range. If you specify NOLOWBOUNDARY, then PROC GKPI uses the color of the higher range. LOWBOUND and NOLOWBOUND Effect on Indicator Colors illustrates the effect of this option on dial centers and on the actual KPI value indicator in a horizontal slider when both a range boundary and the actual KPI value is 30.

LOWBOUND and NOLOWBOUND Effect on Indicator Colors

Alias:LOWBOUND | NOLOWBOUND

Default:LOWBOUNDARY

Example:Creating a Dial KPI Chart

NAME=“name”

specifies the name of the graphics output file. The name can be up to 256 characters long, and uppercase characters are converted to lowercase. The default name is graph.png. If the name duplicates an existing name, then SAS/GRAPH adds a number to the name to create a unique name—for example, graph1.png.

See:About Filename Indexing

TARGET= data-value

specifies the numeric value of the target key performance indicator. If you specify a missing value (TARGET=.), then the GKPI procedure generates a KPI chart without a target value indicator.

Restriction:Not supported by the TRAFFICLIGHT statement

Examples:Creating a Gray Scale Bullet Graph

Creating a Dial KPI Chart

Defining a Speedometer

TYPE=FULL | HALF | QUARTER

specifies the size of the display for speedometers.

Default:FULL

Restriction:Valid for SPEEDOMETER statement only

See:Speedometer KPI Charts