Note: The MRFCleaner transformers are available as an extra-cost package from Safe Software. Please contact sales@safe.com
or call 604-501-9985. This package includes all MRFCleaner transformers, available for Windows only (64-bit and 32-bit).
Removes a number of vertices from lines. The number of vertices removed is controlled by a weeding tolerance, which will be either (Filter Factor * Cleaning Tolerance) or (Filter Factor * value of Feature Tolerance Attribute). The latter is always used when it is valid and the Feature Tolerance attribute is specified. The larger the weeding tolerance, the more vertices will be removed.
Each feature that is output through the Cleaned port will have a new attribute "mrf_clean_status" added to specify whether the feature was modified, created, or unchanged in the cleaning process. The possible values of this attribute are "Modified", "Created" and "Original".
Output Ports
Cleaned
Each feature that is output through the Cleaned port will have a new attribute "mrf_clean_status" added to specify whether the feature was modified, created, or unchanged in the cleaning process. The possible values of this attribute are "Modified", "Created" and "Original".
Parameters
Transformer
Group By
If selected, each group of features with the same values in the Group By attributes will be processed separately from other groups.
Group By Mode
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 Using Group By
There are two typical reasons for using Process 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 a SQL ORDER BY statement) 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 a Group By value need to arrive before any features (of any feature type or dataset) belonging to the next group. In this case, using Group By with Process 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.
Parameters
Cleaning Tolerance
Cleaning tolerance is used as the default tolerance unless the Feature Tolerance Attribute is specified and valid. The minimum tolerance allowed is 0.0.
Feature Tolerance Attribute
The number of layers used in cleaning the data is determined by the number of different tolerance values of input features. Features that have the same tolerances are processed as being on the same layer.
Filter Factor
The default value of Filter Factor is 1.0 and the minimum value is 0.0.
Usage Notes
This transformer performs the same operation as the MRF2DCleaner with the Generalize Lines parameter set to Yes and no other options selected. See the MRF2DCleaner for more details.1Portions of this work are the intellectual property of the MRF Geosystems Corporation and are used under license. Copyright © 2006 MRF Geosystems Corporation. All rights reserved.
FME Licensing Level
Related Transformers
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
FME Community
The FME Community is the place for demos, how-tos, articles, FAQs, and more. Get answers to your questions, learn from other users, and suggest, vote, and comment on new features.
Search for samples and information about this transformer on the FME Community.