Skip to main content
Adds a new band to a raster toRaster at a specified index toRasterIndex. The new band’s values are copied from fromRaster at a specified band index fromBand. If no toRasterIndex is provided, the new band is appended to the end of toRaster. If no fromBand is specified, band 1 from fromRaster is copied by default.
IllegalArgumentException will be thrown in these cases:
  • The provided Rasters, toRaster & fromRaster don’t have same shape.
  • The provided fromBand is not in fromRaster.
  • The provided toRasterIndex is not in or at end of toRaster.

​
Signatures

​
Parameters

​
Raster
required
The target raster.
​
Raster
required
The source raster.
​
Integer
default:"1"
The band index to copy from the source raster.
​
Integer
default:"at_end"
The index in the target raster to insert the band.

​
Return type

The resulting raster.

​
Example