RAS2BIT

Description

RAS2BIT converts a raster layer to a bitmap layer.

Parameters

Name	Type	Caption	Length	Value range
FILI *	String	Input file name	1 - 192
DBIC *	Integer	Input raster channel	1 - 1
FILO *	String	Output file name	1 - 192
DBSD	String	Output segment descriptor	0 - 64
FTYPE	String	Output file type	0 - 4
FOPTIONS	String	Output file options	0 - 64
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILI

Specifies the file that contains the input raster channel to be processed.

DBIC

Specifies the input raster channel to be processed.

Ranges of channels or segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}. When you are not specifying a range in this way, only 48 numbers can be specified explicitly.

FILO

Specifies the name of the file to which the new bitmap layer will be saved. This file is created if it does not already exist.

DBSD

Specifies a descriptor for the output bitmap segment. Descriptor may be up to 64 characters long.

If not specified then the descriptor from the input channel is copied to the output bitmap.

FTYPE

Optionally specifies the output file format type, represented by a three- or four-letter code. The format type must be a GDB-recognized file type. If FILO specifies an existing file, FTYPE should not be specified since the existing file will be updated and its type won't be changed.

For a complete list of GDB-recognized file types and their codes, see GDB file formats in the Technical Reference section of the CATALYST Professional online Help.

FOPTIONS

Optionally specifies the file creation options 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 GDB file formats in the Technical Reference 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

RAS2BIT converts a raster layer to a 1-bit bitmap layer. The output bitmap is created for all valid pixels. Valid pixels are assigned a 1 in the bitmap, and pixels with a NoData value are assigned a 0. A raster without a NoData value produces a bitmap of the full raster.

Example

Raster in L7_ms.pix is converted to a newly created bitmap segment in a new file, RAS2BIT.pix.

EASI> FILI     = "L7_ms.pix"      ! input raster file
EASI> DBIC     = 7                ! input raster layer
EASI> FILO     = "RAS2BIT.pix"    ! output file to be created
EASI> DBSD     =                  ! default, based on input
EASI> FTYPE    =                  ! defaults to PCIDSK
EASI> FOPTIONS =                  ! output format options

EASI> run ras2bit