Topoplan module

The Topoplan module is available only for 64-bit version.
The Topoplan module is designed to create a digital terrain model and prepare a drawing for the release of topographic plans.

The commands are collected in the Topoplan ribbon tab (and Topoplan menu of the classic interface).

Note
If there is no license for the module, when the commands start a warning message will appear that the commands will not work.
To work, use the meter template nanoCAD_EarthWork_metric.dwt from the list of templates.

The Topoplan module includes support of Civil 3D objects. If you open a drawing containing such objects, then they will be displayed as drawing objects (and not as proxy graphics), display of their properties (for example, on the Properties bar), switching styles, and managing style elements for some objects will be available.
Displaying command settings in the Properties bar
Settings of most module commands are displayed and edited on the Properties bar.

If the Properties toolbar was not open (for example, by CTRL+1), it will be displayed automatically. At this time, the prompt is displayed in the command line:
Change the settings, if necessary, and continue to perform the command by pressing ENTER or selecting Yes in the command line.
If the display of dialog boxes has been disabled by CMDDIA variable, the command options will be output one by one to the command line.
Recalculation of Coordinates

The command recalculates geocoordinates of topoplan objects to another system using EPSG codes.

To recalculate coordinates:
-
- Run the command.
-
- In the dialog box that appears, in the Source EPSG and Target EPSG fields, enter the number of the source and target coordinate systems according to the EPGS classification, based on the list on the left side of the window. You can use the search filter. When finished, click Apply.
-
- Information about the transformation will appear at the bottom of the dialog box. Click OK to confirm the transformation.
The list of coordinate systems for conversion also includes user-created coordinate systems (the Create Coordinate System command). The file with user-created coordinate systems is located at – C:\Users\User_name\AppData\Roaming\ Nanosoft**Ошибка! Неизвестное имя свойства документа.** 25.0\imppointslib\geoids\other.extra.

Note
The NG_REPROJECTION command works only with Topoplan and is not intended for recalculation of Point Clouds.
Geocalculator
Ribbon: Topoplan – Settings > Geocalculator
Menu: Topoplan – Settings > Geocalculator
Toolbar: Topoplan Settings > Geocalculator
Command line: NG_GEOCALC
The command allows you to:
Calculate the parameters of transformation of coordinate systems
spatial 3-dimensional:
- 7 parametric Helmert transformation;
- 9 parametric Helmert transformation;
- Molodensky transformation.
flat rectangular:
- 4 parametric Helmert transformation;
- 5 parametric Helmert transformation.
Recalculation of coordinates
geodetic:
- geographic to flat rectangular Gauss-Kruger or UTM and back;
- geographic and rectangular between 3-dimensional coordinate systems, using the recalculation parameters;
flat arbitrary:
flat rectangular between 2-dimensional coordinate systems, using the recalculation parameters. Calculations are made both for individual points and for files.
Calculating distances and directions on a plane and an ellipsoid
The source data is located in the LIB directory in the program installation directory (Nanosoft**Ошибка! Неизвестное имя свойства документа.** 25.0\UserDataCache\maplib\LIB). Changing the directory name and its location is not allowed.
The Ellipsoid Library is required for the command to work. The ellipsoid data is a text file gt_ellips.csv, containing the name, code, major and minor semi-axes in meters, and the denominator of compression for each ellipsoid. The field values are separated by commas.
A fragment of the file is given below:
NAME,CODE,A,B,RF
Airy 1830 ,AA,6377563.396,6356256.9090,299.324964600 Modified Airy ,AM,6377340.189,6356034.4480,299.324964600
Australian National ,AN,6378160.000,6356774.7190,298.250000000
The file can be edited by the user, but the file name and format should not be changed. Viewing the ellipsoid library is available from the Calculate Transformation Parameters dialog.

The main window is the transaction log window. All calculation results are displayed in the log window.

The geocalculator has a built-in toolbar, which is located under the window title.

- Transformations
- Transformation parameters
- Distances and directions
- Templates
- Clear log
- Save log
Transformations
The coordinates are recalculated using EPSG codes in a dialog box opened from the
Transformations toolbar.

Transformation parameters
The coordinates are recalculated in the dialog box opened from the Transformation Parameters toolbar.

Distances and directions
Distances and directions are recalculated in the dialog box opened from the Distances and directions toolbar.
After selecting an ellipsoid from the library, the following tasks can be solved:
Azimuth and distance applied to a geodetic line.
Forward geodetic task.

Inverse geodetic task.

On a plane.
Forward and inverse geodetic tasks.

Templates

Creating a Coordinate System

Creating a custom coordinate system manually or by importing a PROJ file. The command is designed to set a custom coordinate system and then save it in the database.

There are two ways to create a custom coordinate system.
- Filling in the dialog fields.
The principle of transformations consists of transforming the source coordinate system to the reference ellipsoid and then transforming it to the WGS84 ellipsoid. This procedure is performed in two stages.
The first stage consists of transforming coordinates from the local system to the standard cartographic projection on which it is based and then to the reference ellipsoid. The fields to fill in are in the left part of the dialog.
The second stage is transforming to WGS84. For this, the Helmert semi-parameter transformation is used. The data is entered into the corresponding fields in the right part of the dialog.
The specified values are transformed to the PROJ library command line standard with a check for data correctness. This eliminates the possibility of erroneous transformations getting into the database. The file with custom coordinate systems is located
C:\Users\User_name\AppData\Roaming\Nanosoft**Ошибка! Неизвестное имя свойства документа.** 25.0\imppointslib\geoids\other.extra.
- Import from file.
System parameters can be imported from .prj files
These files contain strings in WKT format:
PROJCS["unknown",
GEOGCS["GCS_unknown",
DATUM["D_Unknown_based_on_Bessel_1841_ellipsoid",
SPHEROID["Bessel_1841",6377397.155,299.1528128]],
PRIMEM["Greenwich",0.0],
UNIT["Degree",0.0174532925199433]],
PROJECTION["Transverse_Mercator"],
PARAMETER["False_Easting",0.0],
PARAMETER["False_Northing",0.0],
PARAMETER["Central_Meridian",37.5],
PARAMETER["Scale_Factor",1.0],
PARAMETER["Latitude_Of_Origin",55.6666666666667],
UNIT["Meter",1.0]]As a result of entering data into the coordinate system, it will appear in the nanoCAD database.
Information About Coordinate Systems


Toolbar: Topoplan Settings > Information About Coordinate Systems
Command line: NG_CRS_INFO
Viewing information about all available coordinate systems, including user-created ones.

By selecting a coordinate system from the list of available ones, it is possible to export the selected SC to a file in .prj format, or delete the selected SC.
Creating Geopoints
Geopoint Object
Geopoint is a coordinate geometry oriented (COGO) point, which, in addition to coordinates can contain additional attributes and store styles for displaying labels and markers.

In nanoCAD a geopoint is represented as a separate object. A geopoint and a simple point are different objects: a classic nanoCAD point contains only coordinates.
Geopoints can be imported in the document by the Import Geopoints command.

Geopoints can be created manually by the Create Geopoints/Blocks Manually command or obtained as a result of the work of the Explode the Cloud into Points command.
The properties of a geopoint, like any other objects, can be edited in the Properties bar.
Geopoints have grips, the movement of which is initiated by: moving a geopoint, rotating a marker, moving and rotating a label. The same parameters can be changed in the Properties bar:

The grip for moving the label allows you to expand the geopoint’s label and marker with the formation of a leader with an arrow. To return the label to its previous position, just drag the grip for moving the label onto the grip for moving the geopoint.

It is possible to snap to geopoints in the Node mode.
Geopoints in the Drawing Explorer

To organize points and control how they are displayed in a drawing, ou use collections of named points called point groups.
Geopoints are displayed in the Drawing explorer, each in its own group. The same bar displays sets of geopoint marker styles, geopoint label styles, custom properties of geopoints.

Marker and Label Styles of Geopoints
The marker styles and label styles of geopoints are used to change the display of a geopoint in the drawing field.

You can create new marker styles and label styles of geopoints from the context menu of Drawing Settings - COGOPoints - Marker Style or Label Style in the Drawing Explorer.

Editing geopoint marker styles is started by double-clicking on the desired marker style in the Drawing Explorer. Parameters are configured in the Properties bar.

Editing geopoint label styles is started by double-clicking the desired label style in the Drawing Explorer. Parameters are configured in the Properties bar.

Geopoint Groups
To organize points and control how they are displayed in a drawing, use collections of named points called point groups.
Groups of geopoints can be created by the Create a Group of Geopoints Manually and Create Groups of Geopoints by Original Description commands.
Double clicking on the name of a group of geopoints in the Drawing Explorer starts editing the parameters of the group in the Properties bar:

A group can be assigned with a geopoint marker style and a geopoint label style. When style override is enabled, the group style will be applied to all geopoints in that group. After disabling the style override, the appearance of the marker or label of each point in the group will return to the view specified in the point.
You can rename or delete a group of points using the commands of named group context menu in the Drawing Explorer.

A Description key sets can be applied to a group of geopoints. The command is applied to a group in the drawing explorer using the context menu. More information about description keys in the section Description Key Sets.

User-Defined Properties of Geopoints
You can set user-defined properties for geopoints. If you have additional data that cannot be distributed over existing standard geopoint properties, you can specify your own user-defined properties.
There are four types of user-defined properties available:
- String: allows you to enter text as a value. Is used when you want to enter any alphabetic or numeric characters.
- Integer: allows you to enter only whole numbers without decimals.
- Double: creates a property that allows you to enter numbers with decimal places.
• Boolean: creates a property that allows switching Yes/No (true or false) value.
Geopoint user-defined properties are grouped into user-defined property classification. A classification can be created, filled with user-defined properties, or deleted.
Thus, if you have a survey that contains tree data, you can create a Trees classification. Then create user-defined properties in it related to this classification.
For example:
- Name (String),
- Deciduous (Boolean),
- Elevation (Double).
All user-defined properties of geopoints and their classifications are displayd in the Drawing Explorer (Drawing settings – COGOpoints – User-defined Property Classification).

You can view and edit the values of user-defined geopoint properties of the drawing in the Properties bar.

You can create a new user-defined property classification by selecting Create in the context menu of the Drawing settings – COGO Points – User-defined Property Classification section in the Drawing Explorer.
You can create a new custom property by selecting Create in the context menu of any user-defined property classification in the Drawing Explorer.
You can set a description for a custom property. The use of descriptions will be implemented in one of the next versions.

User-defined properties can also be assigned during the import of geopoints by the Importgeopoints command.
You can delete a classification or a user-defined property by selecting Delete in their own context menu in the Drawing Explorer.
Ceopoints/Blocks Manually

The command creates geopoints or blocks with the location of the point in the drawing, description and mark.
Command prompt:
Select point type or [Blocks/COGOPoints]: Select the type of the object to be created.
For blocks:
Blocks can only be added to a drawing that contains blocks with attributes. In the Properties bar, you can specify the block name, elevation, or point description. The point elevation and description are selected from the attributes of the selected block.

Apply changes [Yes/No/Save/saveDefault]
Yes – the command will be performed taking into account the changes in settings made by the user in the current session of the command.
No – the command will be performed with the settings that were displayed immediately after the command was launched.
Save – save the settings to the document.
saveDefault – save the settings to the registry.
Specify the location for the new point:
Specify the location of the point in the drawing field, or enter the coordinates of the point.
For geopoints:
Specify the location for the new point:
Enter a description of the point <.>:
Specify the elevation of the point <.>:
Specify the point location in the drawing field or enter the point coordinates.
Enter the point description.
Enter the point elevation mark.
| COGO Point Geometry - | ||
|---|---|---|
| Easting | 2226481.25 | |
| Northing | 497666.90 | |
| Elevation | 3.00 |
These and other parameters of the created point can be later edited using the Properties bar. For example, you can separately set the rotation angles for a marker and a label. If label and marker styles are missing, then geopoints will be created with the standard style.

Creating Geopoints by Points and Texts

The command creates geopoints by points (circles, blocks) and text objects (Texts, MTexts) found at a specified distance. The maximum distance for text search is specified in the drawing.

Command prompts:
Select objects or [?]: Select objects to be converted to geopoints. Input a new COGO group name Enter a name for a new group of geopoints.
The parameters of the Creating Geopoints by Points and Texts command are configured in the Properties bar.

| Text with elevation | Selection of single-line and multi-line text to get a label, or both. | ||
|---|---|---|---|
| Remove original objects | Specifies whether to delete the original objects or not. | ||
| Max Distance | Distances from point to text. | ||
| Measure Distance | Selection of the maximum distance calculation mode (only in 2D, i.e. projection onto the drawing plane, or in 3D) |
| Text posiiton | Distance to the text insertion point (yellow segment) or to the nearest text boundary (green) | |
|---|---|---|
| COGO point group | Creating a group for new geopoints (if the group is not specified, put it in the _All Points group) |
Creating Geopoints by Interpolation

The command creates new geopoints by interpolation between two points specified in the drawing. Several points can be added sequentially. Pressing the ESC key terminates the command.
The parameters of the Create Geopoints by Interpolation command are configured in the Properties bar.

| Enter elevation manually | Selecting the method for specifying marks. |
|---|---|
| ----------------------------- | -------------------------------------------- |
Create Points on Ends The mode for adding geopoints in the beginning and end of a line.
| Project points on mesh | Indicating whether to project points onto the mesh. If Yes is selected, an additional setting appears – Projection. |
|---|---|
| Projection | The direction in which the points will be projected onto the surface (WCS, UCS or Viewport). |
Command prompts:
Specify the first point or [Settings]:
Specify the second point or [Settings]:
Specify points count <1> or [Settings]:
[Settings]:
Apply changes
[Yes/No/save/saveDefault]
Specify the first point of the distance.
Specify the second point of the distance.
Yes – the command will be performed taking into account the settings changes made by the user in the current command session.
No – the command will be performed with the settings that were displayed immediately after the command was launched.
save – saving settings to the document.
saveDefault – saving settings to the register.
Creating Geopoints by Surface
Ribbon: Topoplan – Geopoints > Creating Geopoints by Surface Menu: Topoplan – Geopoints > Creating Geopoints by Surface Toolbar: GeoPoints > Creating Geopoints by Surface Command line: NG_CREATE_POINTS_BY_TIN
The command creates new geopoints at the nodes of surface faces. Geopoints take X, Y, Z coordinates from surface nodes. The geopoint style is assigned by default (Standard).
Command prompts:
Select objects or [?]: Select a surface in the drawing field.
The command line will display the number of points created.
The command has no options.
Creating a Group of Geopoints Manually
Ribbon: Topoplan – Geopoints > Create Groups of Geopoints Manually
Menu: Topoplan – Geopoints > Create Groups of Geopoints Manually
Toolbar: Geopoints > Create Groups of Geopoints Manually
Command line: C3D_CREATE_COGO_POINT_GROUP
Manual creation of a group of geopoints with a name, description, styles, and a prefix of the raw description of the geopoint, which is a criterion for adding points to the group.

