VertexCreator

Creates a single vertex to replace, be appended to, or be inserted into existing geometry.

Jump to Configuration

Typical Uses

• Creating point geometry from non-spatial data with coordinates as attributes
• Adding known coordinates to existing geometry

How does it work?

The VertexCreator receives features with any geometry and creates a single vertex at specified coordinates, performing one of these actions:

• Add a new point to the existing geometry
• Replace the existing geometry completely with a single point
• Add a new point to the geometry at a specific position (index)
• Replace an existing vertex at a specific position (index)

The actions available vary according to the input feature’s geometry type:

	Mode
Geometry	Add Point	Replace with Point	Insert Point at Index	Replace Point at Index
Null	Yes	Yes	Yes	Yes
Point	Yes	Yes	Yes	Yes
Line	Yes	Yes	Yes	Yes
Arc	Yes	Yes	No	No
Path	Yes	Yes	Yes/No*	Yes/No*
Area	No	Yes	Yes	Yes
3D Object	No	Yes	No	No
Raster	No	Yes	No	No
Point Cloud	No	Yes	No	No
Multi/Aggregate	No	Yes	No	No

If the selected Mode is not supported for the input feature’s geometry type, the feature will be output via the <Rejected> port.

* Using indices on paths containing arcs is not recommended.

If the X, Y, or Z Value parameters are set to an attribute value, those attributes may be optionally removed from the output features.

Modes

Mode	Action
Add Point	Appends the new vertex to the end of the existing feature. If the input feature is null, a point is output. If the input feature is a point, a line is output. If the input feature is a line and the new vertex is the same as the first vertex, a line or area may be output, according to the Closed Line Handling parameter.
Replace with Point	Input geometry of any type is discarded and a single point is output. A coordinate system may be specified.
Insert Point at Index	A new vertex is inserted at the specified index position. When entering vertex indices, note that: Zero (0) is the first vertex of the geometry. -1 is the last vertex of the geometry. Negative numbers represent vertices relative to the last vertex, where -2 is second-to-last, -3 is third-to-last, and so on. Out-of-range index numbers are interpreted as either the first vertex (if less than 0) or last vertex (if larger).
Replace Point at Index	The existing vertex at the specified index position is set to the new coordinates.

Measures and Z Values

Z values are supported. If there is a conflict - either the input feature or the new vertex has a z value and the other does not, the result is determined by the Measures/Z Conflict Value parameter:

• Compute: Missing z values on either the input feature or the new point are calculated according to neighboring vertices. At the beginning or end of the feature the neighboring value is used. If only one value is available, it is applied to all vertices.
• None (Drop Values): All z values are discarded and 2D geometry is output.
• Custom Value: The provided value is applied to all vertices without a z value.

Exception: When Mode is Add Point, if a 2D point is added to a 3D feature and its coordinates match either endpoint of the input feature, the z value will be taken from that endpoint.

Measures are treated similarly, where new vertices inserted receive interpolated values when Treat Measures as is Continuous. Note that existing measures are not recalculated. When a vertex is added at the end the neighboring value is used.

When Treat Measures as is Discrete, a vertex inserted or replaced at an index position receives the measure value of the existing vertex at that index.

Examples

Usage Notes

• This transformer requires explicit coordinates. To generate vertices based on geometry or spatial relationships see the Snipper, Densifier, Intersector, Clipper and various overlayer transformers.
• Aggregates are not supported. A Deaggregator may be used prior to this transformer.
• This transformer can close lines into areas, but the LineCloser may be more appropriate in some cases.

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-Based
Feature Holding	No
Dependencies	None
Aliases	2DPointAdder 3DPointAdder 2DPointReplacer 3DPointReplacer CoordinateCreator CoordinateReplacer
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 VertexCreator 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.