BANDSIM

Combine bands to simulate spectral properties of other bands


EnvironmentsPYTHON :: EASI
Quick linksDescription :: Parameters :: Parameter descriptions :: Details :: Example

Back to top

Description


BANDSIM simulates image bands from an input image to match the spectral properties of bands from a band definition image.
Back to top

Parameters


bandsim (fili, dbic, fili_bdf, dbic_bdf, filo, ftype, foptions)

Name Type Caption Length Value range
FILI * str Input file 1 -    
DBIC List[int] Input channels 0 -   1 -
FILI_BDF * str Band definition file 1 -    
DBIC_BDF List[int] Band definition channels 0 -    
FILO * str Output file 1 -    
FTYPE str Output file type 0 - 4 Default: PIX
FOPTIONS str Output file options 0 -    

* Required parameter
Back to top

Parameter descriptions

FILI

The name of the input file.

The file must be GDB-supported type that contains the image data to use in the band simulation.

The raster data from FILI will be used to simulate the data in FILO

DBIC

The channels in the input file to use to simulate the output data.

If not specified, all channels in the input file are used.

All input channels used must be convertible to reflectance.

This parameter is optional.

FILI_BDF

The name of the band description file.

The file must be GDB-supported type that contains the image data to use in the band simulation.

This file is used as a defintion for creating FILO. The spectral properties of the channels in FILI_BDF will be used to simulate the channels in FILO.

DBIC_BDF

The channels in the band definition file to use to create simulated channels. For each channel in DBIC_BDF, one output channel is simulated using it spectral properties.

If you do not specify a value, all channels in the band definition file are used.

All band definition channels used must be convertible to reflectance.

This parameter is optional.

FILO

The path and file name of the output file to which to write the results of the process.

The output file must not exist.

Note: The bit depth of the output image channels is that of the input channels.

FTYPE

The format of the output file.

The format must be a GDB-supported type.

If you do not specify a value, the format is determined by the outfput file extension. If you specify a file name, but not the file name extension, the PCIDSK format (.pix) is used.

FOPTIONS

The options to use when creating the output file, which are specific to each format.

For example, with some formats, you can select compression schemes, subtypes, and more.

For a complete list of GDB-recognized file types, including the available options for each, see GDB-supported file formats.

This parameter is optional.

Back to top

Details

BANDSIM simulates channels based on data from an input image using the spectral properties of a band definition image, and then generates a new set of image channels.

For each definition channel in DBIC_BDF (or all channels, if empty), a channel is created in the output file by performing a linear combination of the input channels that have a wavelength range overlapping with the definition channel's wavelength range.

Each channel used in FILI and FILI_BDF must have the following metadata defined. If multiple reflectance transformations exist on a channel, the first one will be used.
Back to top

Example

from pci.bandsim import bandsim
fili = 'modis/MCD43A4.A2001132.h19v12_COMBINED.pix'
dbic = []
fili_bdf = 'spot/S6-20121204-083620-P-SEN_ORTHO_PAN.pix'
dbic_bdf = [1]
filo = 'out/bandsim.pix'
ftype = 'PIX'
foptions = ''

bandsim(fili, dbic, fili_bdf, dbic_bdf, filo, ftype, foptions)
            
          
        

© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.