Documentation | ⌂ Topology Layers | « Previous | Next »
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.
Select:
Topology → Create Topology...
The New Topology Project Wizard is launched. The wizard consists of several consecutive pages that define:
The first page determines how the topology project will be created.
Typical options include:
For the purpose of this tutorial, we will create an empty topology. The import workflow will be discussed in later chapters.
The second page defines two important parameters:
TatukGIS supports several topology models optimized for different types of spatial data.
IMPORTANT: The topology type determines which primitive relationships are available and how topology validation will be performed.
The next wizard page defines the spatial reference system and extent of the topology.
Displayed parameters include:
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.
The final wizard page contains topology-specific configuration settings.
Defines the logical name of the topology project: MyTopology.
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.
Determines where topology data will be stored: D:\GISData\MyTopology.
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.
Defines the number of decimal places preserved by the topology engine: 3.
Optional optimization mechanism used to improve editing and validation performance: Uncheck.
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:
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.
After reviewing all parameters, press: OK.
TatukGIS DK creates:
The new topology is automatically loaded into the current project.
Immediately after successful creation, three primitive layers appear in the project legend:
IMPORTANT: Primitive layers form the foundation of the entire topology. Every Feature Layer and hierarchy level created later ultimately depends on these layers.
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.
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