LINE2PNT

Description

LINE2PNT generates a point layer given an input line vector layer.

Parameters

line2pnt(fili, dbvs, filo, convmthd, dbsd, ftype, foptions)

Name	Type	Caption	Length	Value range
FILI *	str	Input file name	1 -
DBVS *	List[int]	Input line layer	1 - 1
FILO *	str	Output file name	1 -
CONVMTHD	str	Conversion method	0 - 64	MIDPOINT \| VERTICES \| INTERVAL Default: MIDPOINT
DBSD	str	Output point layer description	0 - 64
FTYPE	str	Output file type	0 - 4	Default: PIX
FOPTIONS	str	Output file options	0 - 64

* Required parameter

Parameter descriptions

FILI

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

DBVS

Specifies the input segment containing the lines for which a point segment will be constructed.

FILO

Specifies the output file name.

CONVMTHD

Specifies the conversion method to be used to create points.

Supported values are:

MIDPOINT: one point is created halfway along each line
VERTICES: each vertex in each line is converted to a point
INTERVAL: for each line, a point is created at the beginning of the line, and then at each specified interval distance along that line. The distance is specified as part of the CONVMTHD parameter: that is, CONVMTHD=INTERVAL, <sampling_interval_distance>. For example, CONVMTHD="INTERVAL,200" would create vertices every 200 units along the line. The units for the interval distance are those of the projection, often meters.

DBSD

Specifies up to 64-characters descriptor of the contents or origins of the vectors.

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
KML: Google Earth KML 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.

For PIX format, FOPTIONS defaults to BAND.

Details

LINE2PNT is used to create a point layer from a line layer. The input segment must be a line; this includes topological arc layers. The points can be generated using different methods which controls where exactly points are created. The attributes are copied from the source line layer to the output point layer.

Example

A point layer is built based on segment 28 in irvine.pix and saved to irvine.pix. The point segment will get a description of "Point Layer". The points are created by setting the CONVMTHD parameter to MIDPOINT.

from pci.line2pnt import line2pnt

fili     = "irvine.pix"     # input file
dbvs     = [28]             # input line layer
filo     = "irvine.pix"     # output file
convmthd = "MIDPOINT"       # conversion method
dbsd     = "Point Layer"    # output segment description
ftype    = ""
foptions = ""

line2pnt(fili, dbvs, filo, convmthd, dbsd, ftype, foptions)

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