Survey Lines


The Line Database Manager (LDM) is used to create survey lines, routes (polylines) and points for use in planning, conducting and processing a survey. These entities can also be imported from various formats. Once created they can be exported to various formats.


Line Database Manager - Program Status

Read more...

At time of writing (Apr. 2015) two versions of the program are accessible from two locations:

  • Newer: The Line Tools Ribbon Tab in the Processing Manager (newer functionality using in-house developed format QGF).

  • Original: The icon LDBM_IconInConsole.jpg in the lower panel of the QINSy Console (older functionality using the Terramodel Toolbox - PRO format). 

All point, line and route data was originally stored in a *.PRO file, which is the native format for Terramodel. This is still the case when starting the utility directly from the Console.
When creating line files in the Processing Manager, data is stored in the newer QPS developed format (*.QGF file).

During the transition period away from PRO to QGF any existing *.PRO files are automatically converted to equivalent *.QGF files, meaning both files co-exist side by side.
A *.QGF file is automatically updated when changes are made in a *PRO file.

Creating line files from the Processing Manager offers the advantage of background geographical information, e.g. ENCs, DXF, Geotiff, KML.
Being much older, the original program does not provide this contextual benefit.

This Howto concentrates on using the Line Tools in the Processing Manager.
However, both share almost identical functionality so that this Help is easily adaptable to the older program. Note that the older program has its own help pages too.


Currently (Apr. 2016) the original LDM is still needed to generate DTM links.

Tools in the online Navigation Display provide interaction with Line Database files - please refer to Online Help pages.




Create a New Line File

Before any points, lines and/or polylines can be created, a Line Database File must exist.
In the Processing Manager:

image2016-4-8 12:49:43.png Open the File tab.

LDBM_CreateNewFile.jpg

image2016-4-8 12:50:50.png Click on New.

image2016-4-8 12:51:19.png Click on Line File. This opens an explorer window which defaults to the \LineData sub-folder of the current Project.

Enter a file name. Click on Save.

The new Line File is stored under the current project in the folder \LineData (unless a specific common files folder is set in the Console).

The new line file is listed in the Project Explorer window.
A SURVEYLINES layer is automatically created. This name may be changed and additional layers generated.
Clicking on the line file name and then the Edit tab opens the Line Tools ribbon.
Press the Edit tab under the Line Tools tab to activate the Line Planning tools:

PM_LDBM_LineToolsRibbonTab.jpg

The Line Tools tab only becomes active when a Line Database (listed under Line and CAD / GIS Files) is selected in Project Explorer window.

Return to top of page.

Add Layers

To organize points, lines and routes used, perhaps, for different purposes, it is useful to add layers to the single layer created in the new *.qgf file.

image2016-4-8 12:49:43.png Click on LDBM_document_edit.jpg to open the Edit Layers dialog.

Dredging_LDBM_EditLayersDialog_Add.jpg

image2016-4-8 12:50:50.png Click on LDBM_add2.jpg and then edit the name of the layer added. Add other layers as necessary.

Set colors, pen widths and line style. Primitive Count refers to the number of elements in each layer.

Return to top of page.

Create Point, Line, Polyline and Area Objects

Point, line, route and/or area data now needs to be added.

Make sure the focus is on the line database created and on the layer in which the objects are to be added.

Dredging_LDBM_ExplorerLayers.jpg

image2016-4-8 12:49:43.png Click on the Dredging_LDBM_CreateObjectIcon.jpg button. The cursor changes to indicate that a point can be selected in the Plan View area: CreateObjectMousePointer.png

For a Point, click once with the left mouse button, then click the right mouse button to end the drawing mode.
To create a point with a radius, hold down the CTRL button.

For a Line, click two points with the left mouse button, then click the right mouse button to end the drawing mode.

For a Polyline (route), click multiple points with the left mouse button, then click the right mouse button to end the drawing mode.

For an Area click the vertex points of the area with the left mouse button, then click the right mouse button to end the drawing mode.
Make sure to click on or near the first point to create a closed boundary. In the plan view the figure then fills with a default grey color.
The Shift button can also be used when closing the area boundary. This will automatically invoke the extra options for defining an area.

image2016-4-8 12:50:50.png In each case the Add New Object dialog opens. As depicted in the image below there are slight differences in the dialog. Enter a name, and select the object attributes.

Dredging_LDBM_AddNewObjectsDialogs.jpg

image2016-4-8 12:51:19.png In the case of an area, check the 'Make it an area' tick box to actually create an area. The dialog then changes.

If not activated, the boundary of the area is stored as a polyline and it cannot be filled with a color.

