Replace Raster Band
Purpose
Replace a specified band in the target raster with another raster and output the modified multiband raster. This tool is often used to replace an original band with a corrected band, update an index or quality band, or write externally computed results back to a specified band position.
For background information about raster bands, see Introduction to raster data bands.
Parameters
| Parameter | Description | Notes |
|---|---|---|
| Input original raster file | The original raster whose band needs to be replaced. | Can be a single-band or multiband raster. |
| Input replacement band raster file | The raster used to replace the specified band. | Must be single-band data. |
| Band replacement parameter settings | Select the target band index to replace. Band indices start from 1. | If not set, band 1 is replaced by default. |
| Output file | Specifies the storage location, file name, data format, data type, and NoData value for the output raster data. | See common raster output settings. |
Input and output
- Input:
- Original raster: the raster containing the band to replace.
- Replacement band raster: the data raster used to replace the target band.
- Output: a raster with the specified band replaced. Its spatial reference, extent, and resolution match the original raster.
Steps
- Open the Geoprocessing Toolbox, go to Raster Tools > Raster Processing, and start Replace Raster Band.
- Set Input original raster file.
- Set Input replacement band raster file.
- In Band selection, specify the band number to replace. Band references follow the unified iXGIS band reference rules.
- Set Output raster file.
- Click Run to generate the result.
Notes
- The original raster and replacement band raster must meet consistency requirements. Otherwise, execution will fail:
- The coordinate system must be the same.
- The resolution must be the same.
- The spatial extent must be the same.
- The replaced band keeps its original position. Only the data in that band is replaced.
Example
- To replace band 4 of the original imagery with the cloud-mask-processed band 4, set Band selection to 4.