The command options are set in the Properties bar:
- Name;
- Description;
- Marker Style (of those existing in the drawing);
- Override Marker Style;
- Label Style (of those existing in the drawing);
- Override Label Style;
- Add with Raw Description prefix the criterion for adding a point to the group. Allows you to add to the group only points with the specified raw description.
Command prompts:
Change parameters in ‘Properties’ window and choose ‘OK’ to create Point Group or ‘Cancel’ to discard any changes <ОK> or [OK/Cancel]:
Yes – a group of geopoints will be created with the current settings.
Cancel – if the settings have been changed, they will not be preserved. A group of geopoints will be created with the settings displayed right after the command starts.
Creating Groups of Geopoints by Original Description

Toolbar: Geopoints > Create Groups of Geopoints by Original Description
Command line: C3D_CREATE_COGO_POINTS_GROUPS_BY_RDESCR
Automatic creation of geopoint groups. All points with the same raw description are combined into one group. As many groups are created as different raw descriptions were found in Geopoints in the
drawing. The names of the created groups coincide with the raw descriptions. If geopoints without description are selected when using the command, they will be added to the created group – Points without description.
The command has no options.
Creating Label Styles of Geopoints

Command line: C3D_CREATE_COGO_LABEL_STYLE
The Label style command allows you to create a geopoint label style and is launched from the context menu of the section Drawing settings - COGOPoints - Label style in the Drawing Explorer. A new style is created by copying the properties of the standard style.

The command allows you to create a geopoint label style by copying an existing style. When copying a label style, all parameters are copied, they are displayed in the Properties bar and can be edited. An index is added to the name by default, you can specify your own name.

Parameters of the label style being created are configured in the Properties bar and are discussed in the Editing Label Styles of Geopoints section. It is not allowed to create two styles with the same name .
Creating Marker Styles of Geopoints

Command line: C3D_CREATE_COGO_MARKER_STYLE
The Marker style command allows you to create a geopoint marker style and is launched from the context menu of the section Drawing settings - COGOPoints - Marker style in the Drawing Explorer. Creates a new style by copying the properties of a standard style.

This command allows you to create a geopoint marker style by copying an existing style. When copying a marker style, all parameters are copied, they are displayed in the Properties bar and can be edited. An index is added to the name by default, you can specify your own name.

The parameters of the marker style being created are configured in the Properties bar and are discussed in the Editing Marker Styles of Geopoints section. It is not allowed to create two styles with the same name.
Editing Label Styles of Geopoints
Editing label styles is started by a double clicking the desired label style of a geopoint in the Drawing Explorer. The options are set in the Properties bar.

Options:
Label Offset

the current offset values of the label. Even if the label was previously offset relative to the marker, the offset values in the X Offset and Y Offset fields will be 0.
To reset the offset and return the label back to the marker’s base point, set the Apply Label Offset parameter to Yes again and apply the changes with zero offset parameter values.
Leader
| Visibility | Whether the leader line should be visible after dragging from its original position. | |||
|---|---|---|---|---|
| Leader type | Form of the leader line: straight or spline. | |||
| Leader color | Color of the leader. | |||
| Leader linetype | Linetype of the leader. | |||
| Leader lineweight | Lineweight of the leader. | |||
| Components display | Determines how the label’s contents are displayed after being dragged from the default position. | |||
| Configuration Preserved: Labels retain their initial layout and orientation settings. When this value is selected, all other properties in the Motion State Components category will not be editable. | ||||
| Grouped Text: Converts labels according to the Motion State Components category settings. | ||||
| All boxes, lines, ticks, and directional arrows are deleted. Text components are arranged as fractional text vertically in the order specified by the label style. |
Command prompts:
Change parameters in ‘Properties’ window and choose ‘OK’ to save changes or ‘Cancel’ to discard any changes <ОK> or [OK/Cancel]:
Yes – all changes to label style properties made in the Properties bar will take effect.
Cancel – all changes to label style properties made in the Properties bar during this session of the command work will be cancelled.

Note
Unused geopoint label styles can be deleted. Once a style is in use, it cannot be deleted.
Editing Marker Styles of Geopoints
Editing marker styles is started by a double clicking the desired marker style of a geopoint in the Drawing Explorer. The options are set in the Properties bar.

Command prompts:
Change parameters in ‘Properties’ window and choose ‘OK’ to save changes or ‘Cancel’ to discard any changes <ОK> or [OK/Cancel]:
Yes – all changes to marker style properties made in the Properties bar will take effect.
Cancel – all changes to marker style properties made in the Properties bar during this session of the command work will be cancelled.
Editing Properties of Geopoint Groups
Double click on the name of the Geopoint group in the Drawing Explorer starts editing its parameters in the Properties bar:

Command prompts:
Change parameters in ‘Properties’ window and choose ‘OK’ to create User-Defined Property or ‘Cancel’ to discard any changes <ОK> or [OK/Cancel]:
OK – all changes of geopoint group properties made in the Properties bar will take effect.
Cancel – all changes of geopoint group properties made in the Properties bar during this session of the command work will be cancelled.
Description Key Sets and Description Keys
Description Key Sets
Sets of description keys are used to create and manage description keys.
Creating a Description Key Set

Command line: __aec_create_desckeyset
You can create a new set of description keys by selecting the Create item in the context menu of the Drawing Explorer – COGOPoints – Description Key Sets in the Drawing Explorer. Next, in the Properties bar, specify the set name and description.

Deleting a Description Key Set

Command line: __aec_delete_desckeyset
You can delete a description key set by selecting Delete from their own context menu in the Drawing Explorer.

Modifying a Description Key Set

Command line: __aec_modify_desckeyset
You can view and edit a description key set by selecting Modify in the context menu of the Drawing Settings – COGOPoints – Name of Description Key Set in the Drawing Explorer. Next, in the Properties bar, specify the set name and description.

Description Keys
Description keys are used to automatically control certain properties of drawing points, such as a point appearance in the drawing, when points are created or imported.
Each drawing description key is defined by its own set of properties.
Code property. Used when searching for a match against a description key. For example, if the code matches the raw point description, the properties defined in that description key will be applied to the
created point. The code may contain wild card characters that enhance the ability to match the description key. For more information, see the Description Key Code section.
Format property. Translates the raw description for a point into a full description. If the Format property is not set, the default value $* will be used. The value $* indicates that the raw and full descriptions are the same.
Styles are selected from preset styles. Layer – from one of those existing in the drawing.
Description keys are stored in a drawing as sets.
Creating a description key

Command line: __aec_create_desckey
You can create a new description key by selecting Create from the context menu of any description key set in the Drawing Settings Drawing Settings section of the Drawing Explorer.

Options:
| Code | This parameter determines which points can be matched to a given description key during description key matching. | |
|---|---|---|
| MarkerStyle | Specifies the marker style that will be indicated for points. | |
| LabelStyle | Specifies the label style that will be indicated for points that satisfy the description key code. | |
| Format | Specifies the format used to convert the raw description into a full description. Click the cell and enter the format. Enter $* if you want the full description to match the raw one. | |
| Layer | Used to specify the layer for the point. | |
| ScaleParameter | Defines the position in the raw description of the parameter that contains the value used to scale the point sign when the description key is matched. |
| FixedScaleFactor | Defines the fixed scale used to scale the point sign when the description key is matched. |
|---|---|
| ScaleXYApplied | If the description key matches, the scale of the description key will be applied to the X-Y axes passing through the point. |
| ScaleZApplied | When the descriptive key is matched, the scale of the description key will be applied to the Z axis through the point. |
Code of a Description Key
The Code property is used to define the raw descriptions that match the description key.
A description key consists of a code and a set of additional properties. If the code matches the raw description, the created point is characterized by other properties specified in the description key.
Below there are examples of description key codes:

You can specify a simple string as the description key code, or you can use wildcard characters, such as an asterisk (*), to expand the search options for matching the description key. When trying to create a second key with the code (*), a message appears asking you to enter a different value.
Below there is a table of wildcard characters used in description key codes:
| Character | Description |
|---|---|
| # | Matches any digital character. |
| @ | Matches any letter character. |
| Matches any character other than a letter or digit. | |
| * | Matches any sequence of characters; can be anywhere in the search string. |
| ? | Matches any single character (for example, for the search pattern ?BC, the string ABC would be the same as string 3BC). |
| ~ | Matches any string that does not contain the specified character sequence (for example, the wildcard ~AB will match strings that do not contain AB). |
| [] | Matches any character enclosed in parentheses (for example, [AB]C matches AC and BC). |
| [~] | Matches any non-bracketed character (for example, [~AB]C matches XC but not AC). |
| - | Matches any character in the specified range (for example, [A-G]C matches AC, BC,, GC, but not HC). |
|---|---|
| ’ | Performs an exact read of subsequent characters (for example, ‘*AB matches *AB). |
Below there is a table with examples of description key codes containing the most commonly used wildcard characters:
| Code | Description |
|---|---|
| T# | Matches descriptions consisting of T character followed by a digit (i.e., T1, T2,, T9). |
| STA# | Matches descriptions consisting of the string STA followed by a digit (i.e., STA1, STA2,, STA9). This pattern does not match the STA string because it is not followed by a digit. |
| T## | Matches descriptions consisting of T character followed by two digits (ie, T01,, T99). |
| 1@ | Matches descriptions consisting of 1 digit and a letter (for example, 1A, 1B and 1C). This pattern does not match 1 because it is not followed by a letter. |
| T. | Matches descriptions that consist T character followed by a character that is not a letter or number (for example, T- and T+). |
| T* | Matches descriptions consisting of T character followed by an arbitrary string (for example, T1, TOPO, T-2, and TREE). |
Deleting a description key

Command line: __aec_delete_desckey
You can delete a description key by selecting Delete from its own context menu in the Drawing Explorer.
Modifying a Description Key

Command line: __aec_modify_desckey
You can view and modify the description key settings by selecting Modify in the context menu of the section Drawing Settings – COGOPoints – Name of the Description Key in the Drawing Explorer. Next, in the Properties bar, you can view or modify the settings.

Creating surfaces
Triangular Irregular Networks (TIN) have been used in GIS for many years and are a way to digitally represent surface structure. TIN is a form of vector digital geographic data that is constructed by triangulating a set of vertices (points). The vertices are connected by a number of edges to form a network of triangles. There are various interpolation methods for forming these triangles, such as Delaunay triangulation.
The surfaces created can be represented by such objects as SubDMesh, PolyFaceMesh, a collection of Solids, or a collection of 3D Faces.
The properties of SubDMesh and PolyFaceMesh objects can be edited in the Properties bar. The Title and Description properties are available for editing. When copying an object, its Title and Description fields are also copied to the new object. The Number of vertices and Number of faces properties are informational.

Exploding a Cloud into Points


Command line: NG_EXPLODE_POINTCLOUD
The command allows you to create Points or Geopoints or Blocks objects based on the cloud points for further creation of TIN surface by them (for example, by the Create TIN by Points)command.
Before using the Explode the Cloud into Points command, run the Drawing Units command. In the Insertion scale section, set the value in meters.
If the number of points in the cloud is more than 100000, the cloud will be split into Points objects, even if COGOPoints or Blocks are selected in the parameters.
The command options are set in the Properties toolbar.
Options:
| Result type | Objects to be created based on the cloud points: Points, COGOPoints, Blocks. | |
|---|---|---|
| Delete source | If Yes is selected – the source point cloud will be deleted after the split is completed. No – the source point cloud remains in the drawing. | |
| Use class | If the cloud has been previously classified, it is possible to get only points of the specified class after splitting. |
Command prompts:
| Apply changes? | |
|---|---|
| [Yes/No]: |
Yes – split into points will be made with the current settings.
No – if the settings have been changed, they are not saved. Split into points will be made with the settings displayed immediately after starting the command.
Then the Explode dialog box appears.

If a Geopoint object is selected, the layers will be locked.

Options:


When splitting, a group with a name corresponding to the name of the cloud is created. After the cloud is broken down into points, the points take on the color of the cloud (the current cloud display mode).

Note
If a cloud being broken has more than 100000 points, the process may take a long time.
Create TIN by Points

The command creates a TIN (Triangular Irregular Network) surface – an irregular triangulation network by point objects represented by Points, Geopoints or Blocks. The following objects can be created: SubMesh, Polyface mesh, Solids or 3D Faces.

A set of points for creating a mesh can be obtained by importing from third-party formats or from a point cloud with the Explode the Cloud into Points command.
The command options are set on the Properties bar.
| Result type values | PolyFace mesh – creates an object of Polyface mesh type, the nodes of which can be edited; |
|---|---|
| SubMesh – creates an object of SubMesh type without the ability to edit nodes; | |
| Solids – will create a triangulation model consisting of separate triangle objects of Solid type; | |
| Faces – will create a triangulation model consisting of separate triangle objects of 3D Face type. |
| Filtrate source points | You can change the number of points that will be used to build create triangulation. To do this, select Yes for the Filtrate source point option, select the type of filtration for Filter Units parameters and set the desired value in the Filter range field. This will create a mesh with fewer number of larger triangles. This accelerates the process of creating a triangulation model. The created model will be less accurate, but its further processing will take less time. |
|---|---|
| The following filtration types are possible: | |
| • Points number – the number of points to be used to create a triangulation model. The total number of points can be determined by selectin all objects of Point (or Geopoint, Block) type by which triangulation will be created. | |
| • Percent of points number – the percent of points that will be used to create a triangulation model. It is convenient to use when you know the minimum percentage of points that allows you to build a mesh of acceptable quality; | |
| • Maximum error – the maximum distance in drawing units from the surface formed by the bulk of points, beyond which points will be excluded from triangulation. It is convenient to use for creating a triangulation mesh over the earth’s surface, automatically filtering out other objects: noises, trees, constructions, etc. | |
| Build boundary from convex hull | When this option is enabled, after creating the triangulation the mesh will be processed. Triangles with an edge length greater than the specified one will be removed. The length value is specified in the Max edge field. The length is specified as a percentage of the maximum edge units of the face in a triangulation model or in drawing units (based on the value of Max edge units parameters). |
| Max edge units | The length units for the Max edge parameter. Percentage of the units of the maximum face edge in the triangulation model or drawing units (set in the UNITS dialog). |
| Max edge | The maximum allowed edge length. All triangles with edges longer than this value will be removed from triangulation. A value of zero disables filtering by edge length. |
| The length is specified as a percentage of the max edge units of the face in the triangulation model or in drawing units (based on the value of the Max edge unit). | |
| Min triangle angle | The minimum angle in the triangle at which it will not be filtered. A zero value disables filtering by angle value. Triangles are filtered by plan angles, as other filtering options also operate plan length values |
| This parameter allows you to exclude extended triangles from triangulation. | |
| The value is specified in drawing angular units. If the drawing units are set to Degrees-minutes-seconds or Topographic units, the parameter value is measured in degrees. | |
| Min. triangles | The number of triangles that will be removed. When contouring, many small islands are created from several triangles. Islands with fewer triangles than the specified parameter will be removed. |
| Only external boundary | This option allows you to apply filtering not to the entire network, but only to triangles on its outer boundary. When this option is enabled, only triangles located on and adjacent to the boundary of the network will be removed during mesh processing |
|---|---|
| Filtering only on the boundary can be useful when, as a result of triangulation, the distant vertices of the mesh boundary are connected by edges, forming parasitic super elongated narrow triangles. | |
| Project points to UCS XY plane | When this option is enabled, the triangulation will be created in the XY plane of the user coordinate system. When the option is disabled, the triangulation will be created in the plane of the current view. |
| Select region | It is used when you need to build a model not by all points, but only by a certain part. In this case, click the button to the right of the Region is not selected value and draw a polygonal area within which the triangulation will be created on the point cloud. |
Generate normals
Shading parameter. Calculates normals at the mesh vertices, resulting in a smoother mesh appearance in the Precise view. The option is available only if a mesh is selected as the resulting triangulation object.


