Syntax

FACTORY_DEF <ReaderKeyword> PointCloudCombinerFactory
[FACTORY_NAME <factory name>]
[INPUT FEATURE_TYPE <factory type>
   [<attribute name> <attribute value>]*
   [<feature function>]*]*
[COUNT_ATTRIBUTE <attribute name>]*
[ACCUMULATE_ATTRIBUTES (yes|no|none|all|one)]
[LIST_NAME <list name>{}]
[LIST_ATTRS_TO_INCLUDE [<attrNameToIncludeInList>]* ]
[LIST_ATTRS_TO_INCLUDE_MODE (ALL|SELECTED)]
[GROUP_BY [<attribute name>+]*]
[FLUSH_WHEN_GROUPS_CHANGE (Yes|No)]
[OUTPUT MERGED FEATURE_TYPE <feature type>
   [<attribute name> <attribute value>]*
   [<feature function>]*]*
[OUTPUT <REJECTED> FEATURE_TYPE <feature type>
   [<attribute name> <attribute value>]*
   [<feature function>]*]*

Overview

   This factory is used to merge a collection of point cloud features into a 
   single point cloud feature. The points in the output cloud will have the 
   union of the point components of the merged point clouds.

   The input features may be partitioned into groups based on attribute values 
   using the GROUP_BY clause and one point cloud feature is produced for each 
   group. If the GROUP_BY clause is not specified, then all input features will 
   be processed together and a single point cloud feature will be produced.

   If the GROUP_BY clause is specified, FLUSH_WHEN_GROUPS_CHANGE (when set to Yes) 
   will cause the factory to process and output the current group immediately when 
   an attribute that does not belong to the current group is encountered.

   If the optional COUNT_ATTRIBUTE clause is given, a new attribute will be 
   created on every output feature, containing the number of input features that 
   were combined to form the output. If grouped, the output feature's count 
   attribute will have the number of input features that merged within its 
   group.

   If yes or all is specified for the ACCUMULATE_ATTRIBUTES clause, the attributes of 
   each input feature are merged onto the feature being output. If grouped, the 
   attributes of each input feature within a group are merged onto the group's 
   output feature. If no or none is specified for the clause, no user attributes will be 
   carried across from the input features to the output features. If one is specified
   for the clause, user attributes only from one input feature will be on the output 
   feature.

   The optional LIST_NAME clause is used to associate attributes with incoming feature.
   When the output feature is created, all attributes of
   each feature joining the output are added as members of the specified
   attribute list. The index in the list corresponds to the index of the
   feature's geometry in the aggregate.

   The optional LIST_ATTRS_TO_INCLUDE_MODE will specify if ALL attributes should be added to
   a list, or if only the SELECTED attributes (specified with the LIST_ATTRS_TO_INCLUDE clause)
   should be added to the list.  If this value is not specified, it defaults to ALL.

   The REJECT_INVALID_FEATURES clause specifies whether the factory will fail
   upon being supplied invalid features or output them to the <REJECTED> port.

Output Tags

   The PointCloudCombinerFactory supports the following output tag.
   
   MERGED   
   
      The output feature created by merging the input features.

   <REJECTED>
      
      The output feature that is deemed to be invalid input for any of the
      following reasons:
      - The feature has invalid geometry