Dredging_LDBM_AddNewArea2.jpg

image2016-4-8 16:15:9.png Choose colors for the line and fill.

image2016-4-8 16:15:58.png Use the slider to modify the transparency of the fill color. The plan view responds immediately so you can gauge the effect.

image2016-4-8 16:17:51.png Choose an icon to display in the area.

image2016-4-8 16:18:54.png Choose colors for the line and fill for the icon.

Avoidance objects can be created in the Line Database Manager.

To define an entire area make sure the last polyline point is identical to the first (i.e. is a closed polygon). Then it is automatically recognized as an area. Note that only a 2D check is carried out on area's.

3D Checks are carried out only on polylines that are NOT closed; of course the height should be filled in properly in the Line Database Manager.

In dredging work, the deepest point of the dredge head model is used to calculate the clearance between dredge head and avoidance object.

Return to top of page.

Generate Wing Lines

Wing lines are simply lines generated parallel to a single baseline or polyline. Creating wing lines requires that a line or polyline be defined first.
Before generating any wing lines, make sure to select the layer on which they must be stored.

Single Line

image2016-4-8 12:49:43.png Start a single survey line

PM_LDBM_WingPlanView_CL.jpg
 

image2016-4-8 12:50:50.png Click on this line in the Plan View. 'Wing lines' (and 'Cross lines') commands become active.
image2016-4-8 12:51:19.png Click on PM_LDBM_WinglinesIcon.jpg which opens the Wing Lines Settings window:

PM_LDBM_WinglinesSettings.jpg

image2016-4-8 13:1:24.png Enter values and make selections to generate winglines on the port and starboard side of the initial line selection.

Use the Up/Down arrows to increase/decrease the displayed value by 1 (5m for wingline interval).
The naming convention is:

#S: Sequence number
#N: Name of along line
#O: Absolute offtrack
#o: Offtrack

All other text can be added optionally

Press OK to start the creation of the wing lines.

PM_LDBM_WinglinesGenerated_Plan.jpg

image2016-4-8 14:50:37.png Click on Dredging_LDBM_EditObjectIcon2.jpg and select Lines to view the results of the wingline generation.

PM_LDBM_WinglinesGenerated_EditLines.jpg

image2016-4-8 16:17:51.png Click on PM_LDBM_File_SaveIcon.jpg to store generated lines.

Return to top of page.

Polyline/Route

image2016-4-8 12:49:43.png For a polyline, click on the line in the Plan View.

PM_LDBM_Winglines_SingleRoute_Plan.jpg

The 'Wing lines' (and 'Cross lines') commands become active.

image2016-4-8 12:50:50.png Click on PM_LDBM_WinglinesIcon.jpg which opens the Wing Lines Settings window.

image2016-4-8 12:51:19.png Enter values and make selections to generate winglines on the port and starboard side of the initial line selection.

This image shows the settings and result when generating wing lines for the entire polyline/route:

PM_LDBM_Winglines_MultipleRouteAll.jpg

This image shows the settings and result when generating wing lines for the a portion of the polyline/route:

PM_LDBM_Winglines_MultipleRoutePartial.jpg

Click on PM_LDBM_File_SaveIcon.jpg to store generated lines.

Wing line generation also works for polylines/routes with curves.

Return to top of page.

Generate Cross Lines

Cross lines are simply lines generated at an angle to a single baseline or polyline. Creating cross lines requires that a line or polyline be defined first. 

Before generating any cross lines, make sure to select the layer on which they must be stored.

Single Line

image2016-4-8 12:49:43.png Click on the single survey line in the plan view.

PM_LDBM_WingPlanView_CL.jpg

The 'Cross lines' (and 'Wing lines') commands become active.

image2016-4-8 12:50:50.png Click on  PM_LDBM_CrosslinesIcon.jpg which opens the Cross Lines Settings window:

PM_LDBM_CrosslinesSettings.jpg

image2016-4-8 12:51:19.png Enter values and make selections to generate cross lines at intervals along the initial line selection.

The naming convention for the cross lines:

#S: Sequence number
#N: Name of along line
#K: Station number (KP)
#M: Station number (MP)
#U: Station and offset (USA)

 All other text can be added optionally.

Entering an angle rotates cross line bearings so they are no longer perpendicular.
This image shows the settings and result when generating wing lines for the entire polyline/route:

PM_LDBM_CrosslinesGenerated_Plan.jpg

Press OK to start the creation of the cross lines.

image2016-4-8 13:1:24.png Click on Dredging_LDBM_EditObjectIcon2.jpg and select Lines to view the results of the cross line generation.