Generate per vertex colors
Colors the faces and vertices of the mesh according to the points color. The option is available only if a mesh is selected as the resulting triangulation object.

| Break for optimization | If the triangulation model turns out to be very detailed (millions of faces), then for the possibility of further convenient work, it will be divided into several meshes. If the parameter is disabled, the model will not be split, a single mesh will be created. |
|---|---|
| Filter by layer | The possibility to create a surface only by objects of a certain layer. When you select Yes in the drop-down list, it is necessary to specify the layer. |
| Create layer | When you select Yes, the mesh will be created on a new layer TIN surface. |
| Use Z coordinate from | The option is available if the TIN is based on geopoints. Specifies where to take the coordinate of the TIN vertices along the Z axis. Allows you to take the value from the point elevation (z-coordinate) or any custom attribute of the geopoint of the corresponding format, if any. A custom parameter appears in the replacement list only if all selected geopoints have a numeric value for this parameter. |
Command prompts:
Apply changes?
Yes – the command will be performed taking into account changes in settings made by the user in the current command session.
No – the command will be performed with the settings that displayed right after the command started.
Save – saving settings to the document.
saveDefault – saving settings to the register.
Importing Elevation Grid

Ribbon: Topoplan – Create TIN > Import elevation grid

Menu: Ground – Creating TIN > Import elevation grid

Toolbar: Creating TIN > Import elevation grid

Command line: NG_IMPORT_ELEVATIONGRID
To create surfaces in the module it is possible to load elevation grid files in PGM, GRD, ASC, DEM formats. As a result of the import, a surface is created in the form of a Mesh object.
After starting the command, a standard file selection dialog box will open. It is necessary to specify the file and click OK. The import dialog will open:

The command options are set in the Properties bar.
Options:
| Split mesh for optimization | If this option is enabled, for more convenient work the mesh will be split into several smaller objects. It is recommended to enable this option. |
|---|---|
| Convert to CS | If the elevation matrix was created in WGS-84 system, them its conversion is required to display in a drawing’s rectangular coordinate system. Possible variants: UTM (Universal Transverse Mercator), CK-42, CK-95. Also, it is possible Do not convert the elevation matrix, but it is recommended not to use this option. |
In case the command is performed successfully, the message will appear:
Import evaluation grid done!
Converting to Meshes or 3D Faces
There si a set of commands for changing the type of triangulation model created by such commands as Create TIN by Points. The type of created model can be converted to SubMesh (SubDMesh), Polyface Mesh (PolyFaceMesh) or a set of 3D Faces.


Converting Model to 3D Faces
Ribbon: Topoplan – Create TIN > Converting to 3D Faces
Menu: Ground – Creating TIN > Converting to 3D Faces
Toolbar: Creating TIN > Converting to 3D Faces
Command line: NG_TO_3DFACE
The command converts an object of SubMesh or Polyface mesh type to a set of 3D Face type objects.
Converting Model to SubMesh
Ribbon: Topoplan – Create TIN > Convert to Mesh
Menu: Ground – Create TIN > Convert to Mesh
Toolbar: Create TIN > Convert to Mesh

Command line: NG_TO_SUBDMESH
The command converts a set of 3D Face or Polyface Meshes type objects to one or several Submesh type object.
Command prompts:
Apply changes?
Yes – conversion will be performed with the current settings.
No – if the settings have been changed, they will not be preserved. Conversion will be performed with the settings that displayed right after the command started.
The command options are set in the Properties bar.
| Split mesh for optimization | Yes (recommended) – the SubMesh obtained from the selected objects will be exploded to several smaller meshes for further comfortable work. The explosion criteria are set by the Split meshes by topology option. No – a single mesh will be created from the selected objects without splitting to parts. |
|---|---|
| Split meshes by topology | A method of exploding a mesh into smaller meshes: • Yes – split a mesh into parts taking into account both topology (Maximum difference of normals in mesh option), and limitations (no more than 500000 faces). • No – split only on the basis of limitations (no more than 500000 faces). |
| Maximum difference of normals in mesh (degrees) | The maximum allowable deviation of the normal of a mesh element from its average normal (in degrees), at which the element will be considered to belong to this mesh. The normals of elements in each part, into which a single mesh will be split, should not differ by more than a given value. The option determines the number of pieces into which the mesh will be split, if the Split meshes by topology option is set to Yes. |
| Vertex tolerance | Accuracy parameter within which closely located nodes (vertices) of objects will be combined during conversion. For example, the vertices of neighboring faces may not match within 1e-0.4, but with the Vertex tolerance value equal to 1e-0.2 such vertices will be merged into one. |
Converting Model to Polyface Mesh
Ribbon: Topoplan – Create TIN > Converting to POLYFACEMESH
Menu: Ground – Creating TIN > Converting to POLYFACEMESH
Toolbar: Creating TIN > Converting to POLYFACEMESH
Command line: NG_TO_POLYFACEMESH
The command converts a set of 3D Face or SubMesh type objects to one or several Polyface mesh type objects.
Command prompts:
Apply changes?
Yes – conversion will be performed with the current settings.
No – if the settings have been changed, they will not be preserved. Conversion will be performed with the settings that displayed right after the command started.
The command options are set in the Properties bar.
| Split meshes by topology | A method of exploding a mesh into smaller meshes: |
|---|---|
| • Yes – split a mesh into parts taking into account both topology (Maximum difference of normals in mesh option), and limitations (no more than 32767 faces and vertices). | |
| • No – split only on the basis of limitations (no more than 32767 faces and vertices). | |
| Maximum difference of normals in mesh (degrees) | The maximum allowable deviation of the normal of a mesh element from its average normal (in degrees), at which the element will be considered to belong to this mesh. |
| The normals of elements in each part, into which a single mesh will be split, should not differ by more than a given value. | |
| The option determines the number of pieces into which the mesh will be split, if the Split meshes by topology option is set to Yes. | |
| Vertex tolerance | Accuracy parameter within which closely located nodes (vertices) of objects will be combined during conversion. |
| For example, the vertices of neighboring faces may not match within 1e-0.4, but with the Vertex tolerance value equal to 1e-0.2 such vertices will be merged into one. |
Converting a Mesh, a Polyface Mesh and 3D Faces into a TIN Surface
Ribbon: Topoplan – Create TIN > Convert a Mesh, a Polyface Mesh and 3D Faces into a TIN Surface
Menu: Topoplan – Create TIN > Convert a Mesh, a Polyface Mesh and 3D Faces into a TIN Surface
Toolbar: Create TIN > Convert a Mesh, a Polyface Mesh and 3D Faces into a TIN Surface
Command line: NG_CONVERT_TO_SURFACETIN
The command converts objects of Mesh, Polyface Mesh and 3D Faces into a TIN Surface object.
Command prompt:
Select objects or [?] Select one or more objects to convert.
The command options are specified in the Properties bar.
Options:
| Delete source object | Possibility to choose whether or not to delete the source objects. |
|---|---|
| ---------------------- | -------------------------------------------------------------------- |
Converting a TIN Surface into a Mesh, a Polyface Mesh and 3D Faces
Ribbon: Topoplan – Create TIN > Convert a TIN Surface into a Mesh, Polyface Mesh and 3D Faces
Menu: Topoplan – Create TIN > Convert a TIN Surface into a Mesh, Polyface Mesh and 3D Faces
Toolbar: Create TIN > Convert a TIN Surface into a Mesh, Polyface Mesh and 3D Faces
Command line: NG_CONVERT_FROM_SURFACETIN
The command converts a TIN Surface into Mesh, Polyface Mesh, 3D Faces objects.
The command options are specified in the Properties bar.
Options:
| Save result as | Selection of what type of objects to convert to. When selecting Mesh or Polyface Mesh objects, additional options appear. |
|---|---|
| Delete source | Possibility to choose whether or not to delete |
| object | the source objects. |
The convertion to SubMesh is selected.
| Break SubMesh | If this parameter is enabled, the resulting mesh will be split into several smaller |
|---|---|
| for optimization | objects for more convenient work. It is recommended to enable this option. |
1670
Break meshes by topology
Method of splitting a mesh into smaller meshes:
- Yes split the mesh into pieces taking into account both the topology (the Maximal normals difference in mesh option) and the restrictions (no more than 32767 faces and vertices).
- No split only based on the restrictions (no more than 32767 faces and vertices).
Maximal normals difference in mesh (degrees)
The maximum permissible deviation of the normal of a mesh element from its average normal (in degrees), at which the element will be considered to belong to this mesh.
The normals of the elements in each part into which a single mesh is split should not differ by more than this value.
The option determines the number of pieces into which the mesh will be split if the Break meshes by topology parameter is set to Yes.
Tolerance for vertexes
The precision parameter within which closely located nodes (vertices) of objects will be merged during conversion.
For example, the vertices of adjacent faces may not coincide within 1e-0.4, but if the Tolerance for vertices parameter is 1e-0.2, such vertices will be merged into one.
The convertion to Polyface Mesh is selected.
Break meshes by topology
Method of splitting a mesh into smaller meshes:
- Yes split the mesh into pieces taking into account both the topology (the Maximal normals difference in mesh option) and the restrictions (no more than 32767 faces and vertices).
- No split only based on the restrictions (no more than 32767 faces and vertices).
Maximal normals difference in mesh (degrees)
The maximum permissible deviation of the normal of a mesh element from its average normal (in degrees), at which the element will be considered to belong to this mesh.
The normals of the elements in each part into which a single mesh is split should not differ by more than this value.
The option determines the number of pieces into which the mesh will be split if the Break meshes by topology parameter is set to Yes.
Tolerance for vertexes
The precision parameter within which closely located nodes (vertices) of objects will be merged during conversion.
For example, the vertices of adjacent faces may not coincide within 1e-0.4, but if the Tolerance for vertices parameter is 1e-0.2, such vertices will be merged into one.
Tools to Work with Surfaces
The surfaces are automatically created according to the Delaunay triangulation rules. Therefore, after creating a TIN, it is often required to edit some areas. Also, in the process of working with relief, sometimes the task of clarifying the surface arises. To do this, the surface editing functionality is used.
To work with surface editing commands, it is recommended to enable shaded visual styles: 3D Flatshaded with edges, 3D Gouraud-shaded with edges.
Flipping an Edge
Ribbon: Topoplan – Modify TIN > Flip Edge
Menu: Ground – Editing TIN > Flip edge
Toolbar: Editing TIN > Flip edge
Command line: NG_MESH_FLIP The command changes the edge position between two triangulation faces in the surface model
(SubMesh or Polyface mesh); it can be performed, for example, to turn edges along the slope crest, road side, etc.
When you run the command, an object snap is enabled, and then you should specify an edge for a flip.
When you hover the cursor over the mesh, two adjacent triangles the position of face between which will be changed are highlighted in red. A click on the face flips the edge.
Surface before flip Surface after flip


The position of several faces can be subsequently changed. Pressing ESC ends the command.
Deleting an Edge
Ribbon: Topoplan – Modify TIN > Delete Edge
Menu: Ground – Editing TIN > Delete Edge
Toolbar: Editing TIN > Delete Edge

Command line: NG_MESH_EDGE_DELETE
Using the command, you can delete edges of Submesh or Polyface mesh surface. Usually, it is used to delete “long” edges along the mesh boundary for correct contouring.

Note
Since a TIN surface has triangle faces, deletion of edges will result in deletion of faces that contained them.
Command prompts:
Specify opposite corner or [Edge]:
Use the frame to select one or more edges to delete. This command mode is enabled by default.
Edge – when this option is selected, the command switches to the mode of sequential (one at a time) specifying edges to be deleted.
Specify edge to delete or [Frame]:
Frame – return to selecting edges with a frame.
Faces that will be deleted when deleting edges

Surface after deleting edges

Several edges can be deleted in succession. Pressing ESC button ends the command.
The command is also used to delete faces inside water reservoirs to exclude the construction of contours along the reservoir.
Faces passing along the water surface Faces are deleted


Adding a Vertex
Ribbon: Topoplan – Modify TIN > Add vertex
Menu: Ground – Editing TIN > Add vertex
Toolbar: Editing TIN > Add vertex
Command line: NG_MESH_VERTEX_ADD
The command adds a new vertex to the existing surface (Submesh or Polyface mesh). The position of the contour lines is also updated if they were built.
To add a vertex:
-
- Set the Top View.
-
- Run the command.
-
- In response to the prompt in the command line, select Submesh or Polyface mesh:
Specify new vertex position
- Click cursor inside a mesh triangle to add a new vertex in the specified place. A vertex can be added with a reference to some objects. If the point is inside the triangle, then the triangle outline + green point is highlighted. If the point is on the edge, then the triangle outline + edge + red point is highlighted.
Point inside the triangle Point on the edge


- Select whether to project the point onto the surface or use its actual height after specifying. The anchor point elevation is 0.00. The elevation of the point projected onto the surface is 193.62. Specify vertex elevation <193.62> or [Snap/Project]: Project
Surface before adding a vertex Surface with added vertex


-
- If a point is specified outside the existing mesh, it can be added to the mesh. The command finds the extension of the plane of the nearest triangle to the specified external point and constructs a projection onto this plane.
-
- Several vertices can be added in succession. Pressing ESC button ends the command.
The point is projected onto the surface in the view direction, the mark is the Z coordinate of the UCS. If the view direction does not coincide with the Z axis of the UCS, a warning is displayed.
***Warning! The current view direction does not coincide with the Z axis. You may get unexpected results.***
Deleting a Vertex
Ribbon: Topoplan – Modify TIN > Delete Vertex
Menu: Ground – Editing TIN > Delete Vertex
Ribbon: Editing TIN > Delete Vertex
Command line: NG_MESH_VERTEX_DELETE
The command deletes a vertex from an existing surface (Submesh or Polyface mesh) and rebuilds triangulation. The position of the contour lines is also updated if they were built.
The vertex to be deleted is highlighted in red.

To delete a vertex:
-
- Run the command.
-
- In response to the prompt in the command line:
Select vertex to delete
Select a vertex. The selected vertex is deleted, and the triangulation mesh is rebuilt.
Select vertex to delete or [Frame]: Frame
Specify first corner or [Vertex]:
Specify opposite corner or [Vertex]:Select an area with a frame. The selected vertices will be deleted and the triangulation network will be rebuilt.
Surface before deleting the vertex Surface after deleting the vertex

- Several vertices can be deleted in succession. Pressing ESC button ends the command.
Changing Elevation



