Chapter Contents

Previous

Next
The GMAP Procedure

PROC GMAP Statement


Identifies the map data set and the response data set that contains the variables associated with the map. Optionally causes the procedure to display all map areas and specifies annotation and an output catalog.

Requirements: Both a map data set and a response data set are required.


PROC GMAP MAP=map-data-set
<DATA=response-data-set>
<ALL>
<ANNOTATE=Annotate-data-set>
<GOUT=<libref.>output-catalog>
<IMAGEMAP=output-data-set>;


Required Arguments

MAP=map-data-set
names a SAS map data set that contains the Cartesian coordinates for the boundary points of each map area. The map data set also must contain the same identification variable or variables as the response data set.
See also: About Map Data Sets


Options

PROC GMAP statement options affect all of the graphs that are produced by the procedure.

ALL
specifies that all maps generated by the procedure should include every map area from the map data set, even if the response data set does not include an observation for the map area. When ALL is used, the map areas that are not in the response data set are empty (no pattern fill) and are outlined in the foreground color. To change the outline color of an empty area, use the CEMPTY= option in the MAP statement.

If you omit this option, the GMAP procedure does not draw those map areas in the map data set that have no corresponding observations in the response data set. This is the default behavior.

When you use the ALL option with BY-group processing, the maps that are generated for each BY group include every map area from the map data set.
See also: Displaying Map Areas and Response Data

ANNOTATE=Annotate-data-set
ANNO=Annotate-data-set
specifies a data set to annotate all of the maps that are produced by the GMAP procedure. To annotate individual maps, use ANNOTATE= in the action statement.
See also: The Annotate Data Set

DATA=response-data-set
identifies the SAS data set that contains the response values that are evaluated and represented on the map. By default, the procedure uses the most recently created SAS data set.
See also: About Response Data Sets and SAS Data Sets

GOUT=<libref.>output-catalog
specifies the SAS catalog in which to save the graphics output that is produced by the GMAP procedure. If you omit the libref, SAS/GRAPH 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

IMAGEMAP=output-data-set
creates a SAS data set that contains information about the graph and about areas in the graph. This information includes the shape and coordinates of the areas, and is used to build an HTML file that links the graph areas to other files or images. This linking provides drill-down functionality on the graph. The Imagemap data set also contains the information that is stored in the variables referenced by the HTML= and HTML_LEGEND= options. Therefore, in order to use IMAGEMAP= to create an HTML file, you must also use the HTML= option or the HTML_LEGEND= option or both.
See also: Customizing Web Pages for Drill-down Graphs


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.