AreaBuilder

Category: Geometric Operators

Note: One AreaBuilder transformer can be used in place of the PolygonBuilder and DonutBuilder.

Forms area features from lines and optionally cuts out any resulting holes from their containers. The input lines must be topologically correct and must neither self-intersect nor intersect each other. They must close at their endpoints.

The Snapper, Intersector, and SelfIntersector can be used to attempt to clean data that does not meet these conditions before it enters this transformer.

If these conditions are met, any area features implied by the input lines are created.   

Only Group By attributes are preserved by this transformer.

If a Polygon List Name is specified, a list will be created on each output feature, containing an element for each input feature which contributed to that geometry, in order of appearance.

If the Create Donuts parameter was set to No, the resulting polygons are output via the AREA port. Note that no donut polygons will be created – the DonutBuilder is required for this operation. If the Create Donuts parameter was set to Yes, then the resulting polygons will have holes cut in them by any other resulting polygons they completely contained. Following this, any holes which share an common edge will be dissolved together to make a larger hole. The results are output via the AREA port.

If the Drop Holes parameter was set to Yes, the operation is the same as when the Create Donuts parameter is set to yes, except that any polygons that were holes of another polygon will not be output. Any lines that did not close are output via the UNUSED_LINE port.

If Hole List Name is specified, then a list will be created on each output feature, containing an element for each input feature which became a hole on that geometry, in order of appearance.

To form polygons without any options for dealing with holes, use the PolygonBuilder transformer.

Note: If the Geometry Handling advanced setting is set to “Rich” in the workspace, arcs and ellipses are accepted as linear features; they are otherwise rejected as point features.