Command line: NG_MESH_VERTEX_MOVE_H
The command changes elevation (Z coordinate) of a node of an existing surface (Submesh or Polyface mesh) and rebuilds triangulation.
To change elevation:
-
- Run the command.
-
- In response to the prompt in the command line:
Select vertex to change elevation
select a vertex. When you hover the cursor over the mesh node, it is highlighted in red.
- After specifying the node, the prompt follows:
Elevation of this vertex is 200.36. Specify new elevation.
where 200.36 value is the node elevation. You need to enter a new elevation in the drawing units and press ENTER.
The surface vertex whose elevation should be changed
Surface after changing the vertex elevation


- Elevations of several vertices can be changed in succession. Pressing ESC button ends the command.
Moving a Point



Command line: NG_MESH_VERTEX_MOVE
The command moves a point in an existing surface (Submesh or Polyface mesh) and rebuilds the triangulation. The movement takes place in the XY plane.
To move a point:
-
- Run the command.
-
- In response to the prompt in the command line select a vertex. When you hover the cursor over the mesh node that will be selected for moving, it is highlighted in red.
Select vertex to move
- Click the cursor to add a new point at the specified location. A point can be added with reference to any objects of the situation
Pick new vertex position
- Choose whether to project the point onto the surface or use its actual height after specifying.
Osnapped UCS elevation is 193.01. Mesh UCS elevation is 193.57. Specify vertex UCS elevation <193.57> or [Osnapped/Mesh]:
The point’s elevation is the Z coordinate of the UCS. If the view direction is not aligned with the Z axis of the UCS, a warning is displayed.
*** Warning! The current view direction is not aligned with the Z axis. You may get unexpected results.***

Node whose position should be moved The node position has been changed

- Several vertices can be moved in succession. Pressing ESC button ends the command.
Adding Structure Line



Command line: NG_MESH_STRUCTURAL_CREATE
The command adds a new structure line or a retaining wall to the existing surface.
Structure lines are used to detail relief forms. Such lines can describe lines of curbs, pavement boundaries, gulleys, watersheds, etc. When there are structure lines present, the surface triangulation is forced along the structure line; triangulation edges cannot intersect a structure line. When selecting intersecting objects, only one breakline will be created. Types of objects that can be added as structure lines: lines, polylines, 3D polylines.
The command supports multiple selection.
The command options are set in the Properties bar.
| Structural type | Type of structure line: Standard or Retaining wall. |
|---|---|
| Project profile on | The parameter is used for the standard structure line. |
| • WCS – the polyline will be projected onto the XY plane of the world coordinate system; | |
| • UCS – the polyline will be projected onto the XY plane of the custom SC; | |
| • Viewport – the polyline will be projected onto the viewport plane. |
| Get Elevation from | The parameter is used for the retaining wall. |
|---|---|
| Specify the source of marks: | |
| • Structural Line – marks will be taken from the line specified when drawing. To obtain a polyline with surface elevations, you can use the Draw structure line or Project line to mesh. | |
| • Surface – the command will project a line onto a surface and take marks from the surface. | |
| Set Wall Height | A method to specify the height of the retaining wall: |
| • Separately – during construction, the height of the wall for each vertex of the line will be requested. | |
| • Common – constant height, defined by the Common Wall Height parameter. | |
| Common Wall Height | Uniform wall height for the case when the Set Wall Height – Common. The height can be positive or negative. |
| Type of work (for closed contours) | The parameter is available if a closed polyline is selected: • Saving internal points – surface points that fall inside the closed line will be saved. |
| • Removing internal points – surface points that fall inside the closed line will be removed, and the surface will be rebuilt. | |
To add a structure line:
-
- Run the command.
-
- Set the parameters in the Properties bar. The Structural type should have the Standard value. Press ENTER in response to the prompt in the command line:
Apply changes?
- In response to the prompt
Select polyline or line to be added as structural line or [?]:
specify a line, polyline or 3d polyline. After selecting an object by the cursor, triangulation will be rebuilt.

Surface before adding a structure line Surface after adding a structure line

To add a Retaining wall structure line:
-
- Run the command.
-
- Configure the parameters in the Properties bar. The Structure type should have the Retaining will value. Press ENTER in response to the prompt in the command line:
Apply changes?
- In response to the prompt
Select polyline or line to be added as a structural line or [?]:
specify a line, polyline or 3d polyline.
- In response to the prompt
Specify the side of the wall offset:
specify the slope side.
- If the Set the wall height parameter was set to Separate vertices, then specify the wall height for each line vertex. The current vertex is indicated by a red circle.
The mesh triangulation will be rebuilt. The retaining wall is always vertical in the World coordinate system.


The command supports multiple selection.
Adding an Edge




The command adds a new edge to an existing surface (Mesh or Polyface Mesh) on its boundary.
The edge can only be added on a non-convex boundary (internal or external) so that a new triangular face can be created without breaking the 2.5D mesh.

The position of several edges can be changed sequentially. Pressing the ESC key terminates the command.
Mesh Sealing Holes
Ribbon: Topoplan – Modify TIN > Mesh Seal Holes
Menu: Topoplan – Modify TIN > Mesh Seal Holes
Toolbar: Modify TIN > Mesh Seal Holes
Command line: NG_MESH_SEAL_HOLES
If during the creation of a TIN surface or in the process of its editing surface holes were formed, the command allows filling them with missing faces by specifying an edge on the hole boundary.


Adding a group of Points



Command line: NG_MESH_VERTEX_ADD_BY_POINTS
The command adds a group of points (geopoints, blocks) to the surface.
To add a group of points:
-
- Select one surface.
-
- In response to a prompt on the command line -
Select point type or [Points/COGOPoints/Blocks]: select the type of points.
- In the Properties bar, configure the command parameters

| Addition type | Project on mesh – Project points of the mesh surface. | ||
|---|---|---|---|
| By point – take current coordinates without projection. | |||
| Elevation source | The parameter is available when selecting the By point addition type | ||
| Selection of the elevation source. | |||
| For points: | |||
| – Position | |||
| For COGOPoints: | |||
| – Position | |||
| – Custom property | |||
| For blocks: | |||
| – Position | |||
| – Attribute | |||
| Projection | The direction in which points will be projected onto the surface (WCS, UCS or Viewport). | ||
| Update points | The data of the point to be updated. | ||
| No – we change the surface, but do not change the starting points. | |||
| Position – we change the surface, as well as the position of the points to a new one, projected onto the surface. | |||
| Add outside the mesh | Points whose projection does not fall on the mesh will be added to the mesh. |
Adding Drawing Objects
Ribbon: Topoplan – Modify TIN > Adding Drawing Objects
Menu: Topoplan – Modify TIN > Adding Drawing Objects
Toolbar: Modify TIN > Adding Drawing Objects
Command line: NG_MESH_ADD_OBJECTS
The command adds data from selected objects (points, lines, blocks, texts, 3D faces, polygons) to an existing surface. The selected objects are interpreted based on the points of these objects; for each type of object added to the surface, point data related to that type is created. For some object types (lines, 3D faces, and polygons), you can specify whether to preserve the edge configuration of the object when adding the object’s points. The drawing objects are added to the surface as point data.
The command options are set in the Properties bar.
Parameters:
| Types of objects to be added | Specifies the type of object to be added. Points - uses the XYZ coordinates of the object. Lines - uses the XYZ coordinates of the object’s endpoints. Blocks - uses the XYZ coordinates of the block’s insertion point. Text - uses the XYZ coordinates of the text insertion point. 3D Faces - uses the XYZ coordinates of the object’s endpoints. Polygon - uses the XYZ coordinates of the object’s endpoints. |
|---|---|
| Save the configuration of the edges of the objects | Specifies whether to define triangulation edges based on edges defined in the source object. This option is available when line segments, 3D Faces, and Polyhedra are selected. |
Adding a 3D Slope to a Surface

Menu: Topoplan – Modify TIN > Adding a 3D Slope to a Surface
Toolbar: Modify TIN > Adding a 3D Slope to a Surface
Command line: NG_MESH_ADD_3D_SLOPE
The command adds a 3D slope object to an existing surface.
The command parameters are set in the Properties bar.

| Type of slope | Selects the type of slope: Excavation, Embankment. | ||
|---|---|---|---|
| Calculate the slope area | Calculates the slope area. If Yes is selected, an additional item appears – Save result as. | ||
| Save result as | Saves the calculation result to the selected surface. During the command execution: a Mesh or Polyface Mesh can be created. |
Command prompts:
| Select slopes or [?]: Specify slopes on the screen. |
|---|
| ----------------------------------------------------------- |
Apply changes [Yes/No/Save/saveDefault]
Yes – the command will be performed taking into account the changes to the settings made by the user in the current session of the command.
No – the command will be performed with the settings that were displayed immediately after the command was launched.
Save – saving the settings to the document.
saveDefault – saving the settings to the registry.
Mesh Boundary
Ribbon: Topoplan – Modify TIN > Boundary Mesh


Menu: Ground – Editing TIN > Boundary Mesh


Toolbar: Editing TIN > Boundary Mesh

Command line: NG_MESH_BOUNDARY
The command purpose is to remove faces with edges of a certain length, which can prevent from the correct construction of contours.
Preliminary actions
Before running the command it is necessary to define the length of edges. Measurement can be performed by the Distance between points (DIST) command. To do this, run the command with the enabled ENDpoint snap and make measurement. In this case, the obtained distance values will be displayed in the Properties toolbar:

Mesh Boundary
The command options are set on the Properties bar.
Options:
| Only external boundary | Yes – changes will only affect the outer triangles. When you specify No, triangles inside a mesh can be changed. | |
|---|---|---|
| Maximum edge length | It is necessary to specify a value slightly less than that measured by the Distance between points (DIST) command. | |
| Edge units | Length units – specifies that the value in the Maximum length field is set in the drawing units (meters). Percent – specifies that the value in the Maximum length field is set as percentage. | |
| Project points to UCS XY plane | To define what triangles should be removed, lengths of edge projections are compared with the Maximum length. If specify No, projections to the | |
| plane of the current view will be used. If specify Yes, lengths of projections to UCS XY plane will be compared. |
Command prompts:
Apply changes [Yes/No/Save/SaveDefault]
Yes – mesh boundaring will be performed with the current settings.
No – if settings have been changed, they are not saved. Boundaring will be performed with the settings that were displayed immediately after running the command.
Edge that prevents from the correct construction of contours

Result of the mesh boundaring

Mesh Sealing Holes

Ribbon: Topoplan – Modify TIN > Mesh Seal Holes
Menu: Topoplan – Modify TIN > Mesh Seal Holes
Toolbar: Modify TIN > Mesh Seal Holes

Command line: NG_MESH_SEAL_HOLES
If during the creation of a TIN surface or in the process of its editing surface holes were formed, the command allows filling them with missing faces by specifying an edge on the hole boundary.

Simplifying the Mesh
Ribbon: Topoplan – Modify TIN > Simplifying the Mesh
Menu: Topoplan – Modify TIN > Simplifying Mesh
Toolbar: Modify TIN > Simplifying the Mesh

The Simplifying the Mesh command performs triangulation network optimization. The optimization goal is to obtain a more sparse mesh that retains its form.

The command options are set in the Properties bar.
Options:
| Target (faces) | Number of faces in the optimized mesh. | ||
|---|---|---|---|
| Percent | Percentage of the number of edges in the optimized network compared to the original number of edges. | ||
| The right edge of the slider can be moved, changing the percentage and number of target faces along with it. | |||
| Erase Source | Delete the source mesh or not. |
| Boundary Weight | The coefficient that determines the degree of identity of the edge before and after mesh simplification. |
|---|---|
| The parameter values range from 0 to the infinity. The more the value is, the more detailed the mesh will be on its boundaries, and the less will be the deviation of edge of the optimized mesh from its previous position. When the value = 0, the mesh boundary looks “ragged”, the mesh edge is rough. Too large value would lead to excessive detailing of the mesh edge and increased optimization time. Optimal value = 1. | |
| Preserve Topology | Allows you to create a mesh without self-intersections of faces, which may occur as a result of its optimization. The parameter value should |
| always be Yes. | |
| Generate Normals | Whether to create vertex-by-vertex normals. It is used for improved display of a mesh. |
| The default value is Yes. | |
| Face Quality | Whether to strive to create a mesh with faces close to equilateral triangles. |
| When the option is disabled, narrow faces with very long edges can be created. | |
| The default value is Yes. | |
| Ignore Texture | Optimizes a mesh without saving its texture, if any. The default value is Yes. |
| In most cases the option should be enabled, i.e. a mesh should be optimized without saving its texture. In this case the existing texture will be distorted, therefore, at the end of optimization, to re-overlay texture use the Texture Atlas Overlay command. | |
| Optimization in the texture saving mode is performed with less quality, than in ignoring mode. It makes sense to optimize a mesh with saving texture in such rare cases, when you need to have texture on the mesh, but it is not possible to restore the texture by point cloud (for example, there is no point cloud by which the mesh was created). |
Cutting Mesh
Ribbon: Topoplan – Modify TIN > Cut Mesh
Menu: Ground – Editing TIN > Cut Mesh
Toolbar: Editing TIN > Cut Mesh
Command line: NG_MESH_CUT
The command’s purpose is to split a mesh into divisions.
The command options are set on the Properties bar.
Options:
| Save result as | Influences on objects that will be created in the process of performing the command: a Submesh or Polyfacemesh can be created. | |
|---|---|---|
| Delete source mesh | Yes – as a result of the command, several meshes will be created, and a source mesh will be deleted. | |
| No – as a result of the command, several meshes will be created, while the source mesh will also remain in a drawing. | ||
| Specify closed contour | onScreen – after changes are applied, indicate the nodes of cutting contour with the cursor; | |
| Selection – for cutting, select a previously prepared closed polyline in a drawing; | ||
| Profile – indicate by the cursor the nodes in a drawing with possibility to extend the cutting profile to the mesh edges (Extendall option) or to close (Close option; if this option is selected, the result will be similar to selecting the onScreen option). |
Command prompts:
Apply changes
Yes – cutting will be performed with the current settings.
No – if settings have been changed, they are not saved. Cutting will be performed with the settings that were displayed immediately after running the command.
Classification Mesh
Ribbon: Topoplan – Modify TIN > Classification Mesh

Menu: Ground – Editing TIN > Classification Mesh
Toolbar: Editing TIN > Classification Mesh
Command line: NG_MESH_CLS
The command is used to divide the mesh into classes: for example, if you want to separate the road surface from the lawn. For classification, in the drawing it is necessary to create polylines (necessarily closed), along which the mesh will be cut. After the mesh is classified, the resulting areas can be decomposed into layers to control the display (you can adjust the visibility, color, transparency, etc.)
The command options are set on the Properties bar.
Options:
| Project profile on | Determines how the polyline cutting the mesh will be projected on it: | ||
|---|---|---|---|
| WCS – on XY plane of the world coordinate system. | |||
| UCS – on XY plane of the user coordinate system (if available in the drawing). | |||
| Viewport – on the viewport plane. | |||
| Save result as | The option influences on objects to be created in the process of performing the command: a Submesh or Polyfacemesh can be created. |
Command prompts:
Apply changes
Yes – a triangle with the specified edge length will be deleted with the current settings.
No – if settings have been changed, they are not saved. A triangle with the specified edge length will be deleted with the settings that were displayed immediately after running the command.
Mesh before classification Mesh after classification


