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>{}]
[GROUP_BY [<attribute name>]+]*
[OUTPUT MERGED 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 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.

Output Tags

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