top cgGeoMosaic

Map Utilities

result = cgGeoMosaic(geofile_1, geofile_2 [, FILENAME=string] [, IMAGEOUT=varies] [, MAPOUT=object] [, MISSING=varies] [, MISS_OUT=varies] [, PALETTE=PALETTE] [, /SUCCESS])

Return value

Parameters

geofile_1 in required type=string

The name of the first GeoTiff file to be combined into a mosaic. Currently the code only works with 2D images.

geofile_2 in required type=string

The name of the second GeoTiff file to be combined into a mosaic. Currently the code only works with 2D images.

Keywords

FILENAME in optional type=string

The name of the output GeoTiff file. If not provided, the user will be asked to create a name. If provided, the user will not be prompted and this name will be used.

IMAGEOUT out optional type=varies

The final image mosaic.

MAPOUT out optional type=object

A map coordinate object (cgMap) that geolocates the new image mosaic.

MISSING in optional type=varies

The missing value in the input images. If scalar value, the same value is used for both images, but may be a two-element array.

MISS_OUT in optional type=varies

The missing value of the output image. If undefined, missing[0] is used. If missing[0] is undefined, the value 0B is used.

PALETTE in optional

A 256x3 array containing the R, G, and B color vectors with which the image should be displayed. The palette will be stored with the mosaiced image. If this is not supplied, and either of the other images have a palette, it will be used instead. Images are checked for palettes in the order they are supplied to the function.

SUCCESS out optional type=boolean

This keyword is set to 1 if the function completed successfully. And to 0 otherwise.

Author information

Author:

FANNING SOFTWARE CONSULTING:

David W. Fanning 1645 Sheely Drive Fort Collins, CO 80526 USA Phone: 970-221-0438 E-mail: david@idlcoyote.com Coyote's Guide to IDL Programming: http://www.idlcoyote.com

Copyright:

Copyright (c) 2012-2013, Fanning Software Consulting, Inc.

History:

Change History:

Written, 18 August 2012. DWF. Added SUCCESS keyword 4 September 2012. DWF. Now blending overlap regions using 50% of pixel values from the two images. 14 Sept 2012. DWF. Revamp of algorithm's handing of missing values. Added MISS_OUT keyword and removed HISTOMATCH keyword because it only works for BYTE data. Restricted mosaicking to 2D images. 29 Jan 2013. DWF. Added PALETTE keyword and changed algoritm to use color palettes if available. 21 Nov 2013. DWF.