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.

Crossing

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

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

Two lines are output, each passing through the junction.

Parameter settings:

Combine on Attributes: Name

Junctions: Consider Attribute Values

Output

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

Two lines are output unchanged.

Parameter settings:

Input Feature Topology: End Noded

Output

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

Using a set of menu options, transformer parameters can be assigned by referencing other elements in the workspace. More advanced functions, such as an advanced editor and an arithmetic editor, are also available in some transformers. To access a menu of these options, click beside the applicable parameter. For more information, see Transformer Parameter Menu Options.

Defining Values

There are several ways to define a value for use in a Transformer. The simplest is to simply type in a value or string, which can include functions of various types such as attribute references, math and string functions, and workspace parameters. There are a number of tools and shortcuts that can assist in constructing values, generally available from the drop-down context menu adjacent to the value field.

Dialog Options - Tables

Transformers with table-style parameters have additional tools for populating and manipulating values.

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 and/or the Open Government Licence – Canada.