Chapter Contents |
Previous |
Next |
The GANNO Procedure |
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 |
See also: | The Annotate Data Set |
Options |
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 DATASYS, GANNO 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 do not display.
See also: | Using the DATASYS Option to Scale Graphs |
Featured in: | Scaling Data-Dependent Output |
Featured in: | Storing Annotate Graphics |
See also: | Storing Graphics Output in SAS Catalogs |
Featured in: | Storing Annotate Graphics |
See also: | Customizing Web Pages for Drill-down Graphs and HTML Variable |
Featured in: | Using Annotate Graphics in a Drill-down Graph |
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 for entry-name 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 for details.
Featured in: | Storing Annotate GraphicsUsing the NAME= Option to Produce Multiple Graphs |
Using the DATASYS Option to Scale Graphs |
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 Scaling Data-Dependent Output.
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.
Chapter Contents |
Previous |
Next |
Top of Page |
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.