ADSCOPYCORR

Description

ADSCOPYCORR copies ADS model-correction terms from one segment to another. For example, the panchromatic ADS model-correction terms can be copied to the multispectral file such that the panchromatic and multispectral models are synchronized. The transferred ADS panchromatic-correction values are valid for the multispectral file.

Parameters

adscopycorr(fili, model1, filo, model2, model)

Name	Type	Caption	Length	Value range
FILI *	str	Input file name	1 -
MODEL1 *	List[int]	Input ADS model segment	1 - 1
FILO *	str	Output file name	1 -
MODEL2 *	List[int]	ADS model segment to update	1 - 1
MODEL	List[int]	Output ADS model segment	0 - 1

* Required parameter

Parameter descriptions

FILI

The name of the source PCIDSK image file.

MODEL1

The source ADS model segment from which to copy the correction terms.

FILO

The name of the output PCIDSK image file to which to write the corrected data.

MODEL2

The ADS model segment to update.

MODEL

The segment of the output file to which to write the updated model.

If no value is specified for this parameter, a new segment will be created.

Details

ADSCOPYCORR copies the ADS model-correction terms from one ADS segment to another.

With bundled panchromatic and multispectral products, the panchromatic and multispectral files are registered in ground space. That is, if you orthorectify the as-delivered product without applying ground control, the resulting panchromatic and multispectral ortho images are registered with each other even though each contains positional errors. With these products, it is therefore true that the panchromatic and multispectral data sets contain the same errors. If the panchromatic image is biased by 10 meters, the multispectral image must also be biased by 10 meters; otherwise, the ortho images will not be registered.

With these registered image products, it is important to ensure that photogrammetric bundle adjustment does not introduce misregistration between the data sets. If the first data set requires a correction of 10 meters, exactly the same correction must be applied to the second data set. ADSCOPYCORR ensures that the products remain registered by copying the correction terms from one data set to another. This is more reliable than measuring tie points or common ground control points between the data sets, because measurement errors can result in misregistration.

Example

You have a panchromatic image and want to apply the correction to a multisprectral image.

from pci.adscopycorr import adscopycorr

fili    =   "ads_pan.pix"   # image file with correction terms to copy
model1  =   [1] # math-model segment with correction terms to copy
filo    =   "ads_ms.pix"    # image file to receive copied correction terms
model2  =   [1] # math-model segment to update or copy with correction terms
model   =   []  # create a new math-model segment with updated correction terms

adscopycorr ( fili, model1, filo, model2, model)