Skip To Content

Topology properties

The Topology Properties dialog box lets you view the status and update the feature classes and rules associated with a topology.

To access topology properties, right-click the topology in the Catalog pane and choose Properties.

The Topology Properties dialog box has four tabs: General, Feature Classes, Rules, and Errors. Many of the tabs allow you to update the topology and edit properties. Any edits made to the topology will be committed once you click the OK button. If you want to discard your edits, close the Topology Properties dialog box or click the Cancel button.

Note:

More detailed information on all topology concepts and properties can be found in Topology in ArcGIS.

General tab

The General tab of the Topology Properties dialog box contains the following information:

  • Name—The name of the topology. You can update the name of the topology by clicking in the text box and making changes.
  • XY Cluster Tolerance—Any two vertices that fall within a horizontal distance of the cluster tolerance are assumed to be at the same location. During topology validation, the vertices that fall within the cluster tolerance will be given the same x,y-coordinate. To update the XY cluster tolerance, click in the text box and type your changes.
    Note:

    The default cluster tolerance value is 10 times the default x,y resolution, and this is recommended in most cases.

  • Z Cluster Tolerance—Any two vertices that fall within a vertical distance of the Z cluster tolerance are assumed to be at the same location. During topology validation, they will be given the same z-coordinate.
  • Status—This section shows whether or not the topology has been validated and if there are dirty areas to examine.

Feature Classes tab

The Feature Classes tab shows the number of coordinate accuracy ranks and Z ranks in the topology and what rank is assigned to each participating feature class.

When you define a topology, you rank the feature classes within the topology to control how vertices are moved when they fall within the cluster tolerance of one another. Feature classes with a rank of 1 are considered to have the highest accuracy. Coordinate ranks allow you to ensure that reliably placed vertices are the anchor locations toward which less reliable vertices are moved during topology validation.

You can edit the total number of XY ranks and Z ranks by clicking in their respective text boxes and typing a new number.

To edit the XY or Z rank associated with a feature class, click in the column next to the feature class and type a new number. You cannot enter a number greater than the amount shown in the Number of XY Ranks or Number of Z Ranks text boxes.

Add or remove feature classes

The Feature Classes tab also allows you to add feature classes to or remove feature classes from the topology. To remove a feature class, highlight the feature class in the grid and click Remove. To remove every feature class from the topology, click Remove All.

Follow these steps to add a feature class to a topology:

  1. Click Add Classes.

    This opens the Add Classes dialog box. This dialog box displays all of the feature classes in the feature dataset containing the topology that are not already participating in the topology.

  2. Choose which feature classes you want to add to the topology by clicking the check box beside the feature class name. You can select all available feature classes in the feature dataset by clicking Select All. Click Clear All to deselect all currently selected feature classes.
  3. Click OK to add the selected feature classes to the topology. Or you can click Cancel to exit out of the Add Classes dialog box without adding any feature classes to the topology.

Rules tab

Topology rules define the permissible spatial relationships between features. The Rules tab displays the topology rules defined on feature classes and subtypes participating in the topology.

To add rules to the topology, click Add or click in the last row of the grid where it says Click here to add a new rule. This creates an empty row. You can build a new rule between feature classes and their subtypes by using the drop-down menus in each column and filling out each cell from left to right to define the rule.

To remove a rule from the topology, select a row in the grid and click Remove.

Saving topology rules to a Rule Set File

  1. Right-click the topology and click Properties.
  2. Click the Rules tab.
  3. Click Save Rules.
  4. Browse to where you want to save the rules you've defined for the topology.
  5. Type a name.
  6. Click Save to save all the rules for the topology to the file.
  7. Click OK.

Loading topology rules from a Rule Set File

  1. Right-click the topology and click Properties.
  2. Click the Rules tab.
  3. Click Load Rules.
  4. Browse to where the rule set you want to load is saved.
  5. Click the rule set.
  6. Click Open.

    If the rule set was created from a topology that had the same feature class names as the feature classes in the new topology you're defining, the feature classes named in the rule set should be correctly matched to the feature classes in the new topology. If the names are different, you will need to match the feature classes mentioned in the rule set to their corresponding feature classes in the new topology.

  7. For each source feature class that is not mapped, click in the Target column and click the feature class to which it corresponds in the new topology.
  8. Click OK on all dialog boxes.
Note:
  • Loading a Rule Set into a topology with previously specified rules will append the rules from the Rule Set to the existing rules.
  • Loading a Rule Set will require the topology to be re-validated.
  • If there are feature classes specified in a rule set that cannot be matched to feature classes in the new topology, rules involving the unmatched feature classes will not be loaded.

Errors tab

The Errors tab offers a summary of errors and exceptions found in the topology. Similar to the Rules tab, the grid shows the topology rules and their participating feature classes and subtypes. The errors and exceptions associated with each topology rule are displayed on the right of the grid. Errors are generated when you validate a topology and a topology rule is violated. You can click the Export to file button to save the summary as a text file to create a record of the state of the topology at a given time. This is a useful way to document and monitor progress on a large topology editing project. See Validate and fix geodatabase topology for more information.