FME Transformers: 2024.1

Categories
Geometries
Related Transformers
Intersector
LineBuilder
LineCloser
LineExtender
PathBuilder
Snapper

LineCombiner

Connects line features that meet at common start or end points to create longer lines or paths.

Jump to Configuration

Typical Uses

  • Connecting multiple lines into longer, continuous lines or paths

How does it work?

The LineCombiner receives features with line geometry and merges them where they meet at the same start or end x and y coordinates, producing a continuous line or path, depending on parameter choices and input feature properties.

Attribute values can be optionally used to group the input features to be combined, with various options for attribute accumulation including the creation of List attributes .

Z Values

Z values are supported and optional. The Consider Node Elevation parameter dictates how they are handled:

  • If Yes, nodes will only be combined if the x, y, and z coordinates are an exact match.

  • If No, nodes are combined where the x and y coordinates are a match, and the z values are further handled according to the Connect Z Mode parameter.

Junctions, Intersections, and Crossings

Input line features may cross and intersect in numerous ways, and their handling depends on a combination of parameters.

Crossings

A simple crossing, where no vertices exist at the point of intersection, is handled as if the lines do not interact at all. There are no junctions.

Input

Lines have a Name attribute, either A or B.

They cross but do not intersect.

Output: 2 Lines

Two lines are output.

Parameter settings:

Combine on Attributes: None

or

Combine on Attributes: Name

Intersections/Junctions

The LineCombiner cannot connect more than two lines at a single node. Combinations are determined by the Combine On Attributes and Junctions parameters.

Input

Lines have a Name attribute, either A or B.

They intersect, having a node in common where they meet.

This junction has four line segments converging.

Output: 2 Lines

Two lines are output, each passing through the junction.

Parameter settings:

Combine on Attributes: Name

Junctions: Consider Attribute Values

Output: 4 Lines

Four lines are output, each terminating at the junction.

Parameter settings:

Combine on Attributes: Name

Junctions: Ignore Attribute Values

or

Combine on Attributes: No items selected.

Junctions: Consider Attribute Values

or

Combine on Attributes: No items selected.

Junctions: Ignore Attribute Values

Mid-line Intersections

Where a line meets another at a point along the line (not an end point), the Input Feature Topology parameter determines the output.

Both features must have a vertex in common.

Input

Two lines are input, with the attribute Name either A or B.

They meet as a T intersection, where B touches A mid-line.

Both lines have a vertex at that location.

Output: 2 Lines

Two lines are output unchanged.

Parameter settings:

Input Feature Topology: End Noded

Output: 3 Lines

Three lines are output. Input line A is split at the junction.

Parameter settings:

Input Feature Topology: Vertex Noded

Output Lines and Paths

Output features are either lines or paths, depending on both parameters and the properties of the input features.

Lines are output unless paths are required. When lines are created, the matching combined nodes are collapsed into a single node (pseudonodes are removed).

Paths retain all input nodes, keeping the input features intact as segments in a longer complex path geometry. Paths are output if Preserve Lines as Path Segments is Yes, or if the input geometry has properties that vary, such as measures, traits or geometry names.

Duplicate input features are discarded.

Note that path geometry is not supported in all output formats. See also: Line and Path geometry.

Examples

Usage Notes

Creating and Modifying Linear Features

These transformers work with lines in a variety of ways.

Configuration

Input Ports

Output Ports

Parameters

Editing Transformer Parameters

Transformer parameters can be set by directly entering values, using expressions, or referencing other elements in the workspace such as attribute values or user parameters. Various editors and context menus are available to assist. To see what is available, click beside the applicable parameter.

For more information, see Transformer Parameter Menu Options.

Reference

Processing Behavior

Group-Based

Feature Holding

Yes

Dependencies None
Aliases PseudoNodeRemover, LineJoiner
History  

FME Community

The FME Community is the place for demos, how-tos, articles, FAQs, and more. Get answers to your questions, learn from other users, and suggest, vote, and comment on new features.

Search for all results about the LineCombiner on the FME Community.

 

Examples may contain information licensed under the Open Government Licence – Vancouver, Open Government Licence - British Columbia, and/or Open Government Licence – Canada.