MERGEBAND

Description

Data can be distributed with multiple bands (for example, red, green, blue, and near infra-red) that are separated into different files. MERGEBAND lets you merge and recombine multiple bands into a single PCIDSK (.pix) file.

Parameters

mergeband(mfile, filo, rpcfile)

Name	Type	Caption	Length
MFILE *	str	Input file name, directory, or text file	1 - 192
FILO *	str	Output file	1 -
RPCFILE	str	RPC text file	0 -

* Required parameter

Parameter descriptions

MFILE

Specifies a particular file or multiple files containing images to be merged. Wildcards (*) can be used.

MFILE can be set using any of the following options:

A specific data file name or directory path and file name (for example, "irvine.pix" or "c:\data\irvine.pix").
A specific file name pattern or all of the files in a folder (for example, "c:\data\*.pix" or "c:\data").
An existing text file that contains references to multiple files with, optionally, different parameter settings on a per file basis (for example, "c:\list.txt").

If the text file option is used, the following general rules apply:

Specify a .txt extension for the file containing multiple files and different parameter values.
List each set of parameters on its own line in the given order (see below).
Specify string parameters within quotation marks.
Do not specify numeric parameters within quotation marks.
A quotation mark preceded by a backslash is used as part of the string. For example, "ab\"c" is used as: ab"c.
Use an exclamation mark (!) before writing a comment in the text file.
Use semi-colons to delimit the parameters.
Leave the position between the semi-colons empty (";;") if you do not want to specify a value. Alternatively, if there are no remaining parameters to be specified on the end of a line, you may leave it blank.
Parameters in a text file may or may not be specified in the function:
- If a parameter is specified in the function and in the text file, the value provided in the text file is used.
- If a parameter is not specified in the text file, the parameter can be set in the function.

FILO

Specifies the output PCIDSK file that will contain the merged bands.

If the file already exists, the program displays an error and exits.

RPCFILE

Specifies the name of the input RPC text file that provides the coefficients that define the rational functions math model for the scene.

If this parameter is not specified, MERGEBAND automatically finds the RPC text file in the same folder as the input image files. The RPC text file name must have the same base name as one of the image file names, with the suffix "_rpc.txt".

Return Value

Returns: execution status

Type: PCI_INT

The return value is 0. This function returns only if it executes successfully; otherwise, it throws an exception.

Details

Because of CD size limitations, some high-resolution satellite data, such as IKONOS, is distributed with an RPC file and the four channels (blue, green, red, and NIR) in separate NITF or TIFF files. MERGEBAND recombines the four channels into a single multi-channel file and imports the RPC file.

The order in which the files is entered using the MFILE parameter sets the order of the channels. For example, the first file is the first channel, the second file is the second channel, and so on.

The RPC file is a text file that provides the coefficients that define the rational functions math model for the scene.

If the RPCFILE parameter is not specified, MERGEBAND automatically finds the RPC text file in the same folder as the image files. The RPC text file name must have the same base name as one of the image file names with "_rpc.txt" appended

Note: MERGEBAND assumes that the georeferencing is identical for all input files.

Example

Merge image band files in MergeBandList.txt into one PCIDSK file, called Merged.pix. MergeBandList.txt contains four lines of band file names:

"C:\Demo\po_123456_red_0000000.tif"
"C:\Demo\po_123456_grn_0000000.tif"
"C:\Demo\po_123456_blu_0000000.tif"
"C:\Demo\po_123456_nir_0000000.tif"

from pci.mergeband import mergeband

mfile   =   "MergeBandList.txt"
filo    =   "Merged.pix"
rpcfile = ""

mergeband(mfile, filo, rpcfile)

Environments	PYTHON :: EASI :: MODELER
Quick links	Description :: Parameters :: Parameter descriptions :: Return Value :: Details :: Example