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.
When there are gaps in data (that is, an area is not covered by any raster), the empty cells will be filled with nodata values if available, or zero if not.
The output feature created by mosaicking the input features.
The rasters may be organized into groups with the Group By parameter, with each group of rasters having its own output raster.
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.
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.
No: This is the default behavior. Processing will only occur in this transformer once all input is present.
By Group: 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.
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.
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.
This option specifies how output cell values will be calculated when multiple rasters overlap.
Note that the Average, Sum, and Composite Using Alpha Band options are not compatible with palettes.
When all values for a cell are nodata, the output value will be nodata.
When Overlapping Values is set to Last, 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 be ignored, and the real data values will be preserved.
Note that data values will always overwrite both nodata and data values.
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.
If Accumulate Attributes is set to Yes, then the attributes from the original features will be merged onto the output raster features.
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.
This transformer supports raster band and palette selection. The RasterSelector can be used to modify selection.
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.
FME Professional edition and above
Associated FME function or factory: RasterMosaicFactory
Search for samples and information about this transformer on the FME Knowledge Center.