[GRASS-dev] [bug #4994] (grass) v.to.points manual fixed and extended

[Request Tracker]

this bug's URL: http://intevation.de/rt/webrt?serial_num=4994
-------------------------------------------------------------------------

This is a multi-part message in MIME format.
--------------060702030100020502010004
Content-Type: text/plain; charset=ISO-8859-2
Content-Transfer-Encoding: 7bit

> this bug's URL: http://intevation.de/rt/webrt?serial_num=2801

Hi!

Could somebody please apply the patch for v.to.points manual? I have
fixed and extended it following Eric's suggestions. That should let us
close bug #2801.

Thanks.

Maciek

--------------060702030100020502010004
Content-Type: text/x-patch;
 name="description.html.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="description.html.diff"

Index: description.html
===================================================================
RCS file: /home/grass/grassrepository/grass6/vector/v.to.points/description.html,v
retrieving revision 1.4
diff -u -r1.4 description.html
--- description.html	1 Jul 2006 20:32:06 -0000	1.4
+++ description.html	12 Aug 2006 12:38:15 -0000
@@ -1,19 +1,32 @@
 <h2>DESCRIPTION</h2>
 
-<em>v.to.points</em> creates points along input lines. It creates an output-dataset with 2 layers.
-Layer 1 holdes information about the line-category and its attributes, layer 2 holds
-information about the length line-category and its segment-length starting from the 0 to this point.
+<em>v.to.points</em> creates points along input lines. The output is a vector with 2 layers.
+Layer 1 holds the category and attributes of the input lines; all points created along the
+same line have the same category, equal to the category of that line. In layer 2 each point
+has it's unique category; other attributes stored in layer 2 are <em>lcat</em> - the
+category of the input line and <em>along</em> - the distance from line's start.
 
 <h2>NOTES</h2>
 
 The <em>dmax</em> parameter is the maximum limit but not an exact
 distance. To place points with exact distance from the beginning
-of the vector line the user should use <em>v.segment</em>.
+of the vector line the user should use
+<a HREF="v.segment.html">v.segment</a>.
 
+<p>
+To get points created for the beginning, middle and end only, use
+the -i switch and set <em>dmax</em> so that:
+<p>
+(length of input line / 2) <= <em>dmax</em> <= length of input line
+<p>
+So if <em>dmax</em> is between 0.5x and 1.0x the line length, you
+will always get points created at exactly the beginning, middle and
+end of the input line.
 
 <h2>EXAMPLE</h2>
 
-In this example, the 't_powerlines' vector lines map in the Spearfish
+In this example, the 't_powerlines' vector lines map in the
+<a HREF="http://grass.itc.it/download/data6.php">Spearfish 6.0</a>
 location is used to create points along the input lines:
 
 <div class="code"><pre>
@@ -32,4 +45,4 @@
 
 Radim Blazek
 
-<p><i>Last changed: $Date: 2006/07/01 20:32:06 $</i>
+<p><i>Last changed: $Date: 2006/12/08 14:01:06 $</i>

--------------060702030100020502010004--


--- Headers Follow ---

>From tutey at o2.pl  Sat Aug 12 14:43:59 2006
Return-Path: <tutey at o2.pl>
Delivered-To: grass-bugs at lists.intevation.de
Received: from kolab.intevation.de (aktaia [212.95.126.10])
	by lists.intevation.de (Postfix) with ESMTP id CFA1E1005AF
	for <grass-bugs at lists.intevation.de>; Sat, 12 Aug 2006 14:43:59 +0200 (CEST)
Received: from localhost (localhost.localdomain [127.0.0.1])
	by kolab.intevation.de (Postfix) with ESMTP id 157EB10C3C6
	for <grass-bugs at lists.intevation.de>; Sat, 12 Aug 2006 14:44:00 +0200 (CEST)
Received: from localhost (localhost.localdomain [127.0.0.1])
	by kolab.intevation.de (Postfix) with ESMTP id C6F9510D116
	for <grass-bugs at lists.intevation.de>; Sat, 12 Aug 2006 14:43:59 +0200 (CEST)
Received: from poczta.o2.pl (mx10.go2.pl [193.17.41.74])
	by kolab.intevation.de (Postfix) with ESMTP id E14D610C3C6
	for <grass-bugs at intevation.de>; Sat, 12 Aug 2006 14:43:54 +0200 (CEST)
Received: from [192.168.240.150] (aup3.neoplus.adsl.tpnet.pl [83.27.23.3])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by poczta.o2.pl (Postfix) with ESMTP id EA72258087;
	Sat, 12 Aug 2006 14:43:53 +0200 (CEST)
Message-ID: <44DDCD08.8000004 at o2.pl>
Date: Sat, 12 Aug 2006 14:43:52 +0200
From: Maciej Sieczka <tutey at o2.pl>
User-Agent: Thunderbird 1.5.0.5 (X11/20060728)
MIME-Version: 1.0
To: grass-dev <grass-dev at grass.itc.it>
Cc: grass-bugs at intevation.de, "Patton, Eric" <epatton at nrcan.gc.ca>,
	Markus Neteler <neteler at itc.it>
Subject: v.to.points manual fixed and extended
References: <20060804001038.529341006C4 at lists.intevation.de>
In-Reply-To: <20060804001038.529341006C4 at lists.intevation.de>
Content-Type: multipart/mixed;
 boundary="------------060702030100020502010004"
X-Virus-Scanned: by amavisd-new at intevation.de
X-Spam-Status: No, hits=-4.875 tagged_above=-999 required=3 tests=[AWL=0.125,
 BAYES_00=-5]
X-Spam-Level: 

-------------------------------------------- Managed by Request Tracker