point function

Geometric functions point function

The point function is obsolete: a call to point is an error, ‘point’: unknown operator and no template or function was found with this name. Use point_xy or point_yx instead, which state the order of the two coordinates in their name; see XY order.

syntax

  • point(first, second, pointunit)

converting a configuration

point did not state the order of its coordinates in its name. The setting ConfigPointColRow in the config.ini of the project stated it, and GeoDMS ignores that setting. Replace every call to point:

  • by point_yx with the same arguments where config.ini has ConfigPointColRow=0 or no such setting: the first argument is the Y coordinate (the row), the second the X coordinate (the column);
  • by point_xy with the same arguments where config.ini has ConfigPointColRow=1: the first argument is the X coordinate, the second the Y coordinate.

The third argument stays the resulting point Values unit.

applies to

  • first and second data items with (u)int16, (u)int32, float32 or float64 Value type
  • pointunit with wpoint, spoint, upoint, ipoint, fpoint or dpoint value type

The value types of the two coordinates match each other and the point unit: uint16 for wpoint, int16 for spoint, uint32 for upoint, int32 for ipoint, float32 for fpoint and float64 for dpoint.

since version

5.15; removed in 18.1.0

example

attribute<fpoint> pointXY (ADomain) := point(Ycoord, Xcoord, fpoint);

This call, with no ConfigPointColRow setting, becomes:

attribute<fpoint> pointXY (ADomain) := point_yx(Ycoord, Xcoord, fpoint);
Ycoord Xcoord pointXY
401331 115135 xy(115135; 401331)
399476 111803 xy(111803; 399476)
399289 114903 xy(114903; 399289)
401729 111353 xy(111353; 401729)
398696 111741 xy(111741; 398696)

ADomain, nr of rows = 5