Chapter Contents |
Previous |
Next |
The GMAP Procedure |
Requirements: | At least one response variable is required. The ID statement must be used in conjunction with the BLOCK statement. |
Global statements: | FOOTNOTE, LEGEND, PATTERN, TITLE |
Description |
You can use statement options to enhance the appearance of the map. For example, you can specify the width of the blocks, the outline colors for the blocks and the map areas, and the angle of view. Other statement options control the response levels.
In addition, you can use global statements to modify the block patterns, the map patterns, and the legend, as well as to add titles and footnotes to the map. You can also use an Annotate data set to enhance the map.
BLOCKresponse-variable(s) </ option(s)>; |
option(s) can be one or more options from any or all of the following categories:
ANNOTATE=Annotate-data-set | |
BLOCKSIZE=size | |
CBLKOUT=block-outline-color | SAME | |
CEMPTY=empty-area-outline-color | |
COUTLINE=nonempty-area-outline-color | SAME | |
SHAPE=3D-block-shape | |
XSIZE=map-width <units> | |
YSIZE=map-height <units> | |
XVIEW=x | |
YVIEW=y | |
ZVIEW=z |
AREA=n | |
DISCRETE | |
LEVELS=number-of-response-levels | |
MIDPOINTS=value-list | |
MISSING |
CTEXT=text-color | |
LEGEND=LEGEND<1...99> | |
NOLEGEND |
DESCRIPTION='entry-description' | |
NAME='entry-name' |
HTML=variable | |
HTML_LEGEND=variable |
Required Arguments |
Blocks are not drawn for missing values for the response variable unless you use the MISSING option in the BLOCK statement.
See also: | About Response Variables |
Options |
Note: Annotate coordinate systems 1, 2, 7, and 8 are not valid with block maps.
See also: | The Annotate Data Set |
By default, AREA= fills map areas by rotating the default hatch patterns through the colors list, beginning with the M2N0 pattern. Unless specified otherwise, the outline color is the first color in the colors list. If the V6COMP graphics option or a PATTERN statement is specified, then the value of COUTLINE= defaults to SAME.
You can specify pattern fills and/or colors with PATTERN statements that specify map/plot patterns. A separate PATTERN definition is needed for each specified area. For more information about default pattern behavior or pattern specifications, see PATTERN Statement.
Featured in: | Assigning a Format to the Response Variable |
Featured in: | Creating Maps with Drill-down for the Web |
The default outline color depends on the PATTERN statement:
CBLKOUT= is not valid when SHAPE=CYLINDER.
Note: If you specify empty
block patterns, (VALUE=EMPTY in a PATTERN
statement) you should not change the outline color from the default value,
SAME, to a single color. Otherwise all the outlines will be one color and
you will not be able to distinguish between the empty areas.
Featured in: | Producing a Simple Block Map and Assigning a Format to the Response Variable |
The default outline color is the same as the default COUTLINE= color.
See also: | ALL and Displaying Map Areas and Response Data |
The default outline color depends on the PATTERN statement:
Note: If you specify empty map patterns,
(VALUE=MEMPTY in a PATTERN statement) you should not change the outline color
from the default value, SAME, to a single color. Otherwise all the outlines
will be one color and you will not be able to distinguish between the empty
areas.
Featured in: | Assigning a Format to the Response Variable |
The CTEXT= color specification is overridden if you also use the COLOR= suboption of a LABEL= or VALUE= option in a LEGEND definition that is assigned to the map legend. The COLOR= suboption determines the color of the legend label or the color of the legend value descriptions, respectively.
Featured in: | Creating Maps with Drill-down for the Web |
Use this option if your numeric response variable is assigned a user-written format.
Note: If the data do
not contain a value in a particular range of the format, that formatted range
is not displayed in the legend.
Featured in: | Assigning a Format to the Response Variable and Creating Maps with Drill-down for the Web (with the CHORO statement) |
See also: | LEGEND Statement |
Featured in: | Specifying Response Levels in a Block Map and Creating Maps with Drill-down for the Web |
If you do not use the LEVELS= option or the DISCRETE option, the GMAP procedure determines the number of response levels that use the formula FLOOR(1+3.3 log(N)), where N is the number of unique map area identification variable values.
The LEVELS= option is ignored when you use the DISCRETE option.
Featured in: | Specifying Response Levels in a Block Map |
For numeric response variables, value-list is either an explicit list of values or a starting and an ending value with an interval increment, or a combination of both forms:
n <...n> | |
n TO n <BY increment> | |
n <...n > TO n <BY increment> <n<...n >> |
By default the increment value is 1. You can specify discrete numeric values in any order. In all forms, n can be separated by blanks or commas. For example,
midpoints=(2 4 6) midpoints=(2,4,6) midpoints=(2 to 10 by 2)
If a numeric variable has an associated format, the specified values must be the unformatted values. For character response variables, value-list is a list of unique character values enclosed in quotes and separated by blanks:
'value-1' <...'value-n'> |
The values are character strings that are enclosed in single quotation marks and separated by blanks. For example,
midpoints='Midwest' 'Northeast' 'Northwest'
Specify the values in any order. If a character variable has an associated format, the specified values must be the formatted values.
You can selectively exclude some response variable values from the map, as shown here:
midpoints='Midwest'
Only those observations for which the response variable exactly matches one of the values listed in the MIDPOINTS= option are shown on the map. As a result, observations may be excluded inadvertently if values in the list are misspelled or if the case does not match exactly.
Featured in: | Creating Maps with Drill-down for the Web |
See also: | Displaying Map Areas and Response Data |
Featured in: | Creating Maps with Drill-down for the Web |
The CBLKOUT= option is not valid when SHAPE=CYLINDER.
Featured in: | Grouping and Subgrouping a Block Chart Specifying the Sum Statistic in Bar Charts Creating Bar Charts with Drill-down for the Web |
Valid units are CM (centimeters), IN (inches), or PCT (percentage of the graphics output area). By default, the unit is character cells (CELLS).
If you specify values for n that are greater than the dimensions of the procedure output area, the map is drawn using the default size.
Your viewing position cannot coincide with the viewing reference point at coordinates (0.5,0.5,0), the center of the map. The value for z cannot be negative.
If you omit the XVIEW=, YVIEW=, and ZVIEW= options, the default coordinates are (0.5,-2,3). This viewing position is well above and to the south of the center of the map. Specify one, two, or all three of the view coordinates; any that you do not explicitly specify are assigned the default values.
Featured in: | Specifying Response Levels in a Block Map |
Viewing Position and Viewing Reference Point shows the position of the viewing reference point, as well as the default viewing position.
Viewing Position and Viewing Reference Point
About Block Maps and Patterns |
By default, the blocks use solid pattern fills and the map areas use a hatch pattern of slanting lines. The map areas in block maps are the only map areas that by default do not use solid fills. The map areas and their outlines use the first color in the colors list regardless of whether the list is the device's default colors list or one specified with the COLORS= option in a GOPTIONS statement.
The BLOCK statement has the following options that explicitly control the outline colors used by the blocks and the map areas.
In addition the AREA= option controls how the map areas are patterned.
When you use PATTERN statements to define the patterns for the map, you must be sure to specify the correct type of pattern for the area. The blocks use bar/block patterns and the map areas use map/plot patterns. See PATTERN Statement for more information on specifying patterns.
Note: If you specify only one PATTERN statement and include only the COLOR= option,
that color will be used for both the blocks and the map areas. For example,
this statement makes the blocks solid blue and the map areas blue hatch.
pattern1 color=blue;
Chapter Contents |
Previous |
Next |
Top of Page |
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.