Combining Surfaces
Ribbon: Topoplan – Modify TIN > Combining surfaces
Menu: Topoplan – Modify TIN > Combining surfaces
Toolbar: Modify TIN > Combining surfaces

Command line: NG_MESH_JOIN
The command combines two surfaces into one by rebuilding triangles on the surface boundary.
The command parameters are set in the Properties bar.

| Type of work | Exclusive scenario – As a result of the action, a single triangulation is built, including all triangles from both groups that do not overlap. If the triangles overlap, then only triangles from the secondary network are included in the new grid. |
|---|---|
| Additive scenario – As a result of the action, a single triangulation is built, including all triangles from both groups. If the triangles do not overlap, then additional connecting triangles should be created between them, connecting the two triangulations into one. If the triangles overlap, then in the overlap zone, the triangulation is built according to the rule - if a point forming a triangle from the secondary triangulation falls into the field of a triangle from the main triangulation, then it is included in the triangulation according to the point addition algorithm. | |
| Adding new edges | Yes – Add edges. No – Do not add. |
| Delete source meshes | Yes – Delete source mesh. No – Do not delete. |
You can combine several surfaces in sequence. Pressing the ESC key terminates the command .

Note
Combining meshes with structural lines will be implemented in the next version.
Tools to Work with Relief Elements
Constructing Contours

Ribbon: Topoplan – Relief> Constructing Contours
Menu: Ground – Elevation > Constructing Contours

Toolbar: Elevation > Constructing Contours

Command line: NG_CREATE_CONTOUR_LINE
Constructing contours. Contour lines are constructed on the base of Submesh or Polyfacemesh objects Contours are divided into several types:
- Intermediate contour lines;
- Index contour lines;
- Supplementary contour lines (semi-contours). Are built on half of section of intermediate contour lines;
- Auxiliary contour lines. Are built with an arbitrary section, the value of which is set by the Interval parameter.
The command options are set on the Properties toolbar.
Common parameters for all contour lines:
| Delete existing contours | If contours are present in a drawing and they should be constructed anew – specify Yes. | |
|---|---|---|
| When you specify No, old contours are preserved. | ||
| Create contours layer | If you specify Yes, new contours will be created in the new Contour lines layer. | |
| In case of No , contours will be created in 0 layer. | ||
| Contours smoothing | No – contours consisting of straight segments will be built. | |
| Yes– constructing smoothed contour lines with a controlled degree of smoothness. It is recommended to use this way of smoothing (Bezier Interpolation). | ||
| Smoothness level | The higher the value, the smoother the contour lines will be. | |
| The parameter is displayed when the Yes value is set for the Contours smoothing parameter. | ||
| Avoid contours crossing | It is recommended to specify Yes, so that in case of complex relief not to build crossing contours. But this slows down the construction of contours, and in case of a smooth relief, it’s better not to enable this parameter. | |
| The parameter is displayed when the Yes value is set for the Contours smoothing parameter. |
Specific options for each type of contour lines:
| Section height | Parameter for Intermediate contour lines type of contours. | |
|---|---|---|
| It is set in meters depending on the scale of the created plan. |
| Contour interval | Parameter for Index contour lines and Auxiliary contour lines type of contours. Section height. It is set in meters depending on the scale of the created plan. |
|---|---|
| Drawing | Parameters for Supplementary contour lines and Auxiliary contour lines type of contours. |
| If you specify No – this type of contour lines will not be built. All – will be built for the entire mesh. Specify area – after applying the parameters, by the cursor specify the area inside of which these contours will be built. |
Command prompt:
Apply changes [Yes/No/Save/saveDefault]
Yes – contours will be built with the current settings.
No – if settings have been changed, they are not saved. Contours will be built with the settings that were displayed immediately after running the command.
Creating Contour Lines from Objects

Menu: Topoplan – Relief > Creating Contour Lines from Objects
Toolbar: Relief > Creating Contour Lines from Objects
Command line: NG_MARK_AS_CONTOUR
The command converts polylines and 3D polylines into contours.
The command parameters are set in the Properties bar.

| Set new color | The default value is No. The color of the created contours will be taken from the object. If Yes is selected, the Contour color parameter appears. |
|---|---|
| Contour color | Selecting the contour color. |
Deleting Contour Lines
Ribbon: Topoplan – Relief > Delete Contour Lines
Menu: Topoplan – Relief > Delete Contour Lines
Toolbar: Relief > Delete Contour Lines
Command line: NG_DELETE_CONTOUR_LINE
The command has no settings. When it is launched, all contours, berghashes and contour labels are deleted.
Creating Bergstriches
Ribbon: Topoplan – Relief > Bergstriches
Menu: Ground – Elevation > Bergstriches
Toolbar: Elevation > Bergstriches
Command line: NG_CREATE_BERGSTRICH
The command will create a bergstrich (in the form of block) at the specified location of the contour.
Contours must first be built and the scale of the topographic map selected.
The command parameters are set in the Properties bar.

| Bergstrichs block | Selecting a block for the Bergstrichs. CONTOUR_BERG – The CONTOUR_BERG block is used. Add from existing blocks – After applying the settings, opens the Choose Block dialog box, where you should select the desired block. |
|---|---|
| Select arrangement mode | Auto – Bergstrichs are placed automatically. The cursor indicates points along the line intersecting the contours, and labels are placed along it. By hand – Bergstrichs are placed manually. The cursor indicates the position of the bergstrich at the specified place on the contour. |
To create a bergstrich:
-
- Run the command.
-
- In response to the prompt in the command line
Specify bergstrich position:
click the left mouse button in the required place on the contour line.

-
- In the specified place bergstrich will be created in form of block named CONTOUR_BERG.
-
- Several bergstriches can be created in succession. Pressing ESC button ends the command.
Creating Contour Lines Labels

The command creates a label automatically or at the specified location of the contour.
The command parameters are set in the Properties bar.

| Text style | Selecting the text style. | |
|---|---|---|
| Text height | Specifying the text height. | |
| Select arrangement | Auto – Labels are placed automatically. The cursor specifies points along the line intersecting the contours, and labels are placed along it. | |
| mode | By hand – Labels are placed manually. The cursor specifies the position of the label in the specified place on the contour. | |
| If you specify Auto, an additional parameter appears: Set labels on index isolines only. | ||
| Set labels on index isolines only | With this parameter enabled, labels are placed only on index isolines. |
Contours must first be built and the scale of the topographic map selected.
To create labels for contour lines:
-
- Run the command.
-
- If 3D visual style was set in a drawing, then a warning message appear at the command launch with the proposal to switch to 2D render mode. Agree for the right display of label elements.
-
- In response to the prompt
Specify position (s) of contour elevation label(s) and press Enter:

click on the contour line with enabled snap to create the Mtext object on the Contour lines layer with the enabled Hide background parameters to hide a contour area in the text insertion point.
It is not necessary to use an object snap: a label will be created on the contour line nearest to the cursor.
- Several labels can be created in succession. Pressing ESC button ends the command.
2D Slope
Ribbon: Topoplan – Relief > 2D Slope
Menu: Topoplan – Relief > 2D Slope
Toolbar: Relief > 2D Slope
Command line: NG_CREATE_SLOPE
The command makes it possible to build various types of signs for slopes, cliffs, retaining walls:
• Unfortified slope;
• Fortified slope;
• Steep coast with a beach;
• Steep coast without beach;
• Stone retaining walls;
• Wooden retaining walls;
• Ground cliff.

Before starting execution, the command checks the set topographic scale and offers to switch to the 2D Wireframe visual style.
| М | 1:500 | М | 1:1000 |
|---|---|---|---|
| М | 1:2000 | М | 1:5000 |
After running the command, set the slope type and characteristics in the Properties bar. The options vary depending on the type of slope and the way the edge is specified.
Options:
| Slope sign | Selecting the slope type: | ||
|---|---|---|---|
| • Unfortified slope; | |||
| • Fortified slope; | |||
| • Steep coast with a beach; | |||
| • Steep coast without beach; | |||
| • Stone retaining walls; | |||
| • Wooden retaining walls; | |||
| • Ground cliff. | |||
| Specify slope edges | Selecting the method for specifying the location of the slope in the drawing: | ||
| • onScreen – slope boundaries should be drawn manually on the screen; | |||
| • Selection – line objects that will define the lower and upper edge of the slope should be selected in the drawing field. | |||
| The top and bottom slope edges can be closed lines. | |||
| Smooth top of slope | Specify whether the top of the slope should be drawn from point to point as a polyline or a smooth line. |
|---|---|
| The parameter is available for certain slopes, when the method for specifying the slope edge is onScreen. | |
| Smooth bottom of slope | Specify whether the bottom of the slope should be drawn from point to point as a polyline or a smooth line. |
| The parameter is available for certain slopes, when the method of specifying the slope edge is onScreen. | |
| Draw bottom line | Specify whether the bottom slope line is required. |
| The parameter is available for certain slopes, when the method of specifying the slope edge is Selection. | |
| Layer of slope | The layer on which the slope should be placed. |
Apply changes?
Yes – slope, cliff or retaining wall will be created with the current settings.
No – if the settings have been changed, they will not be saved. The slope will be created with the settings displayed immediately after running the command.
Specify points of slope top or [Peak]:
Specify the first point of the top edge of the slope, or select the Peak option to build the slope from a single top point (hill).
Specify slope peak point:
Specify a slope peak point to build a slope from one top point (hill).

Specify points of slope top or [Undo/ClosePeak]:
Specify the second and subsequent peaks of the slope top.
Undo – undo the entry of the last specified peak.
ClosePeak – close the line of the slope top.
Specify points of bottom slope or
Specify vertices of the slope bottom.
[Undo/Close]: Undo – undo the entry of the last specified vertex. Close – close the line of the slope bottom. Select top slope polyline or [?]: Specify a polyline on the screen to build the top edge of the slope based on it. Select bottom slope polyline or [?]: Specify a polyline on the screen to build the bottom edge of
the slope based on it.
To create a slope, cliff, retaining wall:
-
- Set the desired topographic scale and switch to the 2D Wireframe visual style.
-
- Run the command.
-
- Set the slope type and characteristics on the Properties bar. The options vary depending on the type of slope and how the edge is specified.
-
- Specify the location of the slope on the drawing. Slope boundaries can be drawn manually, or created from existing drawing lines, depending on the value of the Specify slope edges option. The top and bottom slope edges can be closed lines. If you select the Peak option, you can create a slope from one top point (hill).
In the drawing, the slope is selected as a single set of objects, parts of which can be moved.
3D-Slope

The 3D-Slope command creates a 3D slope from a surface or from existing objects.


After running the command, set the slope type and characteristics in the Properties bar. The options vary depending on the type of slope and the way the edge is specified.
Options:
| Construction | |
|---|---|
| method | Selecting the method for specifying the slope location, its parameters and objects on the basis of which it should be built: |
| • Set Values – the slope will be created on the basis of one linear object (polyline, circle, segment or arc) specified as the top edge, according to the specified fixed values of the parameters (Slope Width, Slope Height, Slope Angle and Step); | |
| • From Object – a pair of linear objects (polyline, circle, segment, arc) should be selected in the drawing field, they will define the lower and upper edges of the slope. | |
| • From Surface – the slope will be created from the specified 3D polyline to the triangulated surface (TIN). | |
| The top and bottom slope edges can be closed lines. | |
| Width of slope | A constant slope width measured from the edge defined by the linear drawing entity. |
| Height of slope | The height of the slope, measured from the edge defined by the linear drawing entity. |
| Angle of slope | The slope angle of the slope edge relative to the vertical axis. Can be specified between 0 and 90 degrees. The slope angle determines the size and position of the bottom edge of the slope. If you are building a slope to the surface, then the bottom edge of the slope should also be within the boundaries of the TIN. |

Apply changes
Yes – the slope will be created with the current settings.
No – if the settings have been changed, they will not be saved. The slope will be created with the settings displayed immediately after running the command.
saveDefault – save the default settings.
Select polyline/ line/ circle/ arc or [?]:
Select a linear object to define the edge of the slope: polyline, circle, line segment or arc. The polyline can be closed.
Select first polyline/ line/ circle/ arc or [?]:
Select a linear object to specify the first slope edge: polyline, circle, line, or arc. The polyline can be closed.
Select second polyline/ line/ circle/ arc or [?]:
Select a linear object of the same type as the first one to specify the second slope edge.
Specify height of second edge:
If both objects are at the same height relative to the XY plane, you will need to specify the height of the second slope edge.
Select 3Dpolyline:
Specify a 3D polyline to define the top edge of the slope. The polyline should not extend beyond the boundaries of the TIN in the XY plane and lie above the triangulation surface. The 3D polyline can be closed.
Specify direction of slope construction:
Specify the direction of the slope edge bevel relative to the vertical line, i.e. the direction in which the Slope angle will be drawn.

Specify points of slope top or [Undo/Close]:
Specify the vertices of the lower edge of the slope.
Undo – cancel the input of the last specified vertex.
Close – close the line of the lower edge of the slope.
Select polyline of slope bottom or [?]:
Specify a polyline on the screen to build the bottom edge of the slope based on it.
Offset of a 3D-Polyline




Toolbar: Relief > Offset of a 3D-Polyline

Command line: NG_3DPOLYOFFSET
The command draws a 3D polyline similar to the selected one at a specified distance from the original one, with an offset in the XY plane of the current UCS.

| Select mode [Delete/Keep]: | Set the distance by entering a value from the keyboard or by pointing on the screen. |
|---|---|
| Select 3dPolyline or: | Select a 3D polyline for which you want to draw a similar one. |
| Specify the offset direction: | Specify the offset direction and approximate offset distance. |
| Offset distance: | Enter exact offset distance |
Creating a Profile Line

The Create Profile Line command allows you to crate 3d Polyline type object that is located on the mesh and exactly repeat its relief in the specified place. To create an object, it is necessary to have a constructed triangulation mesh.
The profile line is specified by indicating several nodes, with the possibility of automatic closing its ends or extending them to the edges of the mesh. Profile lines can be used to place surface elevations along roads, generate reports, etc.

To create a profile line:
Run the command.
NG_PROFILE_LINE – Create Profile Line
In response to the prompt in the command line
Project profile on or [WCS/UCS/VPort]:
Determine how the profile will be projected:
WCS – onto the XY plane of the world coordinate system.
UCS – onto the XY plane of the user coordinate system (if it is in the drawing).
VPort – onto the viewport plane.
Next, in response to the prompt
Specify profile line node:
Select the parameters by which the profile line will be created.
Search for Key Lines on the Surface



