SAS/STAT 9.1 Users Guide, Volumes 1-7

Procedures Supporting ODS Graphics

The following SAS procedures support ODS Graphics in SAS 9.1:

For details on the specific graphs available with a particular procedure, see the 'ODS Graphics' section in the corresponding procedure chapter.

Operating Environments Supporting ODS Graphics

The following operating systems are supported:

• Windows (32- and 64- bit)

• OpenVMS Alpha

• z/OS (OS/390)

• UNIX (AIX, HP-UX, Tru64 UNIX, Solaris, Linux)

For information specific to an operating system, refer to the SAS Companion for that operating system.

Creating ODS Graphics in z/OS

Creating ODS Graphics with the z/OS (OS/390) operating system requires the following to be configured by your System Administrator:

• Java

• UNIX File System components

For more information, refer to the sections 'Installing UNIX File System Components' and 'Configuring SAS Software for Use with the Java Platform' of the SAS System Configuration Guide .

In addition, when you specify an ODS HTML destination you must specify the PATH= or GPATH= option with a valid UNIX directory.

ODS GRAPHICS Statement

The basic syntax for enabling ODS Graphics is

ods graphics on;

You specify this statement prior to your procedure statements, as illustrated in the 'Using the ODS GRAPHICS Statement' section on page 321. Any procedure that supports ODS Graphics then produces graphics, either by default or when you specify procedure options for requesting particular graphs.

To disable ODS Graphics, specify

ods graphics off;

The following is a summary of the ODS GRAPHICS statement syntax. You can find the complete syntax in the section ODS Graphics Statement in the 'Dictionary of ODS Language Statements' ( SAS Output Delivery System User's Guide ).

Syntax

• ODS GRAPHICS < OFFON < / options >> ;

• enables ODS to create graphics automatically. The default is ON.

Options

ANTIALIAS NOANTIALIAS

ANTIALIAS = ON OFF

• controls the use of antialiasing to smooth the components of a graph.

  OFF

  • suppresses the use of antialiasing for components other than text.

• ON

  • specifies that antialiasing is to be used to smooth jagged edges of all of the components in a graph.

    Text displayed in a graph is always antialiased. If the number of observations in the ODS output object exceeds 250, then antialiasing is not used, even if you specify the option ANTIALIAS=ON. The default is ON.

IMAGEFMT = < image-file-type STATIC STATICMAP >

• specifies the image file type (directly or indirectly) for displaying graphics in ODS output. The default image file type depends on the ODS destination; it is used when you specify IMAGEFMT=STATIC. You can also specify other supported image file types. This option only applies to ODS Graphics, and it has no effect on traditional high resolution graphics that rely on GOPTIONS values. The default is STATIC.

  image-file-type

  • specifies the type of image you want to add to your graph. If the image file type is not valid for the active output destination, the default is used instead. Table 15.3 lists the image file types supported for the ODS destinations that are valid with ODS Graphics.

    Table 15.3: Supported Destinations and Image File Types

    Destination	Values for IMAGEFMT= Option
    HTML	GIF (default), JPEG, PNG
    LATEX	PS (default), EPSI, GIF, JPEG, PNG
    PCL	Not applicable
    PDF	Not applicable
    PS	Not applicable
    RTF	Not applicable
    Note: For PCL, PDF, PS, and RTF, the IMAGEFMT= option is not applicable because the graph is contained in the output file. See Table 15.2.

• STATIC

  • specifies the best quality image file type for the active output destination.

• STATICMAP

  • applies only with the HTML destination and specifies that an HTML image map is to be created for tool tip support. The image file type used is the same as with STATIC. For an illustration see Example 15.2. If the number of observations in the data set exceeds 500, the image map is not generated.

IMAGENAME = < file- name >

• specifies the base image file name. The default is the name of the output object. You can determine the name of the output object by using the ODS TRACE statement. The base image name should not include an extension. ODS automatically adds the increment value and the appropriate extension (which is specific to the output destination that has been selected).

RESET

• resets the index counter appended to image file names .

  Note: The index counter is initialized to zero at the beginning of your SAS session or if you specify the RESET option in the ODS GRAPHICS statement. Graphics image files with the same name are overwritten.

Label Collision Avoidance

Label collision avoidance is supported in ODS Graphics by an algorithm which positions point labels so that label overlap is minimized. However, if the number of data labels is greater than 100, the labels are displayed at fixed positions and collision avoidance is not attempted.

Label collision avoidance is illustrated in Figure 15.17, which is a scatter plot taken from Example 24.3 in Chapter 24, 'The CORRESP Procedure.'

Figure 15.17: Label Collision Avoidance