Create Topology (Data Management)

Available with Standard or Advanced license.

Summary

Creates a topology. The topology will not contain any feature classes or rules.

Use the Add Feature Class To Topology and the Add Rule To Topology tools to add feature classes and rules to the topology.

Usage

  • If the Cluster Tolerance parameter is blank or set to 0, the xy tolerance of the feature dataset which contains the topology will be used.

  • There is a range allowed for the cluster tolerance value, this range is derived from the precision of the spatial reference of the feature dataset in which the topology is contained. If the value entered is larger than the maximum cluster tolerance, the maximum value will be used instead. If the value entered is smaller than the minimum, the minimum value will be used.

Parameters

LabelExplanationData Type
Input Feature Dataset

The feature dataset in which the topology will be created.

Feature Dataset
Output Topology

The name of the topology to be created. This name must be unique across the entire geodatabase.

String
Cluster Tolerance
(Optional)

The cluster tolerance to be set on the topology. The larger the value, the more likely vertices will be to cluster together.

Double

Derived Output

LabelExplanationData Type
Output Topology

The output topology.

Topology

arcpy.management.CreateTopology(in_dataset, out_name, {in_cluster_tolerance})
NameExplanationData Type
in_dataset

The feature dataset in which the topology will be created.

Feature Dataset
out_name

The name of the topology to be created. This name must be unique across the entire geodatabase.

String
in_cluster_tolerance
(Optional)

The cluster tolerance to be set on the topology. The larger the value, the more likely vertices will be to cluster together.

Double

Derived Output

NameExplanationData Type
out_topology

The output topology.

Topology

Code sample

CreateTopology example (stand-alone script)

The following stand-alone script demonstrates how to use the CreateTopology function.

# Name: CreateTopology_Example.py
# Description: Creates a new topology (these must reside within a feature dataset)

# Import system modules
import arcpy
 
arcpy.env.workspace = "h:/workspace"
arcpy.CreateTopology_management("d:/landuse.gdb/landuse", "landuse_Topology")

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: Yes
  • Advanced: Yes

Related topics