Command line: NG_KEY_LINES
The command searches for key lines such as thalwegs, edges, etc. on the surface.
Parameters:
There are two parameters to set first: Resolution and Isolation Distance. The rest can be left at their default values for the first time, since they do not depend on drawing units.
Resolution
The main parameter. It specifies the detail, such as how large the radius around a point will be to determine if it has a bend. It also defines the step between the points of the resulting polylines.
The parameter is measured in drawing units. Usually the optimal value is 4-5 meters.
If the value of the Resolution parameter is too low (high resolution), the slightest bends in the relief will be detected, but smooth bends, which are more important in terms of the key lines of the relief, may not be detected. So, if you are creating a lot of scattered small lines, the value of the Resolution parameter is most likely too low.

If the parameter value is too high, the opposite picture is obtained: there are few lines and they are very inaccurate. If at the same time the Isolation Distance parameter, which is responsible for the integrity of the lines, is set twice as high as the Resolution parameter value, then the lines will be even smaller and they will fall apart, and if set much more, the lines will stick together where they are not needed. The
example below shows just such a situation: too high a value for the Resolution parameter with a large value for the Isolation Distance parameter.

Isolation distance
The value of this parameter is also specified in drawing units. The Isolation Distance parameter is closely related to the Resolution parameter. It affects how the lines are separated from one another. If the values are too high, the lines will stick together, if the values are too low, they will fall apart. The value of the Isolation Distance parameter should be greater than the value of the Resolution parameter, otherwise nothing will be detected. The optimal value is three to five times greater than the Resolution.
Key Point Percent
The parameter determines how sharp corners are considered bends. It is necessary to increase the parameter value if you need to recognize more bends, and decrease it to reduce their number and take into account only the sharpest corners. This parameter is also related to the Resolution parameter, since a bend is considered to be within the sphere of the radius determined by the resolution. The parameter values vary from 0 to 1. As a rule, the optimal value is 0.075.
Smoothing Pass band and Smoothing Iterations
Smoothing Pass band and Smoothing Iterations are parameters for smoothing lines. It makes sense to change them only if the lines seem to zigzag and they should be smoothed out even more. In this case, you can try to increase the number of iterations. In most cases, you do not need to change the parameter values. Values of the Smoothing Pass band parameter are set in the range from 0 to 2, smaller values correspond to more smoothing.
The example below shows lines obtained from only one iteration. They are practically without smoothing, you can see that they go a little zigzag.

Projection
By default, the resulting lines found do not lie on the mesh surface. To project them vertically onto the relief, you can set the Projection parameter to Vertical.
Projecting a Line onto a Mesh

Toolbar: Elevation > Projecting a Line onto a Mesh
Command line: NG_TO_PROFILE_LINE
The command is designed to project the existing plan elements onto a surface. Segments, polylines or 3D polylines can be selected for projection

Project profile on or [WCS/UCS/Viewport]:
Defines how the polyline will be projected onto the mesh:
WCS – on the XY plane of the world coordinate system.
UCS – on the XY plane of the user coordinate system (if available in the drawing).
Viewport – on the viewport plane.
Select polyline to build profile line or [?]:
Select line, polylines or 3D polylines to project onto the mesh.
Correction of Zero Elevation
Ribbon: Topoplan – Relief > Correction of Zero Elevation

Menu: Ground – Elevation > Correction of Zero Elevation

Toolbar: Elevation > Correction of Zero Elevation

Command line: NG_ADJUST_ZERO_ELEVATIONS
The command changes the elevations (Z coordinate) of a 3D polyline, aligning them in the range from one valid elevation to another using the linear interpolation method.
When running the command, specify 3d polyline in the drawing and press ENTER. The nodes the Z coordinates of which had 0 value, will be corrected.

Note
Zero values of Z coordinates of endpoints of 3d polylines will be corrected for non-zero values of Z coordinates of adjacent points.
Node of 3D polyline that needs correction 3D polyline after correcting elevation


Projecting Objects onto a Surface
Ribbon: Topoplan – Utilities > Project Objects onto a Surface
Menu: Topoplan – Utilities > Project Objects onto a Surface
Toolbar: Topoplan Utilities > Project Objects onto a Surface

Command line: NG_MESH_PROJECT_OBJECTS
The command projects objects - blocks, points, geopoints, texts, Mtexts - onto the surface. The elevation (Z coordinate) of the listed objects changes to the surface elevation. After running the command, specify the Network object in the drawing.
The command options are set in the Properties bar.

| Object types | Types of objects that will be projected (Block Reference, Point, Geopoint, Text, Mtext). |
|---|---|
| Select Objects | Area for selecting objects (All Possible, On Screen). |
| Remove original objects | Specifying whether to delete the original objects or not. |
| Project to | Determines how the object will be projected onto the mesh. |
Structural Lines on a 3D Slope
Ribbon: Topoplan – Utilities > Structural Lines on a 3D Slope
Menu: Topoplan – Utilities > Structural Lines on a 3D Slope
Toolbar: Topoplan Utilities > Structural Lines on a 3D Slope
Command line: NG_GET_STRUCTURAL_LINES_FROM_3D_SLOPE
The command creates Structural Lines (3D polylines) by 3D slope on the Structural Lines layer. If such a layer does not exist, it is created automatically.
Command prompts:
Select slopes or [?]: Specify slopes on the screen.
Upon the selection is completed, press ENTER.
Extracting the Mesh Boundary
Ribbon: Topoplan – Utilities > Extracting the Mesh Boundary
Menu: Topoplan – Utilities > Extracting the Mesh Boundary
Toolbar: Topoplan Utilities > Extracting the Mesh Boundary
Command line: NG_MESH_GET_BOUNDARY
The command is designed to select external and internal contours of surfaces.
When running the command, select Mesh, Polyface Mesh or TIN Surface in the drawing, specify the settings in the Properties bar and press ENTER. The boundaries will be created as 3D polylines.

This command is needed to select external and internal contours of surfaces. Surfaces can have breaks, respectively have many external and internal contours.
Managing Block Marker Attributes

The command copies the Z coordinate value of a block to its attribute and vice versa, and also swaps the Z coordinate and attribute values.
The command options are set in the Properties bar.

| Action | Copy attribute to coord Z - fills the value of the Z mark with the value of the selected block attribute (only if the attribute has a numeric value). |
|---|---|
| Copy coord Z to attribute - fills the selected block attribute with the Z mark value. | |
| Swap attribute and coord Z – is selected in the case when the attribute value and the Z mark value should be swapped. | |
| Block | Block selection. |
| Attribute | Attribute selection. |
Point Conversion

Menu: Topoplan – Utilities> Point Conversion
Toolbar: Topoplan Utilities > Point Conversion
Command line: NG_CONVERT_POINTS
The command converts point objects: points to geopoints and blocks, blocks to points and geopoints, geopoints to points and blocks.

Options:
Selected objects The section defines which types of point objects selected in the drawing should be converted to another type and where to get values for mark labels.

You can convert geodata simultaneously from all or selectively from the following types of point objects:
- Simple objects of the Point type with mark labels in the form of ordinary text objects;
- Block insertions with single-line attributes as mark labels (for example, conventional signs inserted into the drawing as blocks from the Conventional Signs toolbar);
- COGO Point type objects with a label.
Values for labels can be taken from the increment, attributes of the point itself, or from the text object nearest to the point:

If you select By point, you will need to specify from which attribute of the point the information should be taken. The list will show the existing attributes of the geopoint or block:

If you select Nearest text, you will need to specify the maximum distance from the point to the text object at which this text will still be considered the label of this point:

Data The table typifies and edits the data obtained from point objects: point coordinates by X, Y and Z, numbers, descriptions of points. The column heading displays the data type. In case of incorrect initial data typing, you can drag one header to another, thereby mutually changing them.

You can delete selected cells, rows, or columns. Multiple selection is supported using SHIFT and CTRL. Rows or columns are selected by clicking on the heading. Before manually deleting data, it is recommended to filter it out using filters.
You can also edit the data after double-clicking on a cell.

UPD classification You can add custom properties to points with the button. You should specify the type (integer, float, or string) and name.

A new empty column with the name of the custom parameter appears in the Data table. Drag this column heading onto the heading of the column you want it to match.


Additional options The Additional Options button opens a window where you can change settings for the units (UNITS) with which geopoints should be imported. By default, the current drawing units are used.

Filters You can exclude data from conversion not only manually by deleting cells from the Data table, but also by setting filters. For example, you can exclude from the conversion all points with heights below 52 (column Z) and with a number greater than 350 (Name column).

After adding the filter with the button, in the drop-down list, select the column by which all converted data will be filtered. Then set the value the column data should satisfy. The rest of the lines will be excluded from conversion. Hovering over a filter displays a tooltip with sample values.

It is recommended to set filters only after correct data typing in the Data section.
Drawing objects The section determines what type of objects the received drawing point data should be converted into. And also what signatures the point label will consist of, and what design they will have.
You can import geodata in the form of:
- Ordinary objects of Point type with labels in the form of text objects;
- Blocks (similar to blocks of the Conventional signs toolbar);
- Objects of Geopoint type with a label.
In case of data conversion into a Geopoint object, you should specify a group for them below, in the drop-down list of groups.

The list contains only groups of geopoints that exist in the current drawing. To create a new group, select the Create new option and enter a name for the new group.
If Block was selected, the points will be represented as block insets with single-line attributes to display labels. To do this, a new block will be created in the drawing. The conventional sugn for the point marker will be taken from the block in the drop-down list below.

Only those blocks that already exist in the current drawing are available in the block list. To make the blocks of the Conventional signs bar available, insert at least one symbol into the drawing.
The blocks will be inserted with a scale that takes into account the values of the current topographic scale.
If instead of selecting an existing block in the list, the Create new option was selected, then after the conversion starts, the block editor will open to create a point marker (conventional sign) block. The default is a circle. In the block editor, edit the marker, save the block, and exit the editor to complete the conversion.
You can specify which labels will be displayed in the geopoint label on the drawing: name (geopoint number), elevation (Z-coordinate) and code (point description). Individual layers and color can be assigned to place points and labels. Labels can be assigned with a font. Current profile Allows you to save all the settings made in the dialog to a profile for later use.
Creating Points by Resection
Ribbon: Topoplan – Utilities > Create Points by Resection
Menu: Topoplan – Utilities > Create Points by Resection
Toolbar: Topoplan Utilities > Create Points by Resection
Command line: NG_CREATE_POINT_BY_RESECTION
Create a point at a location calculated from angles measured between known points (3 or 4 points). The points should be specified clockwise.
Creating a point by 3 points
- Specify the location for the point 1.
- Specify the location for the point 2.
- Specify the location for the point 3.
- Specify angle 1-2.
- Specify angle 1-3.
Creating a point by 4 points
- Input angle MSE in angle seconds.
- Specify the location for the point 1.
- Specify the location for the point 2.
- Specify the location for the point 3.
- Specify the location for the point 4.
- Specify angle 1-2.
- Specify angle 1-3.
- Specify angle 1-4.
Texturing and Calculation
Flat Texture Overlay
Ribbon: Topoplan – Texturing and Calculation > Flat Texture Overlay
Menu: Ground – Textures > Flat Texture Overlay
Toolbar: Textures and calculations > Flat Texture Overlay

Command line: NG_ORTHO_TEXTURE
Using this command, you can create a textured surface if the drawing contains a point cloud with the can Color attribute (its display should be enabled) and a surface created from this point cloud. The command allows you to create a photorealistic image of the earth model.
After running the command, specify the Submesh object in the drawing.
The command options are specified on the Properties toolbar.
Options:
| Texture size | Set in pixels. |
|---|---|
| Format | Possible formats are BMP, JPG, PNG, TIFF. |
| From the ground | Yes – the color of cloud’s point will be projected onto the surface, as if looking from the ground. If No is selected, the color will be projected as if looking from above |
Command prompts:
| Apply changes? | |||
|---|---|---|---|
| [Yes/No]: |
Yes – the texture overlay will be performed with the current settings.
No – if the settings have been changed, they are not saved. The texture overlay will be performed with the settings that were displayed immediately after running the command.
Mesh before the texture overlay Mesh after the texture overlay



After removing the point cloud from the drawing, the surface preserves the texture:

To display the overlay texture, set the Realistic or X-Ray visual style, or a custom style in which texture display is enabled in the face settings.
Raster Texture Mapping

Toolbar: Textures and Calculations > Raster Texture Mapping
Command line: NG_ORTHO_IMAGE
With this command you can create a textured surface. The texture is created by mapping any raster loaded in the drawing on the mesh.
After running the command, in response to the corresponding prompts, select sequentially Submesh and Raster image object in the drawing.
Mesh before texture mapping Mesh after texture mapping


After removing the raste from the drawing, the surface preserves the texture:

To display the overlay texture, set the Realistic or X-Ray visual style, or a custom style in which texture display is enabled in the face settings.
Mesh Coloring by Height

With this command you can create a textured surface with gradient paint. Sets the initial (color of minimum) and final (color of maximum).

After running the command, specify the Mesh object in a drawing.
The command options are specified on the Properties toolbar.

Options:
| Min Value | The minimum height value from which the surface will be painted. |
|---|---|
| Max Value | The maximum height value above which surface painting will not be performed. |
| Out of Range Color | The color of an uncolored surface if the minimum and maximum values are set to something other than the minimum and maximum elevation of the surface. |
| • Black. | |
| • White. | |
| • Border – the color will correspond to the end color of the established gradient. |
| Gradient | Gradient image of the future surface. |
|---|---|
| A single click on the gradient opens a drop-down menu: | |
| • Save Gradient – saves the gradient in the current document saves the gradient in the current document. | |
| • Export gradients – saves the gradient to an XML file. | |
| • Import gradients – imports the gradient from an XML file. | |
| A double click on the gradient image opens the gradient editor, discussed below. | |
| Gradient type | Continuous – the surface will be painted with smoothly transitioning colors. |
| Discrete – each color will be configured separately, the borders between colors are displayed with a clear line. When you select this option, you can specify the number of color intervals and adjust each color separately. | |
| Smooth isocontours | Possibility to smooth the gradient edges. The parameter is reserved for the next version |
Double-clicking on the gradient image opens the gradient editor, where you can set your own colors and the location of the color transition points.

Initially, the gradient scale contains only two extreme points, for which you can set a new color by first clicking on any of them.
A new color transition point is set by a double click in the desired area of the gradient. A new point will appear at this location.

It is possible to:
-
select a point by clicking on it (after creation, the point is selected automatically). In this case, the dialog displays its exact color and position;
-
set a new point color using any color setting method in the dialog, including selecting a color from the screen. In this case, the coloring of the gradient scale will change in accordance with the new color of the point;
-
specify a new location of the point on the gradient scale by moving it along the scale or by entering a relative position value. In this case, the coloring of the gradient scale will change in accordance with the new position of the point. The extreme points of the gradient scale cannot be moved;
-
delete the point with the Delete button. The coloring of the gradient scale will change according to the remaining number and location of points. The extreme points of the gradient scale cannot be deleted.
Command prompt:
Apply changes
Yes – the mesh will be painted with the current settings.
No – if the settings have been changed, they are not saved. The mesh will be painted with the settings that were displayed immediately after running the command.
To display the completed coloring, set the visual style to Realistic or X-Ray, or a custom style in which texture display is enabled in the face parameters.
Calculating Volumes between Models
Ribbon: Topoplan – Texturing and Calculations > Volume between Models


