Import GIS vector data
GIS data can be imported to a schematisation using the 3Di Schematisation Editor’s vector data importer.
How to use the vector data importer
Use the following steps:
Add the vector data you want to import to your project.
Load the schematisation you want to import the data to using the 3Di Schematisation Editor toolbar.
In the 3Di Schematisation Editor toolbar, click the dropdown arrow next to the vector data importer button and choose the layer you want to import data into.
Fill in the fields in the dialog that appears. The options are explained below.
Note
Do not forget to fill in the fields in the additional tabs. E.g. if you are importing data to the Culvert layer and you check the option Create connection nodes, you will also need to fill in their in the Connection nodes tab.
Source layer: Choose the layer from which you want to import features.
Selected features only: Check this box if you only want to import the selected features.
Create connection nodes: Check this box if you want to create connection nodes at the start and end of the schematisation object. If connection nodes are available within snapping distance from the start or end vertex of the imported feature, the existing connection node will be used and the start or end vertex will be snapped to the connection node.
Create manholes: Check this box if you want to create manholes at the start and end of the schematisation object. If manholes already exist on the start or end connection nodes, the existing manhole will be used. This option is available for Culvert, Pipe, Weir and Orifice.
Main table: Field name: Name of the target field.
Main table: Method: Method with which the target field should be filled. Choose from the following options.
Auto: for ID, auto-increment from the current highest value.
Attribute: read the value from the specified attribute of the source feature. This can be a direct copy, or a value map (see below). If the source feature’s attribute value is NULL, the Default value will be used (if specified).
Default: use the specified Default value.
Ignore: leave this attribute empty (NULL) in the target feature.
Main table: Source attribute: the attribute in the source feature to be used when the chosen method is Attribute
Main table: Value map (optional): when using the method Attribute here you can specify how to translate the values encountered in the source layer (e.g. “Manning”) to values in the target layer (e.g. 2).
Main table: Default value: value to be used as fallback value when using the method Attribute or as value for all target features when using the method Default
Snap within: Snapping distance. If connection nodes are available within snapping distance from the start or end vertex of the imported feature, the existing connection node will be used and the start or end vertex will be snapped to the connection node.
Save as template: Save the import settings as a template (JSON file) to be used when importing similar data in the future.
Load template: Load previously saved import settings from a template (JSON file).
Processing algorithm
The vector data importer is also available as a set of Processing Algorithms in the 3Di Processing Algorithms, in the category 3Di Schematisation Editor.
The processing algorithms work in the same way as when using the graphical user interface explained above, but most of the options are read from the configuration file (JSON) that is supplied.
Source layer: Choose the layer from which you want to import features.
Import configuration file: Choose the JSON file that contains the import settings you want to use. The easiest way to create this JSON file is by using the Save as template option in the graphical user interface.
Target Schematisation Editor GeoPackage file: Choose the GeoPackage file. This file is created when using the Load from Spatialite option in the 3Di Schematisation Editor toolbar.
Configuration file (JSON)
This file contains all the settings that determine how the source data is read and interpreted and written to the target geopackage. The easiest way to create such a file and how to use the specific options is by using the Save as template option in the graphical user interface.