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

Name	Type	Caption	Length	Value range
SILFILE *	String	Source image list file	1 - 192
FILO *	String	Output file name	1 - 192
FTYPE	String	Output file type	0 - 4	PIX | RAW | TIF | XWD Default: PIX
FOPTIONS	String	Output file options	0 - 64
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* 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.

MONITOR

The program progress can be monitored by printing the percentage of processing completed. A system parameter, MONITOR, controls this activity.

Available options are:

• ON: Turns the monitor ON (default)
• OFF: Turns the monitor OFF (recommended if running in batch or background mode)

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.

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

EASI>RUN mospreview