PM_LDBM_CrosslinesGenerated_EditLines.jpg

Click on PM_LDBM_File_SaveIcon.jpg to store generated lines.

Return to top of page.

Polyline/Route

image2016-4-8 12:49:43.png Click on the polyline/route in the plan view.

PM_LDBM_Winglines_SingleRoute_Plan.jpg

The 'Cross lines' (and 'Wing lines') commands become active.

image2016-4-8 12:50:50.png Click on  PM_LDBM_CrosslinesIcon.jpg which opens the Cross Lines Settings window.

image2016-4-8 12:51:19.png Enter values and make selections to generate cross lines at intervals along the initial line selection.


PM_LDBM_Crosslines_MultipleRouteAll.jpg

image2016-4-8 13:1:24.png Click on PM_LDBM_File_SaveIcon.jpg to store generated lines.

Return to top of page.

Import Data to New Line Database

image2016-4-11 14:18:58.png Click on Line file to which data is to be imported

image2016-4-11 14:19:25.png Double click on the Line Tools ribbon tab to activate the Line Tools

image2016-4-11 14:20:0.png Click on Import to initiate the Import Wizard

PM_ImportNew_LineDb.jpg

Supported File Formats

image2016-4-11 14:18:58.png On the first page of the wizard, select the data file format type. The contents of remaining wizard pages depends on the data format chosen.
The following formats are supported:

Dredging_LDBM_ImportFormats.jpg  

Supported formats


DXF (Text) File

AutoCAD DXF File. Notice that two dimensional defined lines will be imported as pline objects. To convert them to routes after importing use the 'Edit Other Objects' option.

DXF versions 2.5 through 2014 are supported.

DXF (Binary) File

AutoCAD DXF File. Notice that two dimensional defined lines will be imported as pline objects. To convert them to routes after importing use the 'Edit Other Objects' option.
DXF versions 2.5 through 2014 are supported.

DWG File

AutoCAD DWG File. Notice that two dimensional defined lines will be imported as polyline objects. To convert them to routes after importing use the 'Edit Other Objects' option.
DWG versions 2.5 through 2014 are supported.

ASCII (X/Y/Z) File

File contains grid co-ordinates (easting, northing, height or x,y and z). Fields can be in fixed columns, or comma, tab or space separated.
If none of the pre-defined import layouts does not work, you can create a new import layout.

ASCII (Lat/Lon) File

File contains geo co-ordinates (latitude, longitude, height). The user will be asked for geodetic parameters to convert from geo to grid.
These parameters are retrieved from a template database (*.db).

KML

KML is a file format used to display geographic data in an Earth browser such as Google Earth, Google Maps, and Google Maps for Mobile. KML uses a tag-based structure with nested elements and attributes and is based on the XML standard. All tags are case-sensitive and must appear exactly as they are listed in the

KML Reference

. The Reference indicates which tags are optional. Within a given element, tags must appear in the order shown in the Reference.

Return to top of page.

Import ASCII (X/Y/Z) Wizard

image2016-4-11 14:18:58.png Select ASCII Files

PM_ImportNew_LineDb_WizardP1a.jpg

image2016-4-11 14:19:25.png Add the ASCII file(s) to be imported

image2016-4-11 14:20:0.png Click Next

PM_ImportASCII_Options.jpg

Two predefined layouts are available: E N H (Comma delimited) and E N H (Tab delimited). If data in the ASCII file has a different layout, there is an option to create a new user defined import layout; select 'New Format' from the drop down list or click on  PM_DefineNewLayout_Button.jpg . This opens the Layout Editor:

PM_ImportASCII_AddFields.jpg

image2016-4-11 14:18:58.png Click the 'New' button.

image2016-4-11 14:19:25.png Provide a name for the new layout and the delimiter used.

In case the ASCII file contains header information, define the row on which the coordinates start.

image2016-4-11 14:20:0.png Click on the 'Add' button in order to define the fields of data in the ASCII file being imported.

image2016-4-8 14:37:47.png Select the first field type. Repeat until all fields are defined. 

PM_ImportASCII_TestStrings.jpg

image2016-4-11 14:18:58.png To test decoding of the ASCII data, copy and paste a line from the file into the 'Example' space provided.

image2016-4-11 14:19:25.png Click 'Test' and check decoded sentence.

Clicking OK returns you to page 2 of the import wizard where you select the 'Primitive Type', enter a 'Layer Name' and check/change the 'Skip Rows' number.

Click 'Finish' and the imported points/lines/polylines are shown as a layer in the plan view.