Menu: Ground – Calculations > Volume between Models


Toolbar: Textures and Calculations > Volume between Models

Command line: NG_VOLUMES
The command allows you to calculate the volume of surfaces: Total, Differenced and Balance. Such calculations are often performed to determine the amount of excavation works.

After running the command, first specify the surface created by design data, and then the actual surface (mesh or polyface mesh).
The command options are specified on the Properties toolbar.
Options:
| Type of calculation | Total volume – a total volume of two surfaces will be calculated. | |
|---|---|---|
| Differenced volume – cut and cover volume will be calculated. | ||
| Balance volume – difference of cover and cut volume. | ||
| Create models | Yes – a new surface will be created for each type of calculation. | |
| Specify No so that new surfaces are not created. | ||
| Create Mtext label | Yes – label with the volume value will be created. | |
| in drawing | No – the result will be displayed only in the command line. |
For all types of calculations, you can customize colors of created models, if Yes is set for the Create models parameter.
Command prompts:
Apply changes
Yes – the volume will be calculated with the current settings.
No – if the settings have been changed, they are not saved. The volume will be calculated with the settings, that were displayed immediately after running the command.

Calculating Surface Volume
Ribbon: Topoplan – Texturing and calculations > Surface Volume
Menu: Ground – Calculations > Surface Volume
Toolbar: Textures and Calculations > Surface Volume
Command line: NG_SURFACE_VOLUME
The command allows to calculate volume of surface or surface area.
The command options are specified on the Properties toolbar.
Options:
| Volume | Total volume – a total volume of a surface will be calculated. Differenced volume – cut and cover volume will be calculated. |
|---|---|
| Balance volume – difference of cover and cut volume. | |
| Define contour | Yes – After applying the command options, specify the surface area in a drawing. |
| No – you do not need to specify a contour, the value of volume (volumes) will be calculated for the entire surface. | |
| Create Mtext label in drawing | Yes – label with the volume value will be created. No – the result will be displayed only in the command line. |
| Define font size | Relative to contour – size according to the mesh or contour. Fixed – fixed size. On screen – manual indication of size. |
Command prompts:
Apply changes
Yes – the volume will be calculated with the current settings.
No – if the settings have been changed, they are not saved. The volume will be calculated with the settings, that were displayed immediately after running the command.
Calculating Area
Ribbon: Topoplan – Texturing and Calculations > Surface Area
Menu: Ground – Calculations > Surface Area
Toolbar: Textures and Calculations > Surface Area
Command line: NG_SQUARE
The command is designed to define the area of a surface patch. The objects for calculation are Submesh or Polyface mesh.
The command parameters are specified on the Properties toolbar.
Parameters:
| Specify closed contour | • onScreen – after applying the parameters, specify the contour nodes with the cursor; • Selection – the contour for calculation is selected by a closed polyline; |
|---|---|
| • Profile – specify the nodes in the drawing with the cursor, with the possibility to extend the trim profile to the edges of the mesh (the Extend_in_two_sides option) or close it (the Close option). | |
| Seva result as | • None – the result will be output to the command line; • Submesh –a Submesh object will be created during the command execution; • Polyface mesh – a Polyface Mesh object will be created during the command execution. |
| Project profile on | • WCS – the polyline will be projected onto the XY plane of the world coordinate system; • UCS – the polyline will be projected onto the XY plane of the user coordinate system; • Viewport – the polyline will be projected onto the plane of the viewport. |
Command prompts:
Apply changes
No – if the settings have been changed, they are not saved. The area will be calculated with the settings, that were displayed immediately after running the command.
Specify closed contour Specify a surface patch in a drawing.
It is the most convenient to specify contour in
1736
visual styles with filling.
To end, press ENTER.
The result will be displayed in the command line. The total area, area in the projection to XY plane, area in the projection to XZ plane, area in the projection to YZ plane will be calculated. The values of areas are given in the drawing units.
Surface Difference

The Surface Difference command creates a new surface by subtracting one surface from another.

The command has no options.
Forming a Legend
Ribbon: Topoplan – Texturing and Calculation > Formation of a Legend
Menu: Topoplan – Calculations > Formation of a Legend
Toolbar: Texturing and Calculation > Formation of a Legend
Command line: NG_PAINT_ELEVATION_LEGEND
The Formation of a Legend command outputs a legend into the drawing in the form of a dwg table for the selected network, colored by height.

Command prompts:
Select objects or [?]: Select the mesh you want to create a legend for.
Specify first corner Specify the first corner of the table in the drawing.
Specify second corner Specify the second corner of the table in the drawing.
Map Underlay

Command line: MAPVIEW
Inserts map underlay into the current drawing.

In the dialog box that opens, you can configure the required parameters.
The dialog box allows you to load two types of maps: vector or raster. Each type of map is configured on its own tab on the right side of the dialog box
Vector maps
Go to the Vector map tab.
The vector map provider is the OpenStreetMap service.
In the preview window, select the required import area. The map is moved by holding down the left mouse button, and scaled by rotating the wheel.
After selecting the required area, the following settings are required at the bottom of the dialog:

- Specify the position of the marker relative to which the insertion into the drawing will be performed. To do this, click the marker button at the bottom of the dialog. It is fixed in the pressed state. After that, the marker position on the map is specified by double-clicking the left mouse button. In addition, the position can be specified by manually entering coordinates in the Marker Position section.

-
- Checking the Fix current marker posiiton box fixes the last set position for all windows.
-
- Specify the map scale and drawing units.
After setting all the necessary properties, click the OK button and specify the insertion point in the drawing. The marker position will be placed at this point.
Raster maps

There are several services that provide raster maps (Service Provider field): OpenStreetMaps (OSM), Google Maps, Yandex, OpenTopo, MapBox, ArcGis, Bing and Rosreestr.
In addition, some providers propose different types of maps (Map Type field): street maps, satellite, hybrid, relief, topographic.
Import settings are similar to those for vector maps.
Additionally, for raster maps, you can specify the Relief option, which allows you to add terrain heights to the raster. The image becomes a texture stretched over a 3-dimensional terrain model.
To insert raster map underlays by control points, check the By control points box. After clicking the Insert button, another dialog box will open in which you will need to specify the source and resulting control point pairs by which an attempt will be made to insert the raster map.

Stretch the preview areas of the current document (top left) and raster underlay (top right) if they are too small.
-
- Click the plus button.
-
- Click in the left preview area of the current document to set the first target point.
-
- Click in the right preview area of the raster underlay to mark the corresponding source point.
-
- The coordinates of the first pair of points will appear in the left part of the dialog box.
-
- Specify at least three more pairs of points. The points will change color from red to green.
-
- To delete a pair of points, select it in the table and click the minus buttonBy clicking the Test button, you can see the conversion results and the maximum error. To exclude a pair of points from the calculation, it is not necessary to delete it, just uncheck the box next to it.
-
- If the conversion result is satisfactory, click ОK.
To select an area, Google terrain raster images or MapBox satellite images are used. The model is provided by the MapBox service.
In addition to the standard import settings, the following are available: vertical terrain scale, choice of color palette of heights, shading.
Clip Map Underlay


Ribbon: Topoplan – Maps > Clip Underlay
Menu: Topoplan – Maps > Crop Underlay
Command line: CLIPMAP
Visibility of underlays can be partially limited by a clip contour.
After calling the command, you will need to specify the underlay to which the operation will be applied. Further, points of the clip contour are specified in an interactive mode.

As a result of operation, a clip contour will be created, limiting the visibility of map underlay. The contour can be edited using grips.
Unload Map Underlay
Ribbon: Insert – Maps > Unload Underlay
Ribbon: Topoplan – Maps > Unload Underlay
Menu: Topoplan – Map > Unload Underlay
Command line: UNMAPVIEW
The command unloads the underlay content. Only the underlay contour is displayed.
You can load the underlay content back by the Load Underlay command.
The command works identically to the Map State underlay parameter on the Properties bar.

Load Map Underlay

Command line: REMAPVIEW
The command allows you to load back the underlay content after unloading it by the Unload Underlay command. Only the outline is displayed for the unloaded underlay.
The command works identically to the Map State underlay parameter on the Properties bar.

Importing Geo-linked Rasters


Menu: Topoplan – Maps > Importing Geo-linked Rasters
Toolbar: Maps > Importing Geo-linked Rasters
Command line: NG_IMPORT_RASTERS
The command is intended for batch loading of geo-linked rasters in TIF, ECW formats.
The command has no options.
Import and Export
Importing Geopoints
Ribbon: Topoplan – Import/Export > Import geo-points
Menu: Ground – Import/Export > Import Geo Points
Toolbar: Import/Export > Import Geo Points
Command line: NG_IMPORT_POINTS
The command is designed to import text files from CSV, SDR (Sokkia), XYZ and TXT. In the import dialog you can configure the rules for interpreting and uploading file contents.

Options:
| Open | Open text file CSV, SDR (Sokkia), XYZ and TXT to import geodata. You can | |
|---|---|---|
| open multiple files at the same time. |
| Encoding | Encoding of the imported text file. | |
|---|---|---|
| New line character | Allows you to override the newline character. The default character is \n. | |
| Content start line | Line number of significant content, if the file beginning contains any service information, except for point coordinates. | |
| Comment | Specifies the character that is used to comment lines. Commented lines are not considered as data during import. If there are no comments in the file, then leave the field blank. The default character is \. | |
| Separator | Specifies a character that separates data in a text file. You can choose both predefined ones (period, comma, semicolon, tab character, space), or set any other, if necessary, using regular expressions. | |
| Raw data | Preview of text file data. Selected data can be copied. |
1746
UPD classification You can add custom properties to points with the button. You should specify the type (integer, float, or string) and name. When setting an integer value in the property classification, a decimal fraction (for example, “1.2”) is imported as 0.
The Rotation property is applicable to all types of objects. For geopoints, this is the rotation of the label, for blocks, this is the rotation of the attribute, for simple points, this is the rotation of the created text.

A new empty column with the name of the custom parameter appears in the Result table. Drag this column heading onto the heading of the column you want it to match.

You can delete unnecessary custom properties with the button.
Upon the points are imported, custom properties can be viewed and edited in the Properties bar just like other properties.

If the table has more than 5 columns, then a new column is not created, but the name of the 6th is overwritten.

Filters You can exclude data from import not only manually by deleting cells from the Result table, but also by setting filters. For example, you can exclude from import all points with heights below 52 (column Z) and with a number greater than 350 (column Name).

After adding the filter with the button, in the drop-down list, select the column by which all imported data will be filtered. Then set the value that the column data should satisfy. The rest of the lines will be excluded from import. Hovering over a filter displays a tooltip with sample values.

It is recommended to set filters only after correct data typing in the Result section.
Result The table specifies the correspondence of the text file columns to certain data types: point X, Y and Z coordinates, numbers, point descriptions. The column heading displays the data type. In case of incorrect initial data typing, you can drag one column to another by the header, mutually changing the data in these columns.
You can delete selected cells, rows, or columns. Multiple selection is supported using SHIFT and CTRL. Rows or columns are selected by clicking on the heading. Before manually deleting data, it is recommended to filter it out using filters.
You can also edit the data after double-clicking on a cell.

Drawing objects
The section determines the form objects the geopoints should be imported from an external file (that is, by what objects they will be represented in the drawing). And also what titles the point label will consist of, and what design they will have.
You can import geodata as:
- Common Point objects with labels as text objects;
- Blocks (like blocks from the Conventional sign bar)
- Objects of the Geopoint type with a label.
In case of importing data in the form of COGOpoint object, specify a group for them in the drop-down list below.

The list contains only groups of geopoints that exist in the current drawing. To create a new group, select the Create new option and enter a name for the new group.
If the Block was selected, the imported points will be presented as block inserts with single-line attributes to display label titles. To do this, a new block will be created in the drawing. The conventional sign for the point marker will be taken from the block in the dropdown list below.

Only the blocks that already exist in the current drawing are available in the list. To make the blocks of the Conventional signs toolbar available, insert at least one conventional sign into the drawing.
When importing, it is possible to select a block for the marker and the main block (marker + attributes). If the main block existing in the drawing is selected, you can add block attributes in the property classification (they will appear as columns in the table for further editing). The block selected for import is analyzed for the presence of attributes. Next, select an attribute that, when imported, will be filled with data from the point file. When adding an attribute, one of the existing parameters should be selected from the proposed ones (attribute, udp, rotation); if a new

The blocks will be inserted with a scale that takes into account the values of the current topographic scale.
If the Create new option is selected instead of selecting an existing block in the list, then after starting import, the block editor will open to create a point marker (conventional sign) block. The default is a circle. In the block editor, edit the marker, save the block, and exit the editor to complete the import.
When choosing to import a block from the list of those existing in the drawing, the selection of such attributes as Name, Elevation, Code is irrelevant – they will not be created additionally. They are grayed out and blocked.

You can mark which attributes will be displayed in the geopoint description on the drawing: geopoint number (name), elevation (Zcoordinate) and code (point description).

You can automatically create a polyline connecting all imported points. For example, if these are points of a road or a building.

To place points and titles, you can assign individual layers and colors. Titles can also be assign with a font.

Labels can be assigned to a style.


When Importing geopoints, standard styles are created. The _All points group is assigned a style that has 3 decimal places by default. For a larger or smaller number of decimal places, you need to create a new group during import and specify the number of decimal places in the Additional options.

You can change the standard style by starting editing it from the Drawing Explorer.

Note
There are limitations for importing files containing very large numbers of lines. Files larger than 10000 lines are not supported. For simple points and blocks – 2000000. To be able to work with the data, split the file into smaller parts.
Exporting Geopoints

The Export Geopoints command allows you to save such objects as geopoints, blocks, simple points in TXT, CSV, SDR exchange formats, with the possibility to search for the text closest to the points and create labels in the drawing. When exporting geopoints to an external file, it is possible to save the label rotation value or other custom attributes. It is possible to select the file encoding.

Options:


Selected objects The section defines what types of drawing objects should be exported as geodata to an external file. And also whether label descriptions should be exported and from which objects.

You can export geodata simultaneously from all or selectively from the following types of objects:
- Common objects of the Simple Point type with label descriptions in the form of ordinary text objects;
- Block insertions with single-line attributes as label descriptions (for example, conventional signs inserted into the drawing as blocks from the Conventional signs bar);
- Objects of COGO Point type with a label.
You can specify whether to generate labels for data from each object type, and where to get the values of each label description.
Values for the Name label can be taken from the increment, attributes of the point itself, or from the text object nearest to the point:

If you select By point, you will need to specify from which point attribute the information should be taken. The list will show the existing attributes of the geopoint or block:

If you select Nearest text, you will need to specify the maximum distance from the point to the text object, at which this text will still be considered the label of this point:

Values for Elevation (Z-coordinate) and Code labels can be taken from the attributes of the point itself or from the text object nearest to the point:

Points data The table performs typing and editing of data obtained from point objects: point coordinates by X, Y and Z, numbers, descriptions of points. The column heading displays the data type. In case of incorrect initial data typing, you can drag one header to another, thereby mutually changing them.

