MOSPREVIEW

Description

The MOSPREVIEW algorithm generates a low-resolution preview from the input mosaic project. The input is typically created by running MOSPREP. You can control the output file name, file type, and a number of options for the output format.

Parameters

mospreview(silfile, filo, ftype, foptions)

Name	Type	Caption	Length	Value range
SILFILE *	str	Source image list file	1 -
FILO *	str	Output file name	1 -
FTYPE	str	Output file type	0 - 4	PIX | RAW | TIF | XWD Default: PIX
FOPTIONS	str	Output file options	0 - 64

* Required parameter

Parameter descriptions

SILFILE

The name of an existing source-image list file created by the MOSPREP algorithm or a mosaic project created by CATALYST Professional Mosaic Tool. The file identifies the input images, and the specified order thereof, from which to create the mosaic preview.

FILO

The path and file name of the mosaic preview to create. If the output specified as FILO does not already exist, a new file will be created. The output mosaic will be a low-resolution version of the real data.

FTYPE

Specifies the output file format type, represented by a three-letter code.

The default value is PIX.

FOPTIONS

Optionally specifies the file creation options that are to be applied when creating the output file. These are specific to the file format; in each case, the default of no options is allowed. FOPTIONS can be used to specify the compression schemes, file format subtypes, and other information.

Different options are available for different file types (see the FTYPE parameter). The options are described in the 'GDB file formats' section of the CATALYST Professional online help.

Details

MOSPREVIEW generates a single file containing a low-resolution mosaic of images from the provided mosaic project (SILFILE). Typically, to create a mosaic using CATALYST Professional algorithms, you first run MOSPREP, then run MOSDEF to define the output tiling scheme, and then MOSRUN to produce the mosaic. Alternatively, after MOSPREP you can run MOSPREVIEW to produce the mosaic when you want only an approximation of the final mosaic. Before running MOSPREVIEW, you must have a source image list and have performed the necessary preparatory data processing. The source image list created by MOSPREP or the mosaic project from CATALYST Professional Mosaic Tool is the only pre-existing input required by MOSPREVIEW. When MOSPREVIEW completes, a new low-resolution mosaic file will be generated. You can view and examine this file before doing any further mosaicking. The preview file is useful, for example, to verify if the data in your mosaic project covers your area of interest.

Example

Create a preview of the mosaic prepared by MOSPREP, using GeoTIFF as the output format.

from pci.mospreview import mospreview

silfile = "Halifax/Halifax.mos"  # Mosaic project created by MOSPREP
filo = "Halifax/mosaic_preview.tif"
ftype = "TIF"   #!Output file will be GeoTIFF
foptions = ""

mospreview(silfile, filo, ftype, foptions)