User Tools

Site Tools


doc:topologylayer:0500

Creating a New Topology

Documentation | ⌂ Topology Layers | « Previous | Next »

  • Every topology workflow starts with topology creation.
  • Primitive layers are created automatically: NODE, EDGE, and FACE.
  • SQLite, PostGIS, and Oracle topologies use the same creation workflow.

Creating a topology project is the first practical step in every topology workflow. Before Nodes, Edges, Faces, Feature Layers, or Features can be created, a topology structure must exist.

TatukGIS provides a dedicated wizard that guides users through the entire topology creation process.

The wizard is available through Menu:

Topology → Create Topology...

or programmatically through:

fTopoTool.RunTool(
  TGIS_TopoTools.CreateTopology
);

NOTE: At application startup, this is typically the only topology operation available because all other topology tools require an existing topology structure.

Creating the First Topology

Select:

Topology → Create Topology...

The New Topology Project Wizard is launched. The wizard consists of several consecutive pages that define:

  • Creation mode
  • Database type
  • Topology type
  • Coordinate system
  • Topology extent
  • Storage parameters
  • Database parameters

Selecting the Creation Mode

The first page determines how the topology project will be created.

Typical options include:

  • Create an empty topology project
  • Create a topology project and import an existing layer

For the purpose of this tutorial, we will create an empty topology. The import workflow will be discussed in later chapters.

Selecting Database Type and Topology Type

The second page defines two important parameters:

  • Storage backend
  • Topology type

Supported Database Types

  • SQLite
  • PostGIS
  • Oracle

Supported Topology Types

TatukGIS supports several topology models optimized for different types of spatial data.

  • Polygon
    intended for area-based datasets such as cadastral, administrative, land-use, and environmental data. Polygon topology creates all possible Faces from valid Edge boundaries and supports hierarchical polygon Feature Layers.
  • Line
    intended for linear datasets where topology relationships between Nodes and Edges must be maintained. The topology engine creates and validates linear topology structures, but Faces are not generated. This topology type is suitable for boundary datasets, utility lines, and other linear features requiring topology control.
  • Network Data
    intended for network datasets imported in their existing structure. Linear objects are imported without topology processing and no topology control is performed during import. This option is useful when preserving an existing network structure is more important than rebuilding topology relationships.

IMPORTANT: The topology type determines which primitive relationships are available and how topology validation will be performed.

Configuring the Coordinate System

The next wizard page defines the spatial reference system and extent of the topology.

Displayed parameters include:

  • Coordinate System
  • Minimum X
  • Minimum Y
  • Maximum X
  • Maximum Y

The selected coordinate system determines how all primitives will be stored and interpreted by the topology engine.

NOTE: The tutorial examples use ETRF2000 PL CS92 (EPSG:2180), but any supported coordinate system may be used.

Topology Parameters

The final wizard page contains topology-specific configuration settings.

Topology Name

Defines the logical name of the topology project: MyTopology.

Schema Name

Defines the database schema used to store topology objects: NEW.

This prefix is later used to generate the primitive layers: NEW_NODE, NEW_EDGE, NEW_FACE.

Output Folder

Determines where topology data will be stored: D:\GISData\MyTopology.

Tolerance

Defines the snapping distance used by the topology engine: 0.01.

Vertices located closer than the tolerance distance may be treated as identical during topology operations.

Precision

Defines the number of decimal places preserved by the topology engine: 3.

Gridding

Optional optimization mechanism used to improve editing and validation performance: Uncheck.

Database Connection Parameters

When creating a topology project in a server-based database such as PostGIS or Oracle, an additional wizard page is displayed to collect database connection parameters.

This step is not required for SQLite-based topology projects because all topology data is stored locally in a single database file.

The required parameters typically include:

  • Host name
  • Port number
  • Database name
  • Username
  • Password

These parameters are used to establish a connection to the target database and create the topology schema within that environment.

NOTE: This page is displayed only when PostGIS or Oracle topology is selected during the topology creation process.

Completing the Wizard

After reviewing all parameters, press: OK.

TatukGIS DK creates:

  • Topology database
  • Topology schema inside a database
  • Primitive layers
  • Project file: NEW.ttkproject
  • Layer definition files: NEW_NODE.ttkls, NEW_EDGE.ttkls, NEW_FACE.ttkls

The new topology is automatically loaded into the current project.

Topology Primitive Layers

Immediately after successful creation, three primitive layers appear in the project legend:

  • NEW_NODE – stores all topology Nodes
  • NEW_EDGE – stores all topology Edges
  • NEW_FACE – stores all topology Faces

IMPORTANT: Primitive layers form the foundation of the entire topology. Every Feature Layer and hierarchy level created later ultimately depends on these layers.

Understanding the Empty Topology State

At this stage the topology exists but contains no geometry.

The project is now ready for topology digitizing.

The next step is creating the first topology primitives.

Relationship Between Editor and API

Everything accomplished through the Create Topology Wizard can also be initiated through the Developer Kernel API.

This unified design allows developers to use the same topology workflow presented in this guide within their own applications.


With the topology project created, the next chapter focuses on building the first topology primitives and explains how Nodes, Edges, and Faces are created and maintained in TatukGIS

« Previous | Next »

2026/09/24 17:12

Page Tools