Geoprocessing tool reference > Data Management toolbox > Topology toolset > Tools
Add Rule to Topology (Data Management) (ArcInfo and ArcEditor only) |
|
|
Release 9.2
Last modified November 29, 2010 |
Print all topics in : "Tools" |
Adds a new rule to a topology.
There are many topology rules that you can add to your topology. The rules you choose depend on the spatial relationships that are most important to maintain for the feature classes that participate in the topology.
Some topology rules govern the relationships of features within a given feature class, while others govern the relationships between features in two different feature classes. Topology rules can also be defined between subtypes of features in one or another feature class.
Topology rules are organized based on the geometry type of the origin feature class (polygon, line, or point). The origin feature class is the first feature class specified when adding the rule.
Learn more about Topology Rules by Origin Feature Class
Usage tips
-
To add a rule to a topology, the input topology cannot be registered as versioned.
-
You can type the name of the subtype value to which you want a topology rule to be applied. If you are using the command line and the subtype name consists of more than one word, use single quotes to contain the subtype name.
-
The following environment affects this tool: Workspace.
Command line syntax
An overview of the Command Line window
AddRuleToTopology_management <in_topology> <Must Not Have Gaps (Area) | Must Not Overlap (Area) | Must Be Covered By Feature Class Of (Area-Area) | Must Cover Each Other (Area-Area) | Must Be Covered By (Area-Area) | Must Not Overlap With (Area-Area) | Must Be Covered By Boundary Of (Line-Area) | Must Be Covered By Boundary Of (Point-Area) | Must Be Properly Inside (Point-Area) | Must Not Overlap (Line) | Must Not Intersect (Line) | Must Not Have Dangles (Line) | Must Not Have Pseudo-Nodes (Line) | Must Be Covered By Feature Class Of (Line-Line) | Must Not Overlap With (Line-Line) | Must Be Covered By (Point-Line) | Must Be Covered By Endpoint Of (Point-Line) | Boundary Must Be Covered By (Area-Line) | Boundary Must Be Covered By Boundary Of (Area-Area) | Must Not Self-Overlap (Line) | Must Not Self-Intersect (Line) | Must Not Intersect Or Touch Interior (Line) | Endpoint Must Be Covered By (Line-Point) | Contains Point (Area-Point) | Must Be Single Part (Line)> <in_featureclass> {subtype} {in_featureclass2} {subtype2}
| Parameter | Explanation | Data Type |
| <in_topology> |
The topology to which the new rule will be added. |
Topology |
| <Must Not Have Gaps (Area) | Must Not Overlap (Area) | Must Be Covered By Feature Class Of (Area-Area) | Must Cover Each Other (Area-Area) | Must Be Covered By (Area-Area) | Must Not Overlap With (Area-Area) | Must Be Covered By Boundary Of (Line-Area) | Must Be Covered By Boundary Of (Point-Area) | Must Be Properly Inside (Point-Area) | Must Not Overlap (Line) | Must Not Intersect (Line) | Must Not Have Dangles (Line) | Must Not Have Pseudo-Nodes (Line) | Must Be Covered By Feature Class Of (Line-Line) | Must Not Overlap With (Line-Line) | Must Be Covered By (Point-Line) | Must Be Covered By Endpoint Of (Point-Line) | Boundary Must Be Covered By (Area-Line) | Boundary Must Be Covered By Boundary Of (Area-Area) | Must Not Self-Overlap (Line) | Must Not Self-Intersect (Line) | Must Not Intersect Or Touch Interior (Line) | Endpoint Must Be Covered By (Line-Point) | Contains Point (Area-Point) | Must Be Single Part (Line)> |
The topology rule that will be applied to the input feature class(es). |
String |
| <in_featureclass> |
The input or origin feature class for the topology rule. |
Feature Class |
| {subtype} |
The subtype value for the input feature class. If subtypes do not exist on the origin feature class, or you want the rule to be applied to all subtypes, either do not set this parameter, or use a value of -1. |
String |
| {in_featureclass2} |
The second input or destination feature class for the topology rule. |
Feature Class |
| {subtype2} |
The subtype value for the second input or destination feature class. If subtypes do not exist on the origin feature class, or you want the rule to be applied to all subtypes, either do not set this parameter, or use a value of -1. |
String |
Command line example
AddRuleToTopology D:\Calgary\Trans.mdb\Streets\Street_Topo 'Must Not Intersect Or Touch Interior (Line)' D:\Calgary\Trans.mdb\Streets\StreetNetwork
Scripting syntax
About getting started with writing geoprocessing scripts
AddRuleToTopology_management (in_topology, rule_type, in_featureclass, subtype, in_featureclass2, subtype2)
| Parameter | Explanation | Data Type |
| in_topology (Required) |
The topology to which the new rule will be added. |
Topology |
| rule_type (Required) |
The topology rule that will be applied to the input feature class(es). |
String |
| in_featureclass (Required) |
The input or origin feature class for the topology rule. |
Feature Class |
| subtype (Optional) |
The subtype value for the input feature class. If subtypes do not exist on the origin feature class, or you want the rule to be applied to all subtypes, either do not set this parameter, or use a value of -1. |
String |
| in_featureclass2 (Optional) |
The second input or destination feature class for the topology rule. |
Feature Class |
| subtype2 (Optional) |
The subtype value for the second input or destination feature class. If subtypes do not exist on the origin feature class, or you want the rule to be applied to all subtypes, either do not set this parameter, or use a value of -1. |
String |
Data types for geoprocessing tool parameters
Script example
import arcgisscripting
gp = arcgisscripting.create()
gp.AddRuleToTopology_management("C:/Landbase.mdb/LegalFabric/topo1", "Must Not Intersect (Line)", "C:/Landbase.mdb/LegalFabric/Parcelline", "BlockLines", "", "", )