GRASS GIS: m.segline

NAME

m.segline - splitting linear entities by points

KEYWORDS

vector, line, split

SYNOPSIS

m.segline
m.segline help
m.segline input=name output=name [point=name] [file=string] snap=float [--overwrite] [--verbose] [--quiet]

Flags:

--overwrite: Allow output files to overwrite existing files
--verbose: Verbose module output
--quiet: Quiet module output

Parameters:

input=name: Input vector name
output=name: Output vector name
point=name: Input point vector
file=string: Input ascii point file (without intitulate column, field separator is 'space', col1 x and col2 y)
snap=float: snap distance (in map units)

DESCRIPTION

m.segline script allows the user to split vector lines by points. Points can be submitted from a point vector map or an ascii file (See Examples for details).

NOTES

The snap value allows the user to snap (under this threshold) splitting points on the closest line. Note that after splitting, a row is inserted in the attribute table for each new segment created but only the cat column is updated.

EXAMPLES

Splitting line vector by vector point

With snap value at 2 map units

GRASS 6.3.0 :~ > m.segline input=line1 output=line2 point=splitPT snap=2

Splitting line vector by ascii file

With snap value at 2 map units

GRASS 6.3.0 :~ > cat /tmp/splitFile
673401 1830816
GRASS 6.3.0 :~ > m.segline input=line1 output=line2 file=/tmp/splitFile snap=2

AUTHORS

Michael Rabotin, UMR LISAH, Montpellier, France

rabotin@supagro.inra.fr

Last Changed: 21 July 2010

Main index