Sophie

Sophie

distrib > Fedora > 13 > i386 > by-pkgid > 413e0bdb3c48563b2d8d9038d07d5533 > files > 2231

grass-6.3.0-15.fc13.i686.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS: v.lrs.segment</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">

<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>

<h2>NAME</h2>
<em><b>v.lrs.segment</b></em>  - Creates points/segments from input lines, linear reference system and positions read from stdin or a file.
<h2>KEYWORDS</h2>
vector, LRS, networking
<h2>SYNOPSIS</h2>
<b>v.lrs.segment</b><br>
<b>v.lrs.segment help</b><br>
<b>v.lrs.segment</b> <b>input</b>=<em>name</em> <b>output</b>=<em>name</em>  [<b>llayer</b>=<em>integer</em>]   [<b>rsdriver</b>=<em>string</em>]   [<b>rsdatabase</b>=<em>string</em>]  <b>rstable</b>=<em>string</em>  [<b>file</b>=<em>name</em>]   [--<b>overwrite</b>]  [--<b>verbose</b>]  [--<b>quiet</b>] 

<h3>Flags:</h3>
<DL>
<DT><b>--overwrite</b></DT>
<DD>Allow output files to overwrite existing files</DD>
<DT><b>--verbose</b></DT>
<DD>Verbose module output</DD>
<DT><b>--quiet</b></DT>
<DD>Quiet module output</DD>
</DL>

<h3>Parameters:</h3>
<DL>
<DT><b>input</b>=<em>name</em></DT>
<DD>Input vector map containing lines</DD>

<DT><b>output</b>=<em>name</em></DT>
<DD>Output vector map where segments will be written</DD>

<DT><b>llayer</b>=<em>integer</em></DT>
<DD>Layer number</DD>
<DD>Line layer</DD>
<DD>Default: <em>1</em></DD>

<DT><b>rsdriver</b>=<em>string</em></DT>
<DD>Driver name for reference system table</DD>
<DD>Default: <em>dbf</em></DD>

<DT><b>rsdatabase</b>=<em>string</em></DT>
<DD>Database name for reference system table</DD>
<DD>Default: <em>$GISDBASE/$LOCATION_NAME/$MAPSET/dbf/</em></DD>

<DT><b>rstable</b>=<em>string</em></DT>
<DD>Name of the reference system table</DD>

<DT><b>file</b>=<em>name</em></DT>
<DD>Name of file containing segment rules. If not given, read from stdin.</DD>

</DL>
<h2>DESCRIPTION</h2>

<em>v.lrs.segment</em> creates points/segments from input lines,
linear reference system and positions read from <tt>standard in</tt>
or a file.
<P>
The format is as follows:<BR>

<div class="code"><pre>
P &lt;point_id&gt; &lt;line_id&gt; &lt;milepost&gt;+&lt;offset&gt; [&lt;side offset&gt;]
L &lt;segment_id&gt; &lt;line_id&gt; &lt;milepost&gt;+&lt;offset&gt; &lt;milepost&gt;+&lt;offset&gt; [&lt;side offset&gt;]
</pre></div>

<h2>NOTES</h2>

For more information and examples see the help page for <em>v.lrs.segment</em>'s
sister module, <em><a href="v.segment.html">v.segment</a></em>.

<h2>EXAMPLE</h2>

This example is written for the Spearfish dataset (it continues the example
from <em>v.lrs.create</em>).
<p>
In this example, the 'route_lrs' shall be extended for a new
position (point) along the LRS after bus stop 4:

<div class="code"><pre>
# new point on LRS
echo "P 7 22 4+180" | v.lrs.segment route_lrs out=route_lrs_new rstable=route_lrs

g.region vect=route_lrs n=n+100 s=s-100 -p
d.erase
# existing LRS
d.vect route_lrs
d.vect busstops disp=attr attr=cat size=10 bg=white lcol=blue yref=bottom
d.vect busstops icon=basic/circle fcol=blue
db.select route_lrs

# show modified map
d.vect route_lrs_new col=red
</pre></div>

<h2>TODO</h2>

Figure out how to merge result into existing LRS map and table.

<h2>SEE ALSO</h2>

<em>
<a HREF="lrs.html">LRS tutorial</a>,<br>
<a HREF="http://gisws.media.osaka-cu.ac.jp/grass04/viewpaper.php?id=50">Introducing the Linear Reference System in GRASS</a>,<br>
<a HREF="v.lrs.create.html">v.lrs.create</a>,
<a HREF="v.lrs.where.html">v.lrs.where</a>,
<a HREF="v.lrs.label.html">v.lrs.label</a>,
<a HREF="v.segment.html">v.segment</a>
</em>

<h2>AUTHOR</h2>

Radim Blazek

<p>
<i>Last changed: $Date: 2007-07-05 16:05:39 +0200 (Thu, 05 Jul 2007) $</i>
<HR>
<P><a href="index.html">Main index</a> - <a href="vector.html">vector index</a> - <a href="full_index.html">Full index</a></P>
<P>&copy; 2003-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p>
</body>
</html>