PM_ImportASCII_LinesShown.jpg

Additional ASCII files may be added to this line file if necessary.

Return to top of page.

Import ASCII (Lat/Long/Ht) Wizard

This import routine is very similar to importing X/Y/Z ASCII data. The differences are:

Define different fields.

image2016-4-11 14:18:58.png Create a new layout

PM_ImportASCII_LatLongLayout.jpg

image2016-4-11 14:19:25.png Give the layout a name, a start row and a delimiter

image2016-4-11 14:20:0.png Add fields and setting scale factors and/or formats

image2016-4-8 14:37:47.png Copy and paste a line from the ASCII file

image2016-4-8 14:50:37.png Test decoding.

Geographical to grid conversion

Geographical coordinates are converted to grid during the import so you must make sure to have the correct template database active.

Return to top of page.

Import DWG, DXF or PRO Wizard

As with an ASCII import:

image2016-4-11 14:18:58.png Select DWG, DXF or Terramodel Files as File Format

image2016-4-11 14:19:25.png Browse to select the DWG, DXF or PRO file to be imported

PM_Line_ImportDWG_P1.jpg

On the second page of the wizard:

PM_Line_ImportDWG_P2.jpg

image2016-4-11 14:18:58.png Use a combination of check boxes, Select All, and Invert Selection to choose which layers of the DWG/DXF/PRO to import

image2016-4-11 14:19:25.png Check the Skip Empty Layers box if there is a need to avoid importing empty layers

image2016-4-11 14:20:0.png Click Finish

Return to top of page.

Import KML Wizard

A line file may also be defined in a KML file. Import is similar to other file formats described above.

image2016-4-11 14:18:58.png Select KML as File Format

image2016-4-11 14:19:25.png Browse to select the KML file to be imported

PM_Line_ImportKML_P1.jpg

On the second page of the wizard....... 


PM_Line_ImportKML_P2.jpg

After import the lines should appear in the plan view. You may have to click on a different element and then click back on the line file.

PM_Line_ImportKML_Post Import.jpg

Return to top of page.

Edit Points, Lines, Polylines and Areas

In Data Grids

image2016-4-11 14:18:58.png Click on Dredging_LDBM_EditObjectIcon2.jpg and choose which entity to edit.

Coordinates and attributes are shown in a data grid like this:

Dredging_LDBM_Edit_DataGridExample.jpg

In the Processing Manager, data grids are often used for showing properties of multiple items located in such places as the Points, Lines, Polylines and Areas Editor and the PM Project Explorer.

The data grids offer many opportunities for customization such as filtering, sorting and grouping.
Most of these options are found by right clicking on the column headers to open the contextual menu.

Please refer to How-to Use Data Grids.

All functions are fairly self explanatory except, perhaps, for the following:

Points, Lines, Polylines and Areas - Attributes 1 and 2

Custom numeric attributes. Change the attribute names by right clicking on the column header selecting Set attribute names.

Attribute 1 options -

    • T.M.D. (True Measured Depth, used in VSP surveys)

    • Velocity

    • SD (horizontal)

    • Weight (horizontal)

Attribute 2 options -

    • T.V.D. (True Vertical Depth, used in VSP surveys)

    • Velocity

    • SD (height)

    • Weight (height)

For example a Weights column can be created or a column with Standard Deviation values.
The custom attributes can be used in the Data Fusion to calculate a weighted mean or least squares approach.

Return to top of page.

Points - Data Fusion

Use this option to calculate the mean of the points selected in the Points data grid list.
The calculation options are:

    • Mean - Calculates the new position based on the average positions of the selected points.

    • Weighted mean - Calculates the weighted mean of the selected points. Points with zero weight are excluded.
      The weights can be entered in the attribute columns in the Points Editor.

    • Least square approach - Calculates the new position using a least squares approach.
      All selected points must have proper Sd values, which can be entered in the attribute columns in the Points Editor.

Return to top of page.

Lines - Interpolate

Use this option to create interpolated lines between the two or more lines selected from the list in the Edit Lines window.

For example, two lines are defined:

PM_LDBM_InterpolateLines_Plan2Lines.jpg

Before adding interpolated lines make sure the correct layer is selected:

image2016-4-11 14:18:58.png In the Edit Lines data grid select both lines.

PM_LDBM_Interpolate_EditLines2lines.jpg

image2016-4-11 14:19:25.png Click on the Interpolate button which opens the Interpolation Settings window.

PM_LDBM_Interpolate_SettingWindow.jpg

Interpolate Lines Settings


Name

