Procedure Syntax

Requirements: An input Annotate data set is required.

Supports: Output Delivery System (ODS)

PROC GANNO ANNOTATE= Annotate-data-set

• <DATASYS >

• <DESCRIPTION= entry-description >

• <GOUT=< libref. > output-catalog >

• <IMAGEMAP= output-data-set >

• < NAME = entry-name variable-name >;

PROC GANNO Statement

Identifies the Annotate data set and draws the graphics output defined by that data set. Optionally, it scales the output to accommodate data-dependent coordinate values and specifies an output catalog.

Syntax

• PROC GANNO ANNOTATE= Annotate-data-set

  • <DATASYS>

  • <DESCRIPTION= entry-description >

  • <GOUT=< libref. > output-catalog >

  • <IMAGEMAP= output-data-set >

  • <NAME= entry-name variable-name >;

Required Arguments

ANNOTATE= Annotate-data-set

ANNO= Annotate-data-set

• specifies a data set that includes Annotate variables that identify graphics commands and parameters.

• See also: Chapter 24, Using Annotate Data Sets, on page 587

Options

Options in the GANNO statement affect all graphs produced by that statement. You can specify as many options as you want and list them in any order.

DATASYS

• indicates that absolute or relative data-dependent coordinates occur in the Annotate data set and scales the coordinates to fit the graphics output area. Use the DATASYS option only with Annotate data sets in which the coordinate system variables XSYS, YSYS, and HSYS specify the values 1, 2, 7, or 8.

  Use the DATASYS option when graphics elements that were created with data-dependent variables do not fit in the graphics output area. This happens when the coordinate values generated by the data exceed a range of 0 to 100.

  If you omit the DATASYS option, the GANNO procedure attempts to draw each graphics element according to the data values assigned to it, without scaling the values. If the range of data values is too large, some graphics elements will not display.

  See also: Using the DATASYS Option to Scale Graphs on page 710

  Featured in: Example 1 on page 710

DESCRIPTION= entry-description

DES= entry-description

• specifies the description of the catalog entry for the chart. The maximum length is 256 characters . The description does not appear on the chart. By default, the GANNO procedure assigns the description OUTPUT FROM PROC GANNO.

  Featured in: Example 2 on page 713

GOUT=< libref .> output-catalog

• specifies the SAS catalog in which to save the graphics output produced by the GANNO procedure. If you omit the libref, the SAS/GRAPH software looks for the catalog in the temporary library called WORK and creates the catalog if it does not exist.

  See also: Storing Graphics Output in SAS Catalogs on page 53

  Featured in: Example 2 on page 713

IMAGEMAP= output-data-set

• creates a temporary SAS data set that is used to generate an image map in an HTML output file. The information in the image map data set includes the shape and coordinates of the elements in the graph and drill-down URLs that have been associated with those elements. The drill-down URLs are provided by one or two variables in the input data set. These variables are identified to the GANNO procedure with the HTML= and/or HTML_LEGEND= options.

  The %IMAGEMAP macro generates the image map in the HTML output file. The macro takes two arguments, the name of the image map data set and the name or fileref of the HTML output file, as shown in the following example:

   %imagemap(imgmapds, myimgmap.html); 

  See also: Chapter 25, Annotate Dictionary, on page 613 and Adding Links with the HTML= and HTML_LEGEND= Options on page 574.

  Featured in: Example 4 on page 719

NAME= entry-name variable-name

• specifies one of the following:

  • the name of the catalog entry for the graph

  • a variable name for each value for which a separate graph is produced.

• If the value you assign to the NAME= option is enclosed in quotation marks, the procedure interprets it as a catalog entry name; if the value is not enclosed in quotes, the procedure interprets it as a variable name.

• The value entry-name specifies the name of the catalog entry for the graph. The maximum length is 8 characters. The default name is GANNO. If the specified name duplicates the name of an existing entry, SAS/GRAPH software adds a number to the duplicate name to create a unique entry, for example, GANNO1.

• If you specify variable-name , the GANNO procedure produces a separate graph for each different value of that variable. In addition, when you specify

  NAME= variable-name , each value of the variable is used as the name of the catalog entry for that graph. A value that is longer than 8 characters is truncated. For example, if the value is Frankfurt , it is truncated to Frankfur . A second catalog entry would be Frankfu1 . Consequently, you cannot use NAME= entry-name at the same time.

  Note: Specifying NAME= variable-name in the PROC GANNO statement produces results similar to those produced by the BY statement in a procedure that supports BY- group processing. See BY Statement on page 141 for details.

  Featured in: Example 2 on page 713 Example 3 on page 715

Using the DATASYS Option to Scale Graphs

If your Annotate data set specifies a coordinate system that is based on data values (that is, XSYS, YSYS, and HSYS are assigned the values 1, 2, 7, or 8), the data values determine the size and location of the graphics elements on the output.

If the procedure that specifies the annotation generates axes (such as GPLOT or GCHART), by default the axes are scaled to accommodate the full range of data values and to fit in the procedure output area. Because all values are included in the axes, the graph displays all the Annotate output that is dependent on data values.

However, if the annotation displays with the GSLIDE or GANNO procedure, which do not generate axes, the data values may generate coordinate values that exceed the limits of the graphics output area.

In this case, you can use the DATASYS option to tell the procedure that the Annotate data set contains data-dependent coordinates and to scale the output accordingly . For an illustration of this process, see Example 1 on page 710.

When you use the DATASYS option, the GANNO procedure reads the entire input data set before drawing the graph and creates an output environment that is data dependent; that is, the environment is based on the minimum and maximum values that are contained in the data set. It then scales the data to fit this environment so that all graphics elements can be drawn.

Although the DATASYS option enables you to generate graphs using one of the data-dependent coordinate systems, it requires that the procedure scan the entire data set to determine the minimum and maximum data values. You can save this extra pass of the data set by using data-dependent values only in procedures that generate axes. Annotate coordinate system 5 (percent of the procedure output area) is recommended for use with the GANNO procedure. This coordinate system works equally well with the GSLIDE procedure if you decide to display the annotation with titles and footnotes.