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 ofIDENTIFIER
specified on theMAP
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.
- For
- 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 theXCOORDINATE
,YCOORDINATE
and optionalZCOORDINATE
keywords.
- For
- 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 aSCORE
specification if ifSCORE=YES
on theSAVE
subcommand of theSPATIAL 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
andTYPE=DATASET
, theDATA
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 theMAP
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 onMAPKEY
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 onDATAKEY
in the order specified. Both keywords must contain the same number of fields.
- XCOORDINATE, YCOORDINATE, and ZCOORDINATE
- For
TYPE=FILE
andTYPE=DATASET
, theDATA
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 theSPATIAL 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.