GRASS logo

NAME - Build polylines from lines.


vector, topology

SYNOPSIS help [-q] input=string output=string [--overwrite]


Run quietly
Force overwrite of output files


Input binary vector map
Output vector map

DESCRIPTION builds polylines from the lines in a binary vector file.

A line is a single straight line segment defined by one start node, one end node and no other nodes. A polyline is also defined by one start node, one end node and no other nodes, but is made of two or more consecutive straight line segments. The connections between the constituent line segments of a polyline do not appear as nodes in the vector map.

Polylines provide the most appropriate representation of curved lines when it is important that nodes serve to define topology rather than geometry. Curved lines are usually digitized as polylines, but these are sometimes broken into their constituent straight line segments during conversion from one data format to another. can be used to rebuild such broken polylines.


If the lines that make up a polyline are of different types, then will set the type from the first constituent line. will issue a warning unless the flag -q has been set. It is possible to keep a list of all such warnings by redirecting standard output to a file.

If the lines that make up a polyline have different attribute values then will set the attribute value of the polyline to that of the last line (this is the behaviour of, which is used to assign the attribute values). correctly handles input maps containing lines, area edges and points. Lines and area edges will be converted to polylines of the desired type. Areas are only guaranteed to be preserved if the constituent lines of the polylines that define them are all area edges in the input map.


This program was originally written during Mark Lake's tenure of a Leverhulme Special Research Fellowship at University College London.



Mark Lake, Institute of Archaeology, University College London.
Major rewrite by Radim Blazek, October 2002

Last changed: $Date: 2005/10/13 15:59:46 $

Main index - vector index - Full index