List of Transformers

You are here: Rasters > RasterMosaicker

RasterMosaicker

This transformer mosaics multiple raster features into a single raster feature.

The transformer accepts a number of input raster features, each of which has one or more bands. All the raster features have the same number of selected bands, which, in turn, have the same number of selected palettes. Each selected band from each input raster feature will be removed, mosaicked together, and then appended to a single output raster feature. As a result, the output raster feature will also have the same number of selected bands and palettes.

Input Features

  • This transformer accepts only raster features.
  • The order of the input features determines the order in which rasters will be drawn. The first raster to enter will be drawn first, then each subsequent raster will be drawn on top of any previous overlapping rasters. You can use a Sorter transformer to enforce the order in which the features are processed.
  • When there are no selected palettes or Merge Palettes is No, each band in a set must have the same band interpretation and nodata value.
  • When there are selected palettes and Merge Palettes is Yes, each band must have one selected palette, and all palettes must have the same value interpretation.

Output Ports

ClosedOutput

The output feature created by mosaicking the input features.

Parameters

Transformer

ClosedGroup By

The rasters may be organized into groups with the Group By parameter, with each group of rasters having its own output raster.

ClosedParallel Processing Level

Note: How parallel processing works with FME: see About Parallel Processing for detailed information.

This parameter determines whether or not the transformer should perform the work across parallel processes. If it is enabled, a process will be launched for each group specified by the Group By parameter.

Parallel Processing Levels

Parameter Number of Processes
No Parallelism 1
Minimal coresThe processor, or CPU, is the physical part of the computer that performs mathematical calculations. It is the most important part of a computer system. Traditional processors have only one core on the processor, meaning that at any given time, only one set of calculations is being performed. If a processor is dual-core, this means the single chip contains hardware for two processors, now called cores to distinguish them from the single chip, running simultaneously, side by side. (Source: http://www.ehow.com/facts_5730257_computer-core-processors_.html) / 2
Moderate exact number of cores
Aggressive cores x 1.5
Extreme cores x 2

For example, on a quad-core machine, minimal parallelism will result in two simultaneous FME processes. Extreme parallelism on an 8-core machine would result in 16 simultaneous processes.

You can experiment with this feature and view the information in the Windows Task Manager and the Workbench Log window.

ClosedInput is Ordered by Group

Yes: This transformer will process input groups in order. Changes on the value of the Group By parameter on the input stream will trigger batch processing on the currently accumulating group. This will improve overall speed if groups are large/complex, but could cause undesired behavior if input groups are not truly ordered.

No: This is the default behavior. Processing will only occur in this transformer once all input is present.

Alignment

ClosedSnapping Type

The Snapping Type is used if the rasters are not perfectly aligned. The first input feature defines the reference grid. The following rasters can be Resampled to this grid. For better performance, they can also be Offset to match the grid.

ClosedInterpolation Type

If the input rasters do not line up correctly or if they have different spacings, this transformer will use the selected Interpolation Type to snap and/or resample the input rasters. Nearest Neighbor is the fastest but produces the poorest image quality.  Bicubic is the slowest but produces the best image quality. Bilinear provides a reasonable intermediate option. Average 4 and Average 16 have a performance similar to Bilinear and are useful for numeric rasters such as DEMs.

Data Values

ClosedNodata Overwrites Real Data

This option specifies whether nodata values should overwrite data values in rasters that have been previously drawn. If set to Yes, any nodata overlapping real data values will overwrite the real data values. If set to No, nodata overlapping real data will not be drawn, and the real data values will be preserved.

Note that data values will always overwrite both nodata and data values.

ClosedComposite Using Alpha Band

If Composite Using Alpha Band is set to Yes, rasters will be expected to have an alpha band selected and cannot contain any palettes. Rasters will be blended according to the alpha values with the rasters they overlap instead of just being copied over them. This parameter overrides the Nodata Overwrites Data parameter because nodata values are considered completely transparent.

Palettes

ClosedMerge Palettes

This parameter specifies how palettes will be treated when present.

When set to Yes, selected palettes in each input band set will be merged to create a single palette for the output band. When set to No, selected palettes in each input band set will be accumulated on the output band without modification.

Attributes

ClosedAccumulate Attributes

If Accumulate Attributes is set to Yes, then the attributes from the original features will be merged onto the output raster features.

ClosedCount Attribute

If a Count Attribute is given, then an attribute with this name will be added to each output feature, containing the number of features that were combined to create the raster feature.

Usage Notes

This transformer supports raster band and palette selection. The RasterSelector can be used to modify selection.

Example

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

Rasters

FME Licensing Level

FME Professional edition and above

Search FME Knowledge Center

Search for samples and information about this transformer on the FME Knowledge Center.