Clipper

The features routed into the transformer via the Clipper port identify the area against which all Clippee features are processed. The Clipper can consist of any area features (polygons, donuts, or aggregate polygons/donuts). The Clipper can also be a solid or multi-solid if the Clippee input consists of solids, points, point clouds, or aggregates of these geometries. Any invalid clipping features that are encountered will be logged with a warning and discarded.

Features to be clipped enter via the Clippee port.

Clippee features that are completely within the Clipper, and Clippee features that intersect the Clipper which were broken up into pieces. Those pieces that are on the inside of the Clipper are output via this port.

Clippee features completely outside of the Clipper are output via the Outside port, and Clippee features that intersect the Clipper which were broken up into pieces. Those pieces that are outside the clipping area are output via the this port.

Invalid Clipper features (that is, non-polygon features) as well as invalid Clippee features (i.e. features with no geometry) are output via the <Rejected> port.

If Group By attributes are selected, features with the same values in the Group By attributes are placed into the same set, and clipping occurs in each set independent of other sets.

• Single Clipper: Only a single Clipper feature will be used.
• Multiple Clippers: All Clipper features will be used.  
• Clippers First: The Clipper assumes that all Clipper features will enter the transformer before any Clippee features. Any further Clipper features that arrive after the first Clippee will be logged with a warning and discarded.

This attribute (if specified) will be added with a value of yes to any features output via either the Inside or Outside port which were cut by the transformer, and a value of no to any output features which were not changed by the transformer.

This parameter directs what action should be taken with Clippee features that lie entirely on the boundary of the clipper.

• Treat as Inside: These features that lie on the boundary are output via the Inside port.
• Treat as Outside: These features that lie on the boundary are output via the Outside port.
• Treat as Inside and Outside: Points and line segments on the boundary are duplicated and output as both Inside and Outside.

If the Create Aggregates parameter is No, then features that are clipped into multiple parts will not be aggregated, but rather each part will be output as a separate feature.

If this parameter is set to No, the Inside rasters which were clipped will be equal to the intersections of the clippers and clippees. Otherwise, the intersections will be padded by nodata so that the extents are identical to those of the input rasters.

If the Merge Attributes parameter is enabled, attributes on the Clipper will be merged onto the Clippee as defined by the parameters within the expandable group. Otherwise, no attribute merging will take place.

If an attribute on the Clipper and Clippee feature share the same name, but do not start with fme_, then they are deemed conflicted.

Merge Clipper: The Clippee feature will retain all of its own un-conflicted attributes, and will additionally acquire any un-conflicted attributes that the Clipper feature has. This mode will handle conflicted attributes based on the Conflict Resolution parameter.

Prefix Clipper: The Clippee feature will retain all of its own attributes. In addition, the Clippee will acquire attributes reflecting the Clipper feature’s attributes, with the name prefixed with the Prefix parameter.

Only Use Clipper: The Clippee feature will have all of its attributes removed, except for those that start with fme_. Then, all of the attributes and associated values of the Clipper feature will be placed onto the Clippee.

Use Clippee: If a conflict occurs, the Clippee values will be maintained.

Use Clipper: If a conflict occurs, the values of the Clipper will be transferred onto the Clippee.

If the Accumulation Mode parameter is set to Prefix Clipper, this value will prefix attributes that are being added to the Clippee feature from the Clipper feature.