RAS2POLY

Description

RAS2POLY converts a raster layer to a polygon layer.

Parameters

ras2poly(fili, dbic, filo, smoothv, dbsd, ftype, foptions)

Name	Type	Caption	Length	Value range
FILI *	str	Input file name	1 -
DBIC *	List[int]	Input raster channel	1 - 1
FILO *	str	Output file name	1 -
SMOOTHV	str	Smooth vectors	0 - 3	YES \| NO Default: YES
DBSD	str	Output segment descriptor	0 - 64	Default: Created from Raster
FTYPE	str	Output file type	0 - 4	See Parameter Details. Default: PIX
FOPTIONS	str	Output file options	0 - 64

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

FILO

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

SMOOTHV

Specifies whether or not the vector data will be smoothed (corners rounded).

If SMOOTHV is set to YES, the vector lines will be smoothed. If this parameter is set to NO, the created vector lines will follow the pixel edges exactly.

DBSD

Describes (in up to 64 characters) the contents or origins of the output data.

If this parameter is not specified, the default description is "Created from Raster".

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.

Supported file format codes include:

PIX: PCIDSK format
SHP: Shapefile format

The default value is PIX.

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.

Return Value

Returns: New segment number

Type: PCI_INT

Parameter: LASC

This function returns the number of the newly created segment.

Details

RAS2POLY creates a whole polygon layer based on an input raster. Each contiguous region of equal-valued pixels will be grouped together with polygon boundaries being created around its edge.

If the input is a thematic raster, attributes from that layer are transferred to the output polygon layer.

If you're trying to extract polygons that meet certain criteria from a raster, use EXPOLRAS.

Example

Create a whole polygon layer based on channel 6 in irvine.pix and save the output vector layer to a new file, irv6poly.pix.

from pci.ras2poly import ras2poly

fili     = "irvine.pix"      # input raster file
dbic     = [6]               # using channel 6 from irvine.pix
filo     = "irv6poly.pix"    # output file to be created
smoothv  = ""                # default, YES vectors are smoothed
dbsd     = ""                # defaults to "Created from Raster"
ftype    = ""                # default, PIX
foptions = ""                # output format options

ras2poly(fili, dbic, filo, smoothv, dbsd, ftype, foptions)

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