Creates, replaces, modifies, or deletes polygonal index data sets by using a libref and polygonal index references from a spatial entry.
calculates the enclosed areas and perimeter lengths for the lowest-level area composite that is specified on the COMPOSITE= argument.
specifies the type of centroid data that is returned.
specifies the composite or list of composites that define the boundaries of the enclosed polygonal areas that are used to create the index.
specifies whether messages about any topological errors that are detected while the index is being constructed are written to the SAS log.
indicates that an existing polygonal index data set that is specified in the OUT= argument can be overwritten.
specifies that polygonal index data sets are to be retained when the index definition is removed from the spatial entry.
names the index data set that you want to create, replace, or update.
specifies the polygonal index that you want to create, delete, replace, or update. The polygonal-index value must conform to the following rules for SAS names:
You must specify one of the following values for the operation keyword:
creates a polygonal index data set and stores the polygonal index definition in the current spatial entry. The POLYGONAL INDEX CREATE statement does not overwrite existing index definitions or data sets. A warning is issued and processing of the current RUN group is halted if either a polygonal index definition or a SAS data set with the specified names already exist. Use POLYGONAL INDEX REPLACE to replace an existing index definition or data set.
Requirement | For the CREATE operation, you must specify both the COMPOSITE= and OUT= arguments. |
removes the specified polygonal index definition from the spatial entry. By default, the POLYGONAL INDEX DELETE statement also deletes the associated index data set. You can use the KEEP option to prevent the index data set from being deleted.
A warning is issued and processing of the current RUN group is halted if the specified polygonal index does not exist.
For DELETE, you can
also specify the special value _ALL_
for
the polygonal-index argument
to delete all the polygonal index definitions in the current spatial
entry.
Restriction | KEEP is the only additional argument (other than the polygonal index name) that can be used with the DELETE operation. |
CAUTION: |
Requirement | For the REPLACE operation, you must specify both the COMPOSITE= and OUT= arguments. |
Note | The data set that is specified in the OUT= argument can already exist and belong to a different spatial entry. In this case you must specify the FORCE argument to cause the spatial entry to be overwritten. |
modifies only the specified characteristics for an existing polygonal index. A warning is issued and processing of the current RUN group is halted if there is no existing polygonal index with the specified name.
Note | If the data set that is specified in the OUT= argument already exists and belongs to a different spatial entry, you must specify the FORCE argument to cause it to be overwritten. |
When you specify CREATE, REPLACE, or UPDATE for the operation argument in the POLYGONAL INDEX statement, you can specify the one or more of the following additional optional arguments. When you specify DELETE for the operation argument, only the KEEP option is allowed. Separate the list of arguments from the polygonal index name with a slash (/).
calculates the enclosed areas and perimeter lengths for the lowest-level area composite that is specified on the COMPOSITE= argument. The calculated area is added to the polygonal index data set in a variable named AREA. A label for the AREA variable contains the storage area units. The calculated perimeter is added to the polygonal index data set in a variable named PERIMETER. A label for the PERIMETER variable contains the units.
returns the actual calculated centroids, which might not fall within the boundaries of their corresponding polygons. The coordinates are added to the polygonal index data set in variables that are named CTRX and CTRY. Labels for the CTRX and CTRY variables contain the storage projection units and indicate that this is a GEOMETRIC centroid. Specifying the CENTROID argument by itself returns the same results as specifying CENTROID=GEOMETRIC.
returns adjusted centroids that are moved to be within the boundaries of their corresponding polygons. The coordinates are added to the polygonal index data set in variables that are named CTRX and CTRY. Labels on the CTRX and CTRY variables contain the storage projection units and indicate that this is a VISUAL centroid.
specifies the composite or list of composites that define the boundaries of the enclosed polygonal areas that are used to create the index. If the composite-name list consists of a single composite, you can omit the parentheses. An error occurs if any of the specified composites are not defined in the current spatial entry or if any do not have the CLASS attribute of AREA.
Note | The COMPOSITE= argument is required when you use the CREATE or REPLACE operation. |
specifies whether messages about any topological errors that are detected while the index is being constructed are written to the SAS log. A polygon boundary consists of a single chain with the same starting and ending node, or multiple chains that form a closed boundary. The starting node for each boundary chain must be the ending node of the previous chain. The ending node of the last chain must be the beginning node of the first boundary chain. A topology error occurs when the polygon is not closed. You can specify the ERRORS argument with no added parameter to print all topological error messages, or you can add the =number parameter to specify the maximum number of topological error messages that will be written to the log.
Restriction | This option is valid only with the DELETE operation. |
polygonal index create state / composite=state out=gmaps.statex; run;