| Name | X (East) | Y (North) | Code | Z | |
|---|---|---|---|---|---|
| 1 | COGO Points | ||||
| 2 | 1 | 2226556.59 | 497612.46 | 0.00 |
You can delete selected cells, rows, or columns. Multiple selection is supported using SHIFT and CTRL. Rows or columns are selected by clicking on the heading. Before manually deleting data, it is recommended to filter them out using filters.
You can also edit the data after double-clicking on a cell.

UPD (User Defined Properties) classification
You can add custom properties to points with the button. You should specify the type (integer, float, or string) and name.

A new empty column appears in the Points Data table with the name of the custom parameter. Drag this column heading onto the heading of the column you want it to match.
Filters You can exclude data from export not only manually by deleting cells from the Points data table, but also by setting filters. For example, you can exclude from export all points with heights below 52 (Z column) and with a number greater than 350 (Name column).

After adding the filter with the button, in the drop-down list, select the column by which all exported data will be filtered. Then set the value that the column data should satisfy. The rest of the lines will be excluded from the export. Hovering over the filter displays a tooltip with sample values.

It is recommended to set filters only after correct data typing in the Points data section.

Import from LandXML

The command allows you to import a surface from the LandXML format. As a result, a Mesh object will be created in a drawing
LandXML is a popular format for exchanging data with other applications. In nanoCAD it is possible to import and export surface data using LandXML version 1.2 format.
After running the command, a standard file selection dialog box will open. Choose XML file and click OK. The command options will be displayed on the Properties toolbar:
The command options are specified on the Properties toolbar.
Options:
| Xml units | Displays the units in which XML file was saved. |
|---|---|
| Dwg units | Displays the units in which it is required to display objects from XML file. If drawing units are meters, and the Dwg units option is set in meters, then objects from a file will be imported without scaling (1:1). |
| Geodetic CS | As in the geodetic coordinate systems (as opposed to the generally accepted rectangular Cartesian) the X axis is directed to the north, and the Y axis – to the East, for the correct import of object from XML file, it is required to specify the parameter value – Yes. If you specify No, X and Y coordinates will reverse places during import. |
When you import a surface, a “TIN Surface” layer is created.
Export to LandXML



Command line: NG_EXPORT_LANDXML
The command exports a surface (Mesh object) and geopoints to the LandXML format for use in other applications.
After running the command, select a surface to be exported to the XML file. The command options will be displayed on the Properties toolbar:
The command options are specified on the Properties toolbar.
Options:
| Xml | Displays the |
|---|---|
| units | units in which XML file will be saved. |
| Geodetic CS | As in the geodetic coordinate systems (as opposed to the generally accepted rectangular Cartesian) the X axis is directed to the north, and the Y axis – to the East, for the correct export of object to XML file, it is required to specify the parameter value – Yes. If you specify No, X and Y coordinates will reverse places during import. |
1762
| Surface | Enables/disables export of surface (SubMesh object). | |
|---|---|---|
| Geopoints | Enables/disables export of geopoints. When exporting, the belonging of points to a group remains. |
Import from GIS

The command imports polylines and point objects from *.SHP and *.MIF files.
After running the command, it opens the dialog box in which you need to select an existing import template from the list or to create a new one.

Each import template can contain one or more nested object class templates.

First, create a new object class template, and then specify the corresponding output file. Template names are displayed in the left column of the dialog (Feature class), and output files – in the right one (Source file).
To create a class template, expand the class collection, click the empty field of the last stream in the left column and enter the name of a new template:

Note
A name should not contain the following characters: \ / : * ? ” ” < > |.
The context menu is available:

Click button to the right of a template name to edit it or select Edit in the context menu

A class template is a set of rules for data conversion. It determines which objects will be imported and sets the correspondence between the parameters of the external format objects and nanoCAD objects.

Table columns can be hidden using the context menu called by the right click.
Sequence of configuring a template:
- In the Object/Attribute column, select a type of objects to be imported from an external file.

Only one type of objects should be specified in the template – if two or more are specified, they will not be taken into account.
It specifies the type of objects that should be imported into the drawing from a file:
- Polyline export of linear objects from the external file with converting them to a polyline object.
- Point export of point objects from the external file.
-
- If you need to import all objects of this type, and do not need to specify additional import conditions, then click OK to close the dialog box. Otherwise, click on the ”+” sign to the left of the added object type, and specify the parameters to which the import condition will be applied.

- If the value of this parameter should not inherit the value of the imported object parameter, but should simply receive a previously known value (for example, Roads layer existing in the document or color red), then in the Constant value column you should select the required value from the dropdown list.

This list presents the standard values and values contained in the current nanoCAD document. To set a non-standard value, assign it to the object of the current document, then you can select it in the drop-down list.
- If the parameter value should inherit the parameter value of the imported object, then click in the first cell of the External object/attribute column and select the Scan file in the menu that opens

In the dialog box that opens, specify the file with mif (shp) extension, from which the data should be imported.
As a result, information about all types of imported objects and their parameters will be taken from the specified file.
If you have a ready-made type template in the.xml format, then instead of scanning geo-file, you can select Load from file and specify xml.
-
- In the External object/attribute column, select from the drop-down list the external parameter, the value of which should be inherited by the internal parameter in the Object/Attribute column.
-
- You can use filters to restrict the import of objects by certain values of their parameters. Thus, you can import objects only with a certain parameter value or a range of values, objects with empty/non-empty parameter value. For import operations, restrictions are imposed on the parameters of external objects from the External object/attribute column.
To set a filter, double-click a cell in the Filter column. This will open a window, the content of which depends on the type of value of the external object parameter (in the External value column.
A type of dialog for numeric values (Integer, Real, etc.):

Look empty values – only objects with a missing parameter value (selected in the External object/attribute column) will be imported.
Compare – enter a value to which the comparison operator from the Task Drop-down list will be applied Task – a logical operator. Together with the Compare field value, sets the filtering condition (the screenshot shows the condition=3).
Invert – a logical operator that inverts a given condition. It can be used only in case of Search for empty values. In other cases, it is ignored.
Export to GIS

The command exports polylines and point objects to *.SHP and *.MIF files.
After running the command, select the objects to be exported. In export templates the objects are filtered from the selection specified at this step. After selecting objects, a dialog for multiple export to geo-formats opens. In the dialog that opens, select an export template from the list or create a new one.

Creating and editing an export template
Each export template can contain one or more nested templates of Feature classes (Feature class column), which are associated with the output external files of SHAPE or MID/MIF format, where the data will be exported (Destination file column).

To create a class template, expand the export template and double-click an empty field in the Feature class column. In the text field, enter the name of the new template:

Note
The name should not contain the following characters: \ / : * ? ” ” < > |.
The same can be done using the context menu available in this dialog:

To edit the content of a class template, select its name in the Feature class column and click button on the right or select Edit in the context menu.
This will open the template settings dialog. A class template is a set of rules for data conversion. It determines which objects will be exported and sets the correspondence between the parameters of nanoCAD objects and external format objects.

The Change order XY box is checked in the case, when the coordinates along the X axis and coordinates along the Y axis should be changed during export.
First, you should specify the type of objects to be exported: Polyline, 2dPolyline, Point.

Usually, in the nanoCAD drawing, roads and buildings are represented by polylines:

Only one type of exported objects can be specified in each template. To export other types, create new templates.

Note
The objects will be exported not from all objects in the document, but from the selection that was made at the first command prompt, immediately after its start.
Below there is a table for converting types of objects when exporting to MID/MIF format:
| nanoCAD objects type | MID/MIF, SHP objects type |
|---|---|
| Polyline not closed (property Closed = No) | Polyline |
| Polyline closed (property Closed = Yes) | Polygon (Region) |
| Point | Point |
Filtering the exported selection of objects using attributes
If you need to export not all the objects of the specified type, but a certain selection, then you should specify the attribute value by which the selection is carried out. For example, to export all buildings, as a rule, it is enough to set the Polyline object with the Closed “real” attribute value.
Click the <New attribute…> field and select the Closed attribute in the drop-down list

The attribute value is set by clicking button in the Filter column.

In the dialog that opens, select Compare, and in the drop-down list select the attribute value – Yes.

Filtering options:
| No filter | Filtering by attribute value is not required. I.e., the attribute is not used to create the required selection of objects (and only for export of values to an external file). | |
|---|---|---|
| When the No filter item is set, the icon in the Filter field of the Export settings dialog disappears. | ||
| Search for empty values | Objects with an unassigned value of this attribute will be selected. |
1772
| Compare | Allows you to set a specific value for an attribute. A list of fixed values is available for most of the attributes. For the Level attribute you should enter the value yourself. |
|---|---|
| Partial matching | Available for the Level attribute that does not have a fixed list of values. |
| Match case | Available for the Level attribute that does not have a fixed list of values. |
| Invert | Inverts the selection by the given attribute: the selection will include all objects with the attribute value NOT meeting the specified criteria. |
Now in the Filter column opposite to the Closed attribute, the icon will appear, which means that a value for this attribute has been set and is used as a filter during export.

If you use the resulting template for export, then the output file will contain all closed polylines (buildings) of the same color:

To export only yellow buildings with preserving polylines color in the output file, it is required to complicate the template a little.
Let’s set one more attribute – Color.

The attribute value should be specified in its filter. To do this, click button in the Filter column next to the corresponding attribute.

In the window that opens, select the desired value. To set the yellow color, select the Compare item and select Yellow from the drop-down list of available values.

Now all closed yellow polylines will be exported.
Exporting attribute values to the external format
To preserve the color during export, the Color attribute should be matched to the desired external format attribute.
You can get a completed list of external format attributes by loading semantic data from XML file of by scanning an existing MIF or SHP file. To do this, select <Load from file…> or <Scan from file…> in the External object/attribute field from the drop-down list

In the window that appears, specify the file from which you want to get semantic information.

In case of scanning files, a new xml file is created with an identical name containing semantic information,
Now in the External object/attribute column you can specify an external attribute that should inherit the value of the internal Color attribute when exporting objects.

If objects are sorted into layers, it is most convenient to use the Layer attributes to filter objects.

A Virtual attribute is used in a case, when during export for the external files objects you need to set the value of the attribute that is missing in nanoCAD objects.
Export of geodata
After configuring all templates, in the geodata export dialog, to the right of a name of each template, specify an output file of MIF format, to which the data should be exported.

As a result, we created “template-output file” pairs, indicating by what rules and in which file the data should be exported.
After creating all “template-output file” pairs, click OK to export the data.
The export will be carried out for all templates to which the output file was assigned. Templates without an output file will be ignored.


In order to avoid data loss, do not indicate the same output file for different templates.
Import of KML/KMZ files

The command imports from KML/KMZ (Keyhole Markup Language) format with a possibility to recalculate data from/to various topographic and geodetic coordinate systems using EPGS codes.
To import KML/KMZ:
-
- Run the command.
-
- In the file selection dialog that opens, select a file to import.
-
- The EPSG Transformations dialog box appears.
-
- In the right part of the dialog box, mark the objects to be imported from the file.
-
- In the EPSG text fields, enter the number of the source and target coordinate systems according to the EPSG classification, focusing on the list provided. Click Apply.
- Information on the selected target geocoordinate system will appear in the Transformation info section. To confirm the transformation, click ОK.

Labels without image will be imported as points. The point will be displayed with an icon (raster). A point is added to the bottom left corner of the icon.

Measurement Archive
The work with measurements can be divided into 2 stages: collection of a measurement files archive and formation of a project underlays collection from this archive.
An archive of measurement files contains raw or preprocessed data, while a set of prepared underlays should be groups of geopoints ready for use in projects.
Filling the archive of measurement files
Measurement files are stored in the Geofiles folder. The path to the folder is defined in the Standard directories section of the Options dialog.
To add a file to the archive, the Add measurements command is used, with the help of which the required file on the disk is specified, if necessary, a new name is given to it, after which it is copied to the measurement archive.
If you need not only to save a raw file, but to carry out a full import at this stage, so as not to return to
setting parameters later, then you should use the Save to the measurement archive command. You need to configure the parameters in it, after which the result in the form of a DWG file is placed in the archive.
The measurement archive is displayed in the file explorer in Geofiles folder. By expanding it, you can view all archive measurement files.

Creating selections and forming a set of underlays
To work with points, it is necessary to form selections from the measurement archive.
Selections are formed by special commands in the form of separate DWG files, which are subsequently placed as external references in working drawings. Thus, the same selection (underlay) can be inserted into several different working DWG files.
To form a selection:
-
Create a new underlay with the Insert a Geounderlay command.
-
Import the required measurements into it from the archive using the Import measurements command
-
- Configure groups of points, forming them, if necessary, and setting their parameters (styles). Enable/disable the visibility of the desired groups.
-
- Save the drawing to the collection of underlays as a separate named entity using the Save as geounderlay command.
The underlay collection is a separate Geofiles folder. The path to the folder is defined in the Standard directories section of the Options dialog.
It is also visible in the File Explorer as the Geofiles folder. By expanding it, you can view all the underlay files.
Adding Measurement File

Adding measurement files to the archive. The command moves the selected files (without opening) to the measurements archive.
The command can be launched from the ribbon, menu, command line, and context menu of the Geofiles folder in the File Explorer bar.

In the dialog that opens, select the measurement file to be added. Supported formats: DWG, SDR (Sokkia), CSV, XYZ, TXT. If the Geofiles folder is absent, then while Adding or Saving measurement files,
the folder is created automatically in the path - \Users\******\AppData\Roaming\Nanosoft*Ошибка! Неизвестное имя свойства документа.** 25.0\GeoFile.
Import Measurements

Importing measurement files into a drawing.
If the command was launched from the context menu of a file selected in the Geofiles folder in the CFile Explorer bar, then the current drawing is immediately imported from the measurement file.

If the command was launched from the ribbon, menu or command line, then a file open dialog appears with the Geofiles folder open, where you should specify the measurement file to be imported.
The contents of the DWG files will simply be pasted into the current drawing. For files of other formats, the Import geopoints command will be launched.
Save to Measurement Archive
Ribbon: Topoplan – Measurements Archive > Save to Measurement Archive Menu: Topoplan – Measurements Archive > Save to Measurement Archive

Toolbar: Measurements Archive > Save to Measurement Archive

Command line: NG_GEOFILE_SAVE
Saving the current drawing to the measurements archive.
Specify the file name (the name of the current one is specified by default).

The file is saved to the Geofiles folder.
The path to the folder is determined in the Standard directories section of the Options dialog

Attach Geounderlay


Command line: NG_GEOUNDERLAY_ATTACH
Inserting a geounderlay (as an external reference) from the archive into the current drawing.
If the command was launched from the context menu of a file selected in the Geounderlays folder in the File Explorer bar, then the specified geounderlay is immediately inserted into the current drawing. You can insert a geounderlay into the current document as an external reference or insert its content.
If the command was launched from the ribbon, menu, or command line, then a file open dialog appears with the Geounderlays folder open, where you should specify the geounderlay file to insert.
Save as Geounderlay

Saving a current file to the geounderlays archive.
Specify the file name (the name of the current one is specified by default).

The file is saved to the Geounderlays folder.
The path to the folder is determined in the Standard directories section of the Options dialog.
