LineCombiner
Connects line features that meet at common start or end points to create longer lines or paths.
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 labels.
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
- The Intersector and Snapper may be useful in preparing data for the LineCombiner.
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 |
|
|
Feature Holding |
Yes |
| Dependencies | None |
| Aliases | PseudoNodeRemover, LineJoiner |
| History |
FME Community
The FME Community has a wealth of FME knowledge with over 20,000 active members worldwide. Get help with FME, share knowledge, and connect with users globally.
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.