xml-line

This is a composite builder that constructs a line geometry. The coordinates of the line may be given via the data-string parameter or via point geometries.

builder type: composite: accepts point geometries.

geometry constructed: line geometry.

data parameters:

Data Name

Value

Required/Optional

data-string

The string containing the coordinate data.

Range: String

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

dimension

The dimension of the coordinates.

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

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

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

decimal

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

Range: String

Default: “.”

Optional

coordinate-system

Specifies the coordinate system name. If the expression sequence for the coordinate-system evaluates to the empty string, then the coordinate system for the feature being built will not be set.

Range: String

Optional

demote-incomplete-geometry

A line is incomplete if it doesn’t have at least two distinct points, if only one coordinate is given then the line geometry builder will halt on error, setting this optional parameter to true allows a point geometry to be constructed when only one coordinate is given.

Range: false | true

Default: false

Optional

allow-incomplete-geometry

A line is incomplete if it doesn’t have at least two distinct points, setting this optional parameter to true allows a degenerate one coordinate line geometry to be constructed. Note that this parameter overrides the demote-incomplete-geometry parameter.

Range: false | true

Default: false

Optional

keep-duplicate-coordinates

Consecutive duplicate coordinates coming from the data-string or from geometry points are not be discarded when this parameter is set to true.

Range: false | true

Default: false

Optional

name

Specifies the geometry’s name.

Range: String

Optional

The document below contains two different type of line elements that we wish to map into FME features:

lines.xml

<?xml version="1.0"?>
<lines>
	<line1>
		0.0 0.0 1.0
		10.0 10.0 1.0
		20.0 30.0 1.0
	</line1>	
	<line2 coords="50.5,50.4 30.8,15.2 0,0"/>
</lines>

The following xfMap document uses the xml-line geometry builder:

xml_line.xmp

<?xml version="1.0"?>
<!DOCTYPE xfMap SYSTEM "xfMap.dtd">

<xfMap>
	<feature-map>
		<mapping match="line1">
			<feature-type> <literal expr="line1"/> </feature-type>
			<geometry activate="xml-line">
				<data name="data-string"> <extract expr="."/> </data>
				<data name="dimension"> <literal exptr="3"/> </data>
			</geometry>
		</mapping>

		<mapping match="line2">
			<feature-type> <literal expr="line2"/> </feature-type>
			<geometry activate="xml-line">
				<data name="data-string"> 
					<extract expr="@coords"/>
				</data>
			</geometry>
		</mapping>
	</feature-map>
</xfMap>

When the lines.xml and xml_line.xmp documents are fed into the XML Reader the following FME features are output:

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Feature Type: line1'
Attribute: fme_geometry' has value fme_line'
Attribute: xml_type' has value xml_line'
Geometry Type: Line (2)
Number of Coordinates: 3 -- Coordinate Dimension: 3 -- Coordinate System: '
(0,0,1) (10,10,1) (20,30,1)
===========================================================================
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Feature Type: line2'
Attribute: fme_geometry' has value fme_line'
Attribute: xml_type' has value xml_line'
Geometry Type: Line (2)
Number of Coordinates: 3 -- Coordinate Dimension: 2 -- Coordinate System: '
(50.5,50.4) (30.8,15.2) (0,0)
===========================================================================