LINE2POLY

Description

LINE2POLY generates a whole polygon vector layer given an input line vector layer. The input lines must connect in such a way to close a region for a polygon to be created there.

Parameters

Name	Type	Caption	Length	Value range
FILI *	String	Input file name	1 - 192
DBVS *	Integer	Input line layer	1 - 1
FILO	String	Output file name	0 - 192
DBSD	String	Output polygon layer description	0 - 64
FTYPE	String	Output file type	0 - 4	Default: PIX
FOPTIONS	String	Output file options	0 - 64
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILI

Specifies the name of the file containing the line layer to process.

DBVS

Specifies the vector segment containing the the lines to be converted to polygons.

FILO

Specifies the output file name.

DBSD

Specifies up to 64-characters descriptor of the contents or origins of the vectors. If defaulted, the segment descriptor is copied from the input segment

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 a online Help.

For PIX format, FOPTIONS defaults to BAND.

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

LINE2POLY is used to create a whole polygon layer given a vector line layer. To create any polygons the lines must either close on themselves (i.e. the last vertex coincides with the first vertex) or multiple lines must connect together to form a closed region. All other input shapes will be ignored. The input layer (DBVS) should not be a topo area, point or table layer. If polygons cannot be formed from the input lines, consider using VECCLEAN instead.

Example

A whole polygon layer is built based on the segment 28 in irvine.pix and is saved to a new output shapefile, polygons.shp

EASI>FILI     = "irvine.pix"    ! input file
EASI>DBVS     = 28              ! input line layer
EASI>FILO     = "polygons.shp"    ! output file
EASI>DBSD     =                 ! output segment description
EASI>FTYPE    = "SHP"           ! output format type
EASI>FOPTIONS =                 ! format options

EASI>run line2poly