Sets the band name of selected bands on a raster, making raster contents simpler to understand compared to band numbers.

Jump to Configuration

Typical Uses

  • Adding names to raster bands for processing requirements or clarity.

How does it work?

The RasterBandNameSetter receives raster features and applies either a single name or list of names to the currently selected band or bands.

To select specific bands, use the RasterSelector prior to the RasterBandNameSetter.

Lists of names must be provided as an FME list attribute.

This transformer supports raster band selection. Palettes are unaffected.

Using a List Attribute for List of Names

When the input type is a list (Input Type = List of Names), a list attribute that contains band names must be specified.

The values in the list will be applied to the selected bands, in the order they were selected. The list must contain at least as many elements as there are selected bands. List values are used sequentially.

List Examples

Given an input raster feature with three bands and no band names, this table shows the expected output for different combinations of selected bands against the same list attribute of band names.

List Attribute*

Selected Bands*

Resulting Band Names

_bandnames{0} = 'OneDog'

_bandnames{1} = 'TwoCats'

_bandnames{2} = 'ThreeFish'




Band 0: OneDog

Band 1: TwoCats

Band 2: ThreeFish




Band 0: OneDog

Band 1:

Band 2:




Band 0: OneDog

Band 1:

Band 2: TwoCats




Band 0:

Band 1: OneDog

Band 2: TwoCats

*Band numbers start at zero (0), as do list elements. The band name list attribute may have any name.


Usage Notes

Choosing a Raster Transformer

FME has an extensive selection of transformers for working with raster data. They can be generally categorized as working with whole rasters, bands, cells or palettes, and those designed for workflow control or combining raster with vector data.

For information on raster geometry and properties, see Rasters (IFMERaster).


Input Ports

Output Ports


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.

Dialog Options - Tables

Transformers with table-style parameters have additional tools for populating and manipulating values.


Processing Behavior


Feature Holding


Dependencies None

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 all results about the RasterBandNameSetter on the FME Community.


Examples may contain information licensed under the Open Government Licence – Vancouver and/or the Open Government Licence – Canada.