IIQCOMBINE

Description

Combine IIQ by stacking, stitching or both.

Parameters

iiqcombine(filirgb1, filirgb2, filinir, calrgb1, calrgb2, calnir, operation, filo)

Name	Type	Caption	Length	Value range
FILIRGB1 *	str	Primary Input RGB file name	1 -
FILIRGB2	str	Secondary Input RGB file name	0 -
FILINIR	str	Input NIR file name	0 -
CALRGB1 *	str	Primary RGB camera calibration file	1 -
CALRGB2	str	Secondary RGB camera calibration file	0 -
CALNIR	str	NIR calibration file	0 -
OPERATION	str	Operation to perform	0 -	STACK \| STITCH \| BOTH \| AUTO Default: AUTO
FILO *	str	Name of output file	1 -

* Required parameter

Parameter descriptions

FILIRGB1

Primary RGB Input imagery filename. When stitching, this should be the left RGB image, when stacking without stitching, this should be the only RGB image.

FILIRGB2

Secondary RGB Input imagery filename. When stitching, this should be the right RGB image, when not stitching, this parameter is not used.

FILINIR

NIR Input imagery filename when stacking. When not stacking this parameter is not used.

CALRGB1

Calibration file for the primary RGB sensor. The file must be Australis format, and not the typical camera calibration XML file use in other CATALYST algorithms. For more information on this file type, see the details section, below.

CALRGB2

Calibration file for the secondary RGB sensor. The file must be Australis format, and not the typical camera calibration XML file use in other CATALYST algorithms. For more information on this file type, see the details section, below. This parameter is required if FILIRGB2 is specified.

CALNIR

Calibration file for NIR sensor. The file must be Australis format, and not the typical camera calibration XML file use in other CATALYST algorithms. For more information on this file type, see the details section, below. This parameter is required if FILINIR is specified.

OPERATION

Operation to perform on the input images. - TODO - add default

STACK - stack RGB with NIR images
STITCH - stitch left and right images
BOTH - stitch and then stack the images
AUTO - automatically determine the operation to perform based on the input files provided

FILO

The output file to which the combined image data will be written

Return Value

Returns: Camera calibration parameters

Type: PCI_DOUBLE

Parameter: CAMPARAM

Output camera calibration parameters, usable in the CAMPARAM parameter of the GENAPMODEL algorithm. A list containing the doubles: [FOCAL LENGTH, CHIP SIZE WIDTH, CHIP SIZE HEIGHT]

FOCAL LENGTH, in mm - corresponds to the CAMPARAM[0] value in the GENAPMODEL::CAMPARAM parameter.
CHIP SIZE WIDTH, in mm - corresponds to the CAMPARAM[1] value in the GENAPMODEL::CAMPARAM parameter.
CHIP SIZE HEIGHT, in mm - corresponds to the CAMPARAM[2] value in the GENAPMODEL::CAMPARAM parameter.

These values can be used to generate a camera math model model for the combined image. Note that there are no distortion parameters in this list, as the stitching or stacking process removes all distortion.

Details

Camera calibration files must be in the Australis format, which is a text file with the following format:


System S/N  YZ000042

Camera type iXM-RS280F, Rodenstock RS-90mm/Aerial (90mm)
Camera S/N  YY000066
Lens S/N    12625968

Sensor Size	Pixel Size (mm)
    H 10652 0.00376
    V 14204 0.00376

 Camera     Final      Final
Variable    Value    Std.Error
    C      89.4886  0.0001 (mm)
   XP      17.9269  0.0002 (mm)
   YP      -0.1068  0.0002 (mm)
   K1  7.47512e-06  2.00137e-09
   K2 -3.76240e-10  2.06237e-12
   K3 -2.31736e-14  6.60533e-16
   P1 -1.69225e-06  1.01079e-08
   P2 -1.32952e-06  8.06997e-09
   B1 -6.19477e-05  1.01986e-06
   B2  3.43091e-05  9.39775e-07

The first line contains the system serial number, which is used to identify the camera system. Following lines contain the camera type, camera serial number, and lens serial number - these serial numbers are not required for this function and may be omitted. The function is smart enough to read the file and pull out only relevant information The sensor size and pixel size are specified, followed by the camera calibration parameters.

Example

In this example two RGB IIQ images are stitched together and stack with an NIR image

from pci.iiqcombine import iiqcombine

filirgb1='rgbdata/ND_4ME_0546_0024_000025L.IIQ'
filirgb2='rgbdata/ND_4ME_0546_0024_000025R.IIQ'
filinir='nirdata/NIR_4ME_0546_0024_000025.IIQ'
calrgb1='calibration/YZ000042_Calib_LEFT.txt'
calrgb2='calibration/YZ000042_Calib_RIGHT.txt'
calnir='calibration/MN010065-NIR-Calib2-AUS.txt'
operation = 'BOTH'
filo='output/combined_4ME_0546_0024_000025.pix'
# Combine the two RGB images and the NIR image
iiqcombine(filirgb1, filirgb2, filinir, calrgb1, calrgb2, calnir, operation, filo)

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