Merges coincidental raster features into a single output raster feature, preserving and appending all bands.

Jump to Configuration

Typical Uses

  • Assembling multi-band rasters from individual band data, such as multi-sensor remote sensing sources
  • Combining multiple data bands for convenient storage or processing

How does it work?

The RasterBandCombiner receives groups of raster features with one or more bands, and appends all bands to a single output raster feature.

The rasters to be merged must align exactly. They must have the same number of columns and rows, and georeferenced rasters must have the same coordinates. The rasters may have any number and type of bands, and palettes are preserved.

The order of the input features and the order of the bands of the input features both determine the order of the bands in the output feature. The first band of the first input raster feature becomes Band 0, the second band of the first input raster feature becomes Band 1, and so on. Subsequent raster features' bands are appended sequentially, as they are received.

A Sorter transformer may be used to set the order in which the features are processed, and the RasterBandOrderer may be used to change the band order on individual rasters either before or after the RasterBandCombiner.

Input feature attributes may be optionally merged or retained as a list attribute. A count of input features may be added to a Combined Count attribute.

This transformer is unaffected by raster band and palette selection.


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
Aliases RasterBandMerger RasterMerger

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 RasterBandCombiner on the FME Community.


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