You are here: Strings > AttributeRangeMapper

AttributeRangeMapper

Classifies features according to user-defined numeric value ranges, adding a new attribute containing the name of the range it falls within.

Jump to Configuration

Typical Uses

  • Creating a classification of features based on the range of a numeric value

  • Setting symbology format attributes depending on the range of a numeric value

  • Reducing complexity by mapping a range of numeric values to a single, representative value

How does it work?

The AttributeRangeMapper lets you define one or more numeric ranges, along with an output value for each. An attribute is selected to be compared against these ranges, and a new attribute is added (Output Attribute) which will contain the name (Output Value) of the first matching range.

If the attribute value does not fall within any of the defined ranges, it is assigned the Default output value (which may be left blank).

Ranges are inclusive. A value that could match more than one range will be assigned the first one it encounters. Ranges are tested in the order they are defined in the parameters dialog, Range Lookup Table. For example, given the ranges 1 - 10 and 10 - 20, the value 10 will be matched to whichever of these ranges is listed first in the lookup table.

If either From or To is left blank, the range is open-ended; that is, it will match any value greater than (if To is blank) or less than (if From is blank) what is specified.

You may automatically generate fixed-interval ranges using the Generate… option.

Usage Notes

  • Only numeric ranges are supported
  • Expressions are not supported
  • To filter features according to numeric ranges (as opposed to adding an attribute), consider using the AttributeRangeFilter.

Configuration

Input Ports

Output Ports

Parameters

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.

Defining Values

There are several ways to define a value for use in a Transformer. The simplest is to simply type in a value or string, which can include functions of various types such as attribute references, math and string functions, and workspace parameters. There are a number of tools and shortcuts that can assist in constructing values, generally available from the drop-down context menu adjacent to the value field.

Reference

Processing Behavior

Feature-Based

Feature Holding

No

Dependencies None
FME Licensing Level FME Base Edition and above
Aliases RangeMapper
History  
Categories

Strings

FME Knowledge Center

The FME Knowledge Center 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 all results about the AttributeRangeMapper on the FME Knowledge Center.

 

Examples may contain information licensed under the Open Government Licence – Vancouver