Documentation | ⌂ Topology Layers | « Previous | Next »
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.
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.
The workflow is identical to creating ordinary point objects.
Although Nodes are displayed as points, they are not ordinary GIS points.
A Node may represent:
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.
}
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.
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.
Topology explicitly stores connectivity relationships.
Without valid endpoint Nodes, the topology engine cannot maintain connectivity.
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.
All necessary Nodes are created by the topology engine to preserve 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.
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.
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:


Traditional GIS systems allow users to draw polygons directly. Topology follows a different philosophy.
This guarantees that:
At this point the topology contains all primitive types:
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.