FME Transformers: 2024.1

Categories
Geometries
Related Transformers
LineCloser
LineCombiner
LineExtender
PathBuilder

LineBuilder

Connects sequential point and/or line features to create line or area geometry.

Jump to Configuration

Typical Uses

  • Connecting points to form a line
  • Connecting multiple lines into longer, continuous lines

How does it work?

The LineBuilder receives features with point and/or line geometry, and connects them in the order received, producing line or area geometry.

Both the order in which the features enter the transformer and the orientation of any line geometry received are honored. Gaps between line features are connected, and duplicate points may be either processed or ignored.

Z values are supported. If some input features have z values and others do not, those without are assigned a z value of zero (0). Features with matching x and y coordinates but differing z values are not considered duplicates.

If the output feature is closed (the first and last x and y coordinates are the same), an area is output whether or not the z values match.

Features may be grouped by attribute values to produce multiple outputs.

Attributes may be merged, dropped, or collected as List Attributes.

Examples

Usage Notes

  • The Sorter may be useful for ordering features before using the LineBuilder.
  • As the LineBuilder fills in gaps between features, it can produce unexpected results if the input features are not sorted correctly. To combine adjoining lines (without creating new geometry to connect gaps), use a LineCombiner.
  • The CoordinateSwapper may be useful in specific cases.

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.

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 LineBuilder on the FME Community.

Keywords: "point joiner" "line creator" PointConnector