Enter a name manually and combine with it one of the possible predefined settings:

  • #S - Step number

  • #N1 and #N2 - Name of the adjacent line

  • #I - Interpolated number found in the line name

Color

Select in which color the interpolated lines will be displayed in the Plan View.

Maximum line spacing

Enter the maximum distance between the interpolated lines.

Maximum angle

Normally lines can be inserted between two adjacent lines when these two lines are more or less parallel.

Maximum angle is used to see if the two lines are more or less parallel: within the criteria of this angle.
So if lines are exactly parallel, then this maximum angle can be 0°.

Two attempts are made to see if the lines are pointing in the same direction:

  • When the given two lines are not pointing in the same direction (+/- max angle), then one line will be reversed, and a second check is done to see if they are now pointing in the same direction (+/- max angle).

  • If this is still not true, then no additional lines will be inserted.


Rule of thumb to produce new lines between two lines is to use an angle larger than the angle between the two lines.
Use the line bearings in the Bearings column to calculate this angle.

Press OK to start the interpolation.
The new lines are displayed in the Plan View when OK is pressed in the Edit Lines dialog.

Interpolation is also possible between 3 or more lines:

PM_LDBM_Interpolate_TwoAndThreeLines.jpg

Click on PM_LDBM_File_SaveIcon.jpg to store interpolated lines.

Return to top of page.

Polylines - Simplify Polyline

The line simplification is used to reduce the number of segments in a polyline without losing too many details.

simplifypolyline.png

Polylines - KP Calculations

This function either extrapolates KP values between the selected control points or it calculates values between entered KP values.

In this example:

PM_LDBM_CalculateKP_EditPoly1.jpg

...the following settings were used to compute KP values:

PM_LDBM_CalculateKP_Window1.jpg

Automatic KP value calculation


begin cp/end cp

Use the up/down arrows to select control points for the selected polyline.
KPs are calculated between the two cp points selected - Example #1 below.

start KP value/end KP value

Enter a value manually or use the up/down arrows to select a value.
End KP only active when Extrapolate is disabled.
Useful if resurveying part of a polyline/route beginning partway along the route - Example #2 below.

Extrapolate

If activated, then the end KP value is calculated automatically.
If not activated, then the KPs are fitted between the entered start and end KP values - Example #3 below.

Start calculation

Press to start calculating KPs along the polyline.


Examples:

PM_LDBM_CalculateKP_Example2.jpg

PM_LDBM_CalculateKP_Example3.jpg

PM_LDBM_CalculateKP_Example4.jpg

Return to top of page.

By Mouse

Delete

Points, lines, polylines and areas may be deleted by clicking on the entity in the Plan View panel.

PM_LDBM_RemovePoint.jpg

PM_LDBM_RemoveLine.jpg

PM_LDBM_RemovePolyline_ByMouse.jpg

Line color turns grey.
Click on Remove in the Actions command group.

Multiple entities are selected for removal at once by holding down the CTRL key.

Return to top of page.

Editing Coordinates

For lines, polylines and areas, clicking once on the line changes the color to grey.
Clicking again changes the line color back and adds edit points at each vertex.
Hover over one of the edit points, click and drag.

PM_LDBM_EditRouteByMouse_R2.jpg

Clicking once on the route changes the color to grey.
Clicking again changes the route color back and adds edit points at each vertex.
Hover over one of the vertices, click and drag.
Release mouse button when vertex is appropriately placed.
While the focus is still on the route line edit points remain at each vertex for further moving.
Click anywhere in the panel and the route reverts to grey.
Removing the focus from the route changes the line color back to its original.

Return to top of page.

Export Data

Export data to one or more of the following formats:

Dredging_LDBM_ExportAndAutocadFormats.jpg

Actions - Clipping Lines

PM_LDBM_ActionsGroupCommands.jpg

By way of an example, a survey to be performed in an area with an irregular coastline and an island:

PM_LDBM_Clipping_PolygonsAndSurveyLines.jpg

Clip Outside

Make sure the correct layer is selected, i.e. the layer on which the lines to be cut are resident.

Select the larger polygon and click on PM_LDBM_ClipOutside_Icon.jpg .

PM_LDBM_ClipOutside_Before.jpg

For the lines that cut the polygon, the pieces of lines that fall outside are cut.
Any lines that do not cut the polygon are unaffected and should be removed by hand.

Clip Inside

Select the smaller polygon and click on PM_LDBM_ClipInside_Icon.jpg .

Before clipping:

PM_LDBM_ClipInside_Before.jpg

After clipping:

PM_LDBM_ClipInside_After.jpg

Return to: top of page


Return to: How-to Dredging