DATA subcommand (SPATIAL MAPSPEC command)

The DATA subcommand specifies data sources to include.

  • You can specify multiple DATA subcommands.
TYPE=FILE|MAP|DATASET
Specifies the type for the data source.
  • FILE. An IBM® SPSS® Statistics format data file (.sav).
  • MAP. A DBF (.dbf) file associated with a shape file (.shp) specified on the MAP subcommand.
  • DATASET. A dataset that is open in the current session.
SOURCE='file spec' | map id | dataset | *
Specifies the name of the data source.
  • For TYPE=FILE, the name must be a file specification enclosed in quotation marks.
  • For TYPE=MAP, the name must be the value of IDENTIFIER specified on the MAP subcommand.
  • For TYPE=DATASET, the name must be the name of a dataset that is open in the current session. You can use an asterisk (*) to refer to the active dataset.
IDENTIFIER=name
A unique name that identifies the dataset. The name must conform to variable name rules.
ROLE=EVENTDENSITY | CONTEXT | SCORE
Specifies the role of the data source.
EVENTDENSITY
  • For SPATIAL ASSOCIATION RULES, this value indicates that the data source contains event data. Event data contain information on events that occur, such as crimes, accidents, or individual addresses.
  • For SPATIAL TEMPORAL PREDICTION, this value indicates that the data source contains data for computing kernel density estimates. This data source must use coordinates, specified with the XCOORDINATE, YCOORDINATE and optional ZCOORDINATE keywords.
CONTEXT

A context data identifies features on the map. A context data can also contain fields that can be used as inputs for the model. To use a context dBase (.dbf) file that is associated with a map shape (.shp) file, the context dBase file must be in the same location as the shape file and must have the same root name. For example, if the shape file is geodata.shp, the dBase file must be named geodata.dbf.

SCORE
For SPATIAL TEMPORAL PREDICTION, fields that contain values for predicted values, variance, and upper and lower confidence bounds are written to the specified data source. You must include a SCORE specification if if SCORE=YES on the SAVE subcommand of the SPATIAL TEMPORAL PREDICTION command.
KEY
For TYPE=MAP, an optional list of hierarchical key fields. For example, a map could have a region for every county and every state. Since county names are not unique, you need to specify state and county as hierarchical keys.
SHAPEID
A unique internal ID value. This is the default.
DEFINED (field list)
A list of field names that define the hierarchical keys. The list of field names is enclosed in parentheses.
MAPID, DATAKEY, and MAPKEY
For TYPE=FILE and TYPE=DATASET, the DATA subcommand must specify either key values associated with a map or coordinate values.
MAPID=id
This setting specifies the map associated with the data. The ID value for the map is the IDENTIFIER value specified on the MAP subcommmand.
DATAKEY=fieldlist
The key fields in the data source that match the data with the map. Fields specified on DATAKEY are matched with fields specified on MAPKEY in the order specified. Both keywords must contain the same number of fields.
MAPKEY=fieldlist
The key fields in the map that match the map with the data. Fields specified on MAPKEY are matched with fields specified on DATAKEY in the order specified. Both keywords must contain the same number of fields.
XCOORDINATE, YCOORDINATE, and ZCOORDINATE
For TYPE=FILE and TYPE=DATASET, the DATA subcommand must specify either key values associated with a map or coordinate values. If the data source contains coordinate values, these settings specify the X, Y, and Z coordinates. The Z coordinate is optional and is ignored by the SPATIAL ASSOCIATION RULES command.
COORDSYSTEM
Specifies the coordinate system.
GEOGRAPHIC
The coordinate system is latitude and longitude. This option is the default setting.
CARTESIAN
The coordinate system is simple X and Y coordinates.
WKID (value)
The coordinate system is based on the WKID value. The value is enclosed in parentheses.
PROJECTION (name)
The coordinate system is based on the named projection. The name is enclosed in parentheses. For more information, go to http://help.arcgis.com/en/webapi/javascript/gmaps/help/topics/pcs.html
DATATOMAP='data value' TO 'map value'
Maps specified unmatched data key values to specified map key values.
  • Multiple pairs of values are separated by semi-colons.
  • Quotation marks are optional for numeric values.