User Tools

Site Tools


doc:topologylayer:0600

Working with Topology Primitives

Documentation | ⌂ Topology Layers | « Previous | Next »

  • Nodes are the foundation of topology connectivity.
  • Edges connect Nodes and define topology structure.
  • Edge endpoints must coincide with Nodes.
  • Faces are generated automatically in Polygon topology.

After creating a topology project, the next step is building its geometric structure using topology primitives.

As discussed earlier, every topology in TatukGIS Topology is built upon three primitive types: Nodes, Edge, and Face.

These primitives form the foundation for all Feature Layers, hierarchies, and topology operations described later in this guide.

IMPORTANT: Feature Layers do not exist independently. Every Feature ultimately depends on Nodes, Edges, and Faces stored in the topology.

Creating Nodes

The first step in constructing a topology is creating Nodes.

Once a topology has been created, the project contains a Node layer: NEW_NODE.

Nodes can be created using the standard TatukGIS editing workflow.

Creating a Node

  1. Select the NEW_NODE layer.
  2. Switch to editing mode.
  3. Select the Add Shape tool.
  4. Click on the map.
  5. Save the edits.

The workflow is identical to creating ordinary point objects.

What Does a Node Represent

Although Nodes are displayed as points, they are not ordinary GIS points.

A Node may represent:

  • An Edge endpoint
  • A network junction
  • A connectivity point
  • An isolated topology point

Creating Edges

After creating a collection of Nodes, Edges can be added.

Topology Edges are stored in layer: NEW_EDGE.

An Edge is a topology line primitive connecting two Nodes.

Creating an Edge

  1. Select the NEW_EDGE layer.
  2. Switch to editing mode.
  3. Start digitizing from an existing Node.
  4. Add optional internal vertices.
  5. Finish digitizing on another Node.
  6. Save the edits.

}

Edge Structure

The first Node becomes the From Node. The second Node becomes the To Node. Additional vertices may be inserted between them to define the shape of the Edge.

Edge Validation Rules

Unlike ordinary GIS polylines, topology Edges must satisfy topology constraints.

IMPORTANT: The first and last vertex of every Edge must coincide with existing Nodes.

If this requirement is violated, Edge creation is rejected and error occurred. The Edge is not created until the problem is corrected.

Why This Validation Is Required

Topology explicitly stores connectivity relationships.

Without valid endpoint Nodes, the topology engine cannot maintain connectivity.

Automatic Node Creation

TatukGIS also offers a simplified workflow that automatically creates required Nodes.

This mode can be enabled in: Topology → Settings by checking: Automatically create missing nodes when adding an edge.

When enabled, users can draw Edges directly without first creating all required Nodes manually.

Automatic Workflow

All necessary Nodes are created by the topology engine to preserve topology consistency:

  1. a new Edge is digitized without existing Nodes and intersects existing Edges;
  2. missing Nodes are created automatically and affected Edges are split to maintain topology consistency.

The topology engine not only creates missing start and end Nodes but also inserts additional Nodes wherever the new Edge intersects existing topology Edges. The affected Edges are automatically split, and the topology structure is updated to preserve connectivity.

NOTE The final topology structure is identical regardless of whether Nodes were created manually or automatically.

Creating Faces

Faces are the third primitive type available in topology. Unlike Nodes and Edges, Faces are never created manually.

IMPORTANT: There is no command for drawing Faces directly.

A Face is created automatically when topology Edges form a closed boundary.

Automatic Face creation is available only in Polygon topology. In Line topology, the topology engine maintains Nodes and Edges but does not generate Faces. Likewise, Network Data topology does not create Faces because linear features are imported without building a polygonal topology structure.

Face Creation Workflow

Consider a topology where several Nodes and Edges have already been created. As long as the boundary remains open, no Face exists. When the final Edge closes the boundary and completes a valid loop, the topology engine automatically recognizes the enclosed area and creates a new Face.

In our tutorial, the newly generated Face is stored in the NEW_FACE layer:

  1. the final Edge closes a topology boundary;
  2. a new Face is generated automatically.

Why Faces Are Generated Automatically

Traditional GIS systems allow users to draw polygons directly. Topology follows a different philosophy.

This guarantees that:

  • Face boundaries always remain valid.
  • Neighboring Faces share common Edges.
  • Geometry duplication is eliminated.
  • Topology integrity is preserved.

Primitive Layer Relationships

At this point the topology contains all primitive types:

  • Nodes in NEW_NODE layer
  • Edges in NEW_EDGE layer
  • Faces in NEW_FACE layer

The topology is now complete enough to support Feature Layers. The next stage of the workflow focuses on creating business objects that reference these primitives.

With the topology primitives successfully created, the next chapter introduces Feature Layers and explains how topology primitives become meaningful business objects within the topology hierarchy.


The topology is now complete enough to support Feature Layers. The next stage of the workflow focuses on creating business objects that reference these primitives.

« Previous | Next »

2026/09/24 17:12

Page Tools