xml-geodesic-string

This is a composite builder that constructs a line geometry. The coordinates of the line are interpolated from geodesic control points that are specified via the data-string parameter or via point geometries.

This geometry builder requires the coordinate-system parameter to be set.

builder type: composite: accepts point geometries

geometry constructed: line geometry

data parameters:

Data Name

Value

Required/Optional

addition-rate

Scales the number of interpolation points directly relative to the maximum calculated by the selected logarithmic and exponential interpolation methods.

Range: 0.01 to 1.0

Default: 0.1

Higher values (for example, 1.0) add the maximum number of points calculated by the interpolation method for the distance; lower values (for example, 0.01) reduce the number of points proportionally, adding fewer points for the same distance.

Note  Applicable only to the logarithmic and exponential interpolation methods.

Optional

axis-order

Indicates the axis order for a coordinate.

Range: A permutation of the numbers 1..N, where N is the number of dimensions.

Each number is separated by a comma “,”.

Default: “1,2,...,N”

Optional

axis-separator

The string separating each axis of a coordinate in the data-string.

Range: String | “whitespace” this includes the tab, newline, and space characters.

Default: “,”

Optional

coord-separator

The string separating each coordinate in the data-string.

Range: String

Default: “whitespace” this includes the tab, newline, and space characters.

Optional

coordinate-system

Specifies the coordinate system name.

Range: String

Required

data-string

The string containing the coordinate data.

Range: String

Optional

decimal

The string representing the decimal point for each real number in the data-string.

Range: String

Default: “.”

Optional

dimension

The dimension of the coordinates.

Range: String representing a positive integer, or the “implicit” literal, which forces the
dimension to be automatically determined even if axis-order is specified.

Default: When not specified the dimension will be automatically determined.

Optional

distance-threshold

Specifies the minimum distance, in kilometers, beyond which interpolation starts; no interpolation points are added if the distance between control points is less or equal to the threshold.

Range: A positive, real number.

Default: 20

Optional

enable-interpolation

Specifies whether control points should be interpolated along geodesic curves. The number of interpolation points is determined by the selected interpolation-method, and their exact locations are calculated using the selected interpolation-formula.

Range: true | false

Default: true

Optional

geodesic-distance-trait

Specifies the trait name to store the line segment’s geodesic distance.

Range: String

Optional

interpolated-segment-trait

Specifies the trait name to store the boolean value indicating whether the line segment has interpolated points.

Range: String

 

interpolation-formula

Specifies the formula used to calculate the position of interpolation points along a geodesic. This setting determines the mathematical approach for determining point locations based on the underlying Earth model.

The formulas are:

  • ellipsoidal – Uses the Vincenty formula, which is based on an ellipsoidal Earth model. This method provides highly accurate interpolation point locations by accounting for the Earth's flattening and the variations in distance caused by its elliptical shape.
  • spherical – The number of interpolation points added increases as the distance between geodesic control points grows, but at a rapidly decreasing rate. This decrease follows the steep curve of an exponential reduction function, resulting in far fewer points compared to a logarithmic reduction over the same distance.

Range: ellipsoidal | spherical

Default: spherical

 

interpolation-formula-trait

Specifies the trait name to store the interpolation formula (ellipsoidal or spherical) used.

Range: String

 

interpolation-method

Specifies how the number of interpolation points are calculated between geodesic control points. The methods are:

  • logarithmic – The number of interpolation points added increases as the distance between geodesic control points grows. However, this increase happens at a gradually decreasing rate, following a logarithmic reduction function. This results in relatively more points over larger distances compared to an exponential reduction.
  • exponential – The number of interpolation points added increases as the distance between geodesic control points grows, but at a rapidly decreasing rate. This decrease follows the steep curve of an exponential reduction function, resulting in far fewer points compared to a logarithmic reduction over the same distance.
  • fixed-distance – The number of interpolation points added is directly proportional to the total distance between geodesic control points. Interpolation points are added at regular intervals, determined by the specified interval-distance.

Range: logarithmic | exponential | fixed-distance

Default: logarithmic

Optional

interval-distance

Specifies the fixed distance, in kilometers, between interpolation points for the fixed-distance interpolation method, setting the interval at which points are added along the geodesic.

Range: Any positive, real number.

Default: 0.5*T, where T is the distance-threshold.

Note  Applicable only to the fixed-distance interpolation method.

Optional

label

Specifies the geometry’s label.

Range: String

Optional

reduction-factor

This parameter determines how the number of interpolation points decreases as the distance between geodesic control points increases in the logarithmic and exponential interpolation methods.

Valid Range: > 0 to 100

Default: 1

Higher values decrease the number of points more rapidly, resulting in fewer points for longer distances; lower values decrease the number of points more gradually, resulting in relatively more points for longer distances.

Note  Applicable only to the logarithmic and exponential interpolation methods.

Optional

segmented-interpolation

Splits the interpolation of the geodesic control points into multiple line segments, with each segment starting and ending at control points. This is useful when the data-string contains more than two control points. When set to false, the control points in the data-string are read as a single segment, regardless of the number of positions or interpolations.

An interpolated-segment-trait trait may also be added to each line segment to indicate whether the segment contains interpolated points.

Range: true | false

Default: true

Optional