Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: reviewed by DGE

...

Deck of Cards
iddm
Card
id1
labelDriver Info

Driver Information
Anchor
1
1

DriverNetwork - IHC Dredging Triangles (DigiSys)Interface Type

Network TCP

Driver Class TypeTerminated
UTC Driver (question)

No

Input / Output

Input and Output

ExecutableDrvOutIhcTcp.exe DIGISYS_ASCII
Related Systems
Content by Label
showLabelsfalse
showSpacefalse
sorttitle
excerptTypesimple
cqllabel = "dm-0412" and space = "dm"
Related Pages
Show If
groupqps-staff, confluence-driver_format_access
Card
id2
labelFormat

Include Page
DM-0412 - Format
DM-0412 - Format

Card
id3
labelCoding Notes

Coding Notes
Anchor
3
3

TIN Triangles

The TIN triangles will only be send when the DigiSys system asks for them. The query message contains the following parameters:

  1. Maximum number of triangles
  2. Maximum area length
  3. Maximum area width.

It is assumed that the maximum area length & width are specified in QINSy survey units.

Once a query message is received the driver it will perform the following steps:

  1. Obtain the position of the selected output node as defined in the Controller.
  2. Find the TIN triangle in which this node is located.
  3. Find the neighbors of the TIN triangle found in step 2.
  4. Repeat step 3 until the maximum number of triangles has been found
  5. Create a rectangle around the position found in step 1.
  6. Determine on which section of the center line the position from step 1 is located.
  7. Rotate the rectangle from step 5 with the orientation of the section found in step 6.
  8. Filter out any triangles for which one or more corners are not located within the rotated rectangle.

The resulting triangles are sent to the DigiSys system. The output also contains some meta-information which consists of:

  1. The name of the file from which the triangles originated
  2. The name of the layer from which the triangles originated
  3. The last modification date/time of the file from which the triangles originated.

In case the file from which the triangles originate is a grid file the driver will first create triangles from the regular grid.

In case a manual design is used the driver will send two triangles that represent an area of 500x500 survey units around the output node position.

Grid Points

The grid points will only be send when the DigiSys system asks for them. The query message contains the following parameters:

  1. Maximum number of points

Once a query message is received the driver will perform the following steps:

  1. Obtain the position of the selected output node as defined in the Controller.
  2. Compute the size of a rectangle which contains twice the number of points.
  3. Offset the rectangle with the position from step 1.
  4. Get all points within the rectangle from step 3.
  5. Sort the points based on distance from the position of step 1.

The resulting points are sent to the DigiSys system. The output also contains some meta-information which consists of:

  1. The name of the file from which the points originated
  2. The name of the layer from which the points originated
  3. The last modification date/time of the file from which the points originated.

Center Line Definition

The center line will only be sent when:

  1. Either side (QINSy or DigiSys) is starting up.
  2. The used center line is modified/changed.
  3. The optional redundancy status changes.

Once it has been determined that a center line definition should be sent the driver will perform the following steps:

  1. Walk over all sections of the center line line to gather the way points.
  2. Encode the general center line information
  3. Encode the meta-information which consists of
    1. The name of the file from which the center line originated
    2. The name of the center line.
    3. The last modification date/time of the file from which the center line originated.
  4. Encode the individual way point information.
Card
id4
labelSystem Interfacing

System Interfacing
Anchor
4
4

When multiple DigiSys systems are available multiple copies of this driver may be added to the template database. In this case the drivers will communicate with each other so that if one instance of DigiSys sends a query for triangles or points the data will get send to all DigiSys instances.
This also applies for the center line functionality.

Card
id5
labelSystem Config

System Configuration
Anchor
5
5

The DigiSys system should be configured to use the TCP port determined by the following formula:

DigiSys TCP port number = QINSy TCP port number + last byte of QINSy IP address.

So if the QINSy PC has IP number 172.16.0.73 and port number is set to 3000 the port number that should be entered into DigiSys is 3073.
This was done to make it possible to exchange the QINSy template file without changes when multiple QINSy systems are running in a redundant setup.

Card
id6
labelQINSy Config

QINSy Configuration
Anchor
6
6

Database setup

Select the IP number of the IHC dredging computer and set up correct port number. The port number should be the same as in the DigiSys system. By default this will be port 3000.

Info
titleImportant

Please be aware that the value entered in the 'Port number' field is only a base port number. The actual used port number is computed using the following rule:

DigiSys TCP port number = QINSy TCP port number + last byte of QINSy IP address.

So if the QINSy PC has IP number 172.16.0.73 and port number is set to 3000 the actual port number used will be 3073. This was done to make it possible to exchange the QINSy template file without changes when multiple QINSy systems are running in a redundant setup.

Card
id7
labelQINSy Online

QINSy Online
Anchor
7
7

Once the template has been taken online the driver does not show any UI.

The position of the output node as selected in the Controller is used as the center point in case a query is received for triangles or points.

...