Aggregator

If you do not selectGroup Byattributes,then all features fall into the same group.

When you selectGroup Byattributes,this transformer will aggregate the geometries of the input features,based on the selection in theGroup Byparameter.Each group of features that have the same values for theGroup Byattributes will be processed independently of other groups.

Process At End (Blocking): This is the default behavior.Processing will only occur in this transformer once all input is present.

Process When Group Changes (Advanced): This transformer will process input groups in order.Changes of the value of the Group By parameter on the input stream will trigger processing on the currently accumulating group.This may improve overall speed (particularly with multiple,equally-sized groups),but could cause undesired behavior if input groups are not truly ordered.

Considerations for UsingGroup By

There are two typical reasons for usingProcess When Group Changes (Advanced).The first is incoming data that is intended to be processed in groups (and is already so ordered).In this case,the structure dictates Group By usage - not performance considerations.

The second possible reason is potential performance gains.

Performance gains are most likely when the data is already sorted (or read using aSQL ORDER BYstatement) since less work is required of FME.If the data needs ordering,it can be sorted in the workspace (though the added processing overhead may negate any gains).

Sorting becomes more difficult according to the number of data streams.Multiple streams of data could be almost impossible to sort into the correct order,since all features matching aGroup Byvalue need to arrive before any features (of any feature type or dataset) belonging to the next group.In this case,usingGroup BywithProcess At End (Blocking)may be the equivalent and simpler approach.

Note:Multiple feature types and features from multiple datasets will not generally naturally occur in the correct order.

As with many scenarios,testing different approaches in your workspace with your data is the only definitive way to identify performance gains.

Attributes Only: Allows for attribute aggregation and accumulation without aggregation of the feature geometries.Output features will have no geometry.

Geometry - Assemble Hierarchy: Reconstructs the hierarchical geometries defined by the input features.In this mode,a single group can output multiple heterogeneous and/or homogeneous collections.Note that this means that non-leaf nodes should have null geometries.Input features should define one or more hierarchical geometries.Remnants of the hierarchy reconstruction process are considered parts of corrupt aggregates and are therefore output via theAggregateoutput port.

Geometry - Assemble One Level: Combines all features within a group into a single heterogeneous or homogeneous collection.

If aCount Attributeis entered,then an attribute with this name will be added to each output aggregate,containing the number of features that were combined to form the aggregate.

IfKeep Input Attributesis set toYes,the attributes from the original features will be merged onto the outputAggregatefeatures.

IfKeep Input Attributesis set toNo,all attributes not specified in other parameters will be removed.

If aList Nameis specified,then all attributes of an input feature will be stored as part of a list attribute entry in the outputAggregatefeature.

Note:List attributesare not accessible from the output schema in Workbench unless they are first processed using a transformer that operates on them,such asListExploderorListConcatenator.Alternatively,AttributeExposercan be used.

Attributes can be concatenated so that the resultingAggregatefeature preserves multiple source attribute values under the same attribute name.For example,if input feature 1 has an "id" attribute of 1 and input feature 2 has an "id" attribute of 2,specifying "id" for this parameter together with a separate character of "," will cause the outputAggregatefeature to have an "id" with value "1,2".

TheSeparator Characteris used to separate elements within an attribute value string.For example,if features with attribute values of "River Rd","Marine Dr" and "HWY 1" for the attribute named "Road Name" respectively,and the Separator Character is "," (a comma followed by a space) on the output aggregate feature,the attribute "Road Name" will contain "River Rd,Marine Dr,HWY 1" as a value.

The separator character can be expressed as a regular character but it can also reference parameters and contain special characters.

Any attributes specified in this field will undergo statistical accumulation.

For example,if two input polygons have an attribute "salary" set to 30000 and 50000,then summing them would result in a "salary" of 80000 on the aggregate output.

Any attributes specified in this field will undergo statistical accumulation.

For example,if two input polygons have an attribute "salary" set to 30000 and 50000,then averaging them would result in a "salary" of 40000 on the aggregate output.

Any attributes specified in this field will undergo statistical accumulation.

For example,if two input polygons have an attribute "salary" set to 30000 and 50000,and the second polygon was 3 times larger than the first polygon,then the weighted average would be 45000.

Attributes to Average,Weighted by Areamay produce non-numeric results if some input features have zero,or no area.

Heterogeneous Collection: the output geometry will be an IFMEAggregate.

Homogeneous Collection (If Possible): if the output geometry can be made into a homogeneous collection without changing the geometry type of any of its parts,then this option will perform the conversion.

IfGeometry Name Attributeis specified,each incoming feature will store the value of this attribute as the name of the geometry it owns.This way,as the input geometries are combined to form the outputAggregatefeature,we will have transferred the geometry names onto the output features.

When theModeisGeometry - Assemble Hierarchy,the user may reconstruct hierarchical geometries either usingID and Parent ID,ID and Child ID,or all three sets of ID information (All).If a hierarchical geometry were to be represented as a tree,then each tree node would have a unique ID.Each node would refer to its parent by Parent ID and its children by child IDs.

The attribute that uniquely identifies each input node feature.This value must be unique across all input features for the Aggregator to function properly.

The attribute that identifies a node feature's parent node.

The list attribute that identifies all child nodes of a node.

If set toYes,then attributes on an input feature will be stored astraitson the geometry owned by the feature.This way as geometries are combined to form aggregates,the input attribute information is preserved.

If set toNo,then no input attributes are saved,except the input attributes of the root node feature.

IDs are used to reconstruct hierarchical geometries and may be removed after the reconstruction.SpecifyYesto keep these IDs astraits.SpecifyNoto remove these IDs.

If specified,an attribute with this name will be added to each output feature if a cycle with no root node is detected,containing the ID of one of the features in the cycle.