List of Transformers

You are here: Manipulators > GeometryPartExtractor

GeometryPartExtractor

Extracts or removes selected geometry parts based on a Geometry XQuery.

Note: For information about the FME geometry model, see FME Geometry.

Input Port

ClosedInput

Features with geometries.

Output Ports

ClosedProcessed

Features with newly extracted geometry parts in EXTRACT mode or original feature with selected parts removed in REMOVE mode.

ClosedUntouched

Features that were not modified by the transformer.

Parameters

Geometry Part Selection

ClosedGeometry XQuery

Use this parameter if you want to isolate only a portion of the geometry passed in to the transformer. If no criteria are specified, the action will apply to the entire geometry at all levels.

Selection can be based on structural location, geometry name, type, appearance information, traits, trait storage types, or definition reference. The syntax used is a restricted set of XQuery, where the return clause is fixed.

The basic Geometry XQuery dialog allows you to construct simple selection queries by automatically writing the necessary query based on specified test clauses. Clicking the Switch to Advanced button opens the Advanced Editor, which allows you to type a query free-form, for more expressive queries.

Note: Once you switch to Advanced mode, you will have to clear all parameters before you can return to Basic mode.

A hierarchical geometry is represented as nodes of type geometry, with attributes containing information about traits, type, and name for each geometry.

Note: Unlike other transformers that contain the Geometry XQuery parameter, this transformer requires that you specify a Geometry XQuery. If you want to extract every single part, one method is to use an XQuery that matches the "Hierarchy Position" to "Leaf Node". Alternatively, you can use a Deaggregator in hierarchy mode, which may produce more useful output.

Parameters

ClosedAction
  • Extract: Extract selected geometry parts into new features
  • Remove: Remove selected geometry parts from original feature and return pruned result

Editing Transformer Parameters

Using a set of menu options, transformer parameters can be assigned by referencing other elements in the workspace. More advanced functions, such as an advanced editor and an arithmetic editor, are also available in some transformers. To access a menu of these options, click beside the applicable parameter. For more information, see Transformer Parameter Menu Options.

Transformer Categories

Manipulators

Search FME Knowledge Center

Search for samples and information about this transformer on the FME Knowledge Center.

Tags Keywords: GeometryPartRemover