GME

Geospatial Modelling Environment

convert.pointstolines (Convert Points To Lines)

Converts points to lines (polylines)

Description

This tool converts the points in a point data source to lines (polylines) in a new or existing line data source. An integer unique ID field in the point attribute table is required to distinguish between different output lines, and another integer field is required that defines the order in which points will be connected. This order field does not have to start at 1 for each line, so if your point attribute table is already ordered you can either use the FID field, or better yet add a suitable order field using the addcodedfield command.

The split option controls whether a single polyline is written for each unique ID (the default), or whether each line segment connecting a pair of sequential points is written as a separate line in the output data source.

Syntax

convert.pointstolines(in, uidfield, orderfield, out, [split], [where]);

inthe input point data source
uidfieldthe unique ID field in the point data source that identifies collections of points that make up each line)
orderfieldthe point attribute field that can be used to sort the points into the correct order (must be numeric or date, but not a date stored as a text field)
outthe output line data source
[split](TRUE/FALSE) if TRUE, writes each line segment connecting a pair of sequential points as a separate line (default=FALSE)
[where]the selection statement that will be applied to the feature data source to identify a subset of features to process (see full Help documentation for further details)

Example

convert.pointstolines(in="C:\data\telemetry.shp", uidfield="ANID", orderfield="STEP", split=TRUE, out="C:\data\anpaths.shp");

convert.pointstolines(in="C:\data\samplelocs.shp", uidfield="SAMPID", orderfield="ORDER", out="C:\data\transects.shp");


Messages

Please consider making a purchase to support the continued development of these tools  Read more...

An apology for failing to respond to correspondence in recent months  Read more...

Tips on how to use this interface efficiently  Read more...

Sign up for the newsletter if you wish to receive notification of updates, new functionality, bug fixes, and other related news

Links

Open Source GIS

Copyright © 2001-2012 Hawthorne L. Beyer, Ph.D., Spatial Ecology LLC    Connect on LinkedIn