SGRENDER Procedure

PROC SGRENDER Statement

Identifies the data set that contains the plot variables and the StatGraph template. You can also render a graph from a SAS ODS Graphics Editor (SGE) file. The statement also gives you the option to specify the name of the output object and the label for the output object.

Requirement:

Requires an input data set and a template, or an SGE file.

Syntax

Required Argument

Optional Arguments

Syntax

PROC SGRENDER TEMPLATE= statgraph-template <DATA= input-data-set>

<OBJECT= object-name>

< OBJECTLABEL=“text-string” > ;

PROC SGRENDER SGE= fileref | “file-name”

<OBJECT= object-name>

< OBJECTLABEL=“text-string” > ;

Summary of Optional Arguments

Render options

DATA=input-data-set

specifies the SAS data set that contains the variables to process.

OBJECT= object-name

specifies a name for the ODS output object.

OBJECTLABEL= “text-string”

specifies a description for the output image.

SGE= fileref | “file-name”

specifies the SAS ODS Graphics Editor (SGE) file to render.

Required Argument

TEMPLATE= statgraph-template: specifies a StatGraph template that defines one or more graphs. The SGRENDER procedure applies the StatGraph template to your data to create the output graphs.

Interaction:This argument is required except when you use the SGE= option.

Note:Specifying a template that is not a StatGraph template is not supported. If you specify a non-StatGraph template, then the SGRENDER procedure might produce unpredictable results.

Optional Arguments

DATA=input-data-set: specifies the SAS data set that contains the variables to process. By default, the procedure uses the most recently created SAS data set.

OBJECT= object-name: specifies a name for the ODS output object.

Alias:NAME=

Default:SGRender

Note:To specify the filename of the output image, use the IMAGENAME= option in the ODS GRAPHICS statement.

OBJECTLABEL= “text-string”

specifies a description for the output image. The description identifies the image in the following locations:

the Results window
the alternate text for the image in HTML output
the table of contents that is created by the CONTENTS option in an ODS statement

The default description is “The SGRENDER Procedure”.

Alias:DES=, DESCRIPTION=

SGE= fileref | “file-name”: specifies the SAS ODS Graphics Editor (SGE) file to render. Specify a fileref or a filename for the SGE file. This option enables you to render an SGE file to any supported ODS destination. The output type depends on the OUTPUTFMT option of the ODS GRAPHICS statement and the open ODS destination.
When you use this option to render an input SGE file, ODS does not produce an output SGE file even if the SGE=ON option is specified in the ODS statement.

For information about generating SGE files, see the SAS ODS Graphics Editor: User's Guide.

Requirement:Although SGE rendering does not require a data set, the SGRENDER procedure requires a data reference. You might need to specify DATA=_NULL_ in the SGRENDER procedure if the _LAST_ data set variable has not been set by the SAS system. This typically happens at the beginning of a SAS session, before the creation of a data set.