Details Ticket 4437


Comment | Reply | Take | Resolve


Serial Number 4437
Subject v.in.ascii & 'Vector ASCII Format Specification' differ
Area doc-grass6
Queue grass
Requestors tutey@o2.pl
Owner none
Status open
Last User Contact Fri Jul 7 16:05:23 2006 (2 yr ago)
Current Priority 30
Final Priority 70
Due No date assigned
Last Action Wed Jul 26 18:33:41 2006 (2 yr ago)
Created Tue May 9 13:59:46 2006 (2 yr ago)

Transaction History Ticket 4437


Tue, May 9 2006 13:59:46    Request created by guest  
Subject: v.in.ascii & 'Vector ASCII Format Specification' differ

Platform: GNU/Linux/x86
grass obtained from: CVS
grass binary for platform: Compiled from Sources
GRASS Version: 2006-05-08

Vector ASCII Format Specification (http://freegis.org/cgi-bin/viewcvs.cgi/~checkout~/grass6/doc/vect
or/vector.html#ascii)
says the following:

P point (dot)
p dead point (dead dot)
L line
l dead line
B(A) boundary
b(a) dead boundary
C centroid
c dead centroid 

while v.in.ascii help says:

'P': point
'L': line
'B': boundary
'C': centroid
'F': face
'K': kernel
'A': area (boundary) - better use 'B'; kept only for backward compatibility
There are differences. What is the actuall, full information?

Maciek
Tue, May 9 2006 14:24:20    Mail sent by hamish_nospam@yahoo.com  
Return-Path <hamish_nospam@yahoo.com>
Delivered-To grass-bugs@lists.intevation.de
Date Wed, 10 May 2006 00:23:57 +1200
From Hamish <hamish_nospam@yahoo.com>
To Request Tracker <grass-bugs@intevation.de>
Cc grass-dev@grass.itc.it
Subject Re: [GRASS-dev] [bug #4437] (grass) v.in.ascii & 'Vector ASCII Format Specification' differ
Message-Id <20060510002357.438c6d42.hamish_nospam@yahoo.com>
In-Reply-To <20060509115946.A70BE1006A2@lists.intevation.de>
References <20060509115946.A70BE1006A2@lists.intevation.de>
X-Mailer Sylpheed version 1.0.4 (GTK+ 1.2.10; i386-pc-linux-gnu)
X-Face M<EoB)"*Z~u!,vFhXmw}R_KbdBta*P_=T|rbBL'e1/CQ9;/1g\BU3&!=y8ria$2Uk!HT&BB 8i?|X_+7~1jsy}F~g$2va%3fV`*=L(*cem[@3\yg,G,@rg6/QMJ
Mime-Version 1.0
Content-Type text/plain; charset=US-ASCII
Content-Transfer-Encoding 7bit
X-Spam-Status No, hits=-4.0 tagged_above=-999.0 required=3.0 tests=BAYES_00, FORGED_YAHOO_RCVD
X-Spam-Level
> this bug's URL: http://intevation.de/rt/webrt?serial_num=4437
> ---------------------------------------------------------------------
> 
> Subject: v.in.ascii & 'Vector ASCII Format Specification' differ
> 
> Platform: GNU/Linux/x86
> grass obtained from: CVS
> grass binary for platform: Compiled from Sources
> GRASS Version: 2006-05-08
> 
> Vector ASCII Format Specification
> (http://freegis.org/cgi-bin/viewcvs.cgi/~checkout~/grass6/doc/vector/
> vector.html#ascii) says the following:
> 
> P point (dot)
> p dead point (dead dot)
> L line
> l dead line
> B(A) boundary
> b(a) dead boundary
> C centroid
> c dead centroid 
> 
> while v.in.ascii help says:
> 
> 'P': point
> 'L': line
> 'B': boundary
> 'C': centroid
> 'F': face
> 'K': kernel
> 'A': area (boundary) - better use 'B'; kept only for backward
> compatibility
> 
> There are differences. What is the actuall, full information?


lower case letters were (are) used by the old GRASS 5 v.digit to delete
features. They weren't actually deleted from the file until you ran an
optional clean step on the map. With GRASS 6 we have new 3D options
face and kernel.
Lines starting with "#" are skipped. Not sure what happens with blank
lines.

Check the "switch(ctype){ " control list here for what actually happens:

http://freegis.org/cgi-bin/viewcvs.cgi/grass6/vector/v.in.ascii/a2b.c?rev=HEAD&content-type=text/vnd
.viewcvs-markup
Hamish


Tue, Jul 4 2006 15:16:21    Mail sent by mneteler  
Hi,

am I right that Hamish updated the manual?

Markus
Tue, Jul 4 2006 23:21:05    Mail sent by werchowyna@epf.pl  
Return-Path <werchowyna@epf.pl>
Delivered-To grass-bugs@lists.intevation.de
Date Tue, 4 Jul 2006 23:21:07 +0200
From Maciek Sieczka <werchowyna@epf.pl>
To Markus Neteler via RT <grass-bugs@intevation.de>
Cc neteler@itc.it
Subject Re: [bug #4437] (grass) v.in.ascii & 'Vector ASCII Format Specification' differ
Message-Id <20060704232107.a226afec.werchowyna@epf.pl>
In-Reply-To <20060704131621.1ADB31005CA@lists.intevation.de>
References <20060704131621.1ADB31005CA@lists.intevation.de>
X-Mailer Sylpheed version 2.1.1 (GTK+ 2.8.6; i486-pc-linux-gnu)
Mime-Version 1.0
Content-Type text/plain; charset=US-ASCII
Content-Transfer-Encoding 7bit
X-Virus-Scanned by amavisd-new at intevation.de
X-Spam-Status No, hits=-3.422 tagged_above=-999 required=4 tests=[AWL=1.527, BAYES_00=-5, RCVD_BY_IP=0.051]
X-Spam-Level
On Tue,  4 Jul 2006 15:16:21 +0200 (CEST)
Markus Neteler via RT <grass-bugs@intevation.de> wrote:

> am I right that Hamish updated the manual?

There was an update in the v.in.ascii manual. However, there are still
differences between the manual and
http://freegis.org/cgi-bin/viewcvs.cgi/~checkout~/grass6/doc/vector/vector.html#ascii
regarding vector feature types.

v.in.ascci is missig the lowercase ("mark as deleted") types. Are they
still supported in Grass 6.1? v.in.ascii man contains more usefull
comments which are missing in "GRASS 5.7/6 Vector Format and API"
description.

I believe both documents should give exactly the same information, to
avoid confussion. 

I don't know what is the right, actuall information though.

Maciek

------------------------------------------------------------------------
CIEP?E KRAJE - CIEP?E MORZA. Szukasz atrakcyjnego wypoczynku w przyst?pnej cenie,
zapoznaj si? z nasz? ofert?.
ZAPRASZAMY

www.skarpatravel.pl


Wed, Jul 5 2006 16:12:38    Mail sent by hamish_nospam@yahoo.com  
Return-Path <hamish_nospam@yahoo.com>
Delivered-To grass-bugs@lists.intevation.de
Date Thu, 6 Jul 2006 02:12:30 +1200
From Hamish <hamish_nospam@yahoo.com>
To grass-bugs@intevation.de
Cc grass-dev@grass.itc.it
Subject Re: [GRASS-dev] Re: [bug #4437] (grass) v.in.ascii & 'Vector ASCII Format Specification' differ
Message-Id <20060706021230.453a3c3f.hamish_nospam@yahoo.com>
In-Reply-To <20060705094218.GB2923@bartok.itc.it>
References <20060704131621.1ADB31005CA@lists.intevation.de> <20060704232107.a226afec.werchowyna@epf.pl> <20060705094218.GB2923@bartok.itc.it>
X-Mailer Sylpheed version 1.0.4 (GTK+ 1.2.10; i386-pc-linux-gnu)
X-Face M<EoB)"*Z~u!,vFhXmw}R_KbdBta*P_=T|rbBL'e1/CQ9;/1g\BU3&!=y8ria$2Uk!HT&BB 8i?|X_+7~1jsy}F~g$2va%3fV`*=L(*cem[@3\yg,G,@rg6/QMJ
Mime-Version 1.0
Content-Type text/plain; charset=US-ASCII
Content-Transfer-Encoding 7bit
X-Virus-Scanned by amavisd-new at intevation.de
X-Spam-Status No, hits=-1.493 tagged_above=-999 required=4 tests=[AWL=1.412, BAYES_00=-5, FORGED_YAHOO_RCVD=2.095]
X-Spam-Level
"v.in.ascii & 'Vector ASCII Format Specification' differ"
  https://intevation.de/rt/webrt?serial_num=4437

Markus:
> > > am I right that Hamish updated the manual?

yes, sorry I should have closed this bug some time ago.
[doing so now]

Maciek:
> > There was an update in the v.in.ascii manual.

more to the point, the vector specification linked below was updated to
meet reality.

> > However, there are still differences between the manual and
> > http://freegis.org/cgi-bin/viewcvs.cgi/~checkout~/grass6/doc/vector/vector.html#ascii
> > regarding vector feature types.
> > 
> > v.in.ascci is missig the lowercase ("mark as deleted") types.

I don't think it's a problem, the lower case versions aren't worthy of
mention in the v.in.ascii help page as they represent deleted features
which will be skipped during import.

> > Are they still supported in Grass 6.1?

yes, but that just means that they are ignored.

> > v.in.ascii man contains more usefull comments which are missing in
> > "GRASS 5.7/6 Vector Format and API" description.

the vector format specification is not a tutorial.
which comments do you think should be added to the specification?

> > I believe both documents should give exactly the same information,
> > to avoid confussion. 

yes, the technical info should (& does?) match, but I don't think we
should clutter the specification with redundant examples.

> > I don't know what is the right, actuall information though.

no erroneous info should remain. reopen the bug if you see a conflict.



Hamish


Wed, Jul 5 2006 16:14:46    Status changed to resolved by hbowman  
Wed, Jul 5 2006 18:52:32    Mail sent by werchowyna@epf.pl  
Return-Path <werchowyna@epf.pl>
Delivered-To grass-bugs@lists.intevation.de
Date Wed, 5 Jul 2006 18:52:39 +0200
From Maciek Sieczka <werchowyna@epf.pl>
To grass-bugs@intevation.de
Cc hamish_nospam@yahoo.com, neteler@itc.it
Subject Re: [bug #4437] (grass) v.in.ascii & 'Vector ASCII
Message-Id <20060705185239.7fbd7947.werchowyna@epf.pl>
In-Reply-To <20060705141238.695371006B7@lists.intevation.de>
References <20060705141238.695371006B7@lists.intevation.de>
X-Mailer Sylpheed version 2.1.1 (GTK+ 2.8.6; i486-pc-linux-gnu)
Mime-Version 1.0
Content-Type text/plain; charset=US-ASCII
Content-Transfer-Encoding 7bit
X-Virus-Scanned by amavisd-new at intevation.de
X-Spam-Status No, hits=-3.432 tagged_above=-999 required=4 tests=[AWL=1.517, BAYES_00=-5, RCVD_BY_IP=0.051]
X-Spam-Level
On Wed,  5 Jul 2006 16:12:38 +0200 (CEST)
Hamish via RT <grass-bugs@intevation.de> wrote:

> "v.in.ascii & 'Vector ASCII Format Specification' differ"
>   https://intevation.de/rt/webrt?serial_num=4437
> 
> Markus:
> > > > am I right that Hamish updated the manual?
> 
> yes, sorry I should have closed this bug some time ago.
> [doing so now]
> 
> Maciek:
> > > There was an update in the v.in.ascii manual.
> 
> more to the point, the vector specification linked below was updated
> to meet reality.
> 
> > > However, there are still differences between the manual and
> > > http://freegis.org/cgi-bin/viewcvs.cgi/~checkout~/grass6/doc/vector/vector.html#ascii
> > > regarding vector feature types.
> > > 
> > > v.in.ascci is missig the lowercase ("mark as deleted") types.
> 
> I don't think it's a problem, the lower case versions aren't worthy of
> mention in the v.in.ascii help page as they represent deleted features
> which will be skipped during import.


> > > Are they still supported in Grass 6.1?
> 
> yes, but that just means that they are ignored.

OK, so this should be mentioned in "GRASS 5.7/6 Vector Format and API".
Which will also explain why lower case features are not mentioned in
v.in.ascii manual.

> > > v.in.ascii man contains more usefull comments which are missing in
> > > "GRASS 5.7/6 Vector Format and API" description.
> 
> the vector format specification is not a tutorial.
> which comments do you think should be added to the specification?

Propably only the "B" and "A" case, which is explained in v.in.ascii
manual.

> > > I believe both documents should give exactly the same information,
> > > to avoid confussion. 
> 
> yes, the technical info should (& does?) match, but I don't think we
> should clutter the specification with redundant examples.

Am I asking for cluttering anything?

Maciek

--------------------
W polskim Internecie s? setki milion?w stron. My przekazujemy Tobie tylko najlepsze
z nich!
http://katalog.panoramainternetu.pl/


Wed, Jul 5 2006 18:52:32    Status changed to open by _rt_system  
Thu, Jul 6 2006 08:53:37    Mail sent by hamish_nospam@yahoo.com  
Return-Path <hamish_nospam@yahoo.com>
Delivered-To grass-bugs@lists.intevation.de
Date Thu, 6 Jul 2006 18:53:24 +1200
From Hamish <hamish_nospam@yahoo.com>
To Maciek Sieczka <werchowyna@epf.pl>
Cc grass-bugs@intevation.de, neteler@itc.it
Subject Re: [bug #4437] (grass) v.in.ascii & 'Vector ASCII
Message-Id <20060706185324.6a14b31e.hamish_nospam@yahoo.com>
In-Reply-To <20060705185239.7fbd7947.werchowyna@epf.pl>
References <20060705141238.695371006B7@lists.intevation.de> <20060705185239.7fbd7947.werchowyna@epf.pl>
X-Mailer Sylpheed version 1.0.4 (GTK+ 1.2.10; i386-pc-linux-gnu)
X-Face M<EoB)"*Z~u!,vFhXmw}R_KbdBta*P_=T|rbBL'e1/CQ9;/1g\BU3&!=y8ria$2Uk!HT&BB 8i?|X_+7~1jsy}F~g$2va%3fV`*=L(*cem[@3\yg,G,@rg6/QMJ
Mime-Version 1.0
Content-Type text/plain; charset=US-ASCII
Content-Transfer-Encoding 7bit
X-Virus-Scanned by amavisd-new at intevation.de
X-Spam-Status No, hits=-1.506 tagged_above=-999 required=4 tests=[AWL=1.399, BAYES_00=-5, FORGED_YAHOO_RCVD=2.095]
X-Spam-Level
> > the lower case versions aren't worthy of mention in the v.in.ascii
> > help page as they represent deleted features which will be skipped
> > during import.
> 
> > > > Are they still supported in Grass 6.1?
> > 
> > yes, but that just means that they are ignored.
> 
> OK, so this should be mentioned in "GRASS 5.7/6 Vector Format and
> API". Which will also explain why lower case features are not
> mentioned in v.in.ascii manual.
> 
> > > > v.in.ascii man contains more usefull comments which are missing
> > > > in "GRASS 5.7/6 Vector Format and API" description.
> > 
> > the vector format specification is not a tutorial.
> > which comments do you think should be added to the specification?
> 
> Propably only the "B" and "A" case, which is explained in v.in.ascii
> manual.


I just re-read grass6/doc/vector/vector.html and you are right- it is a
bit thin on details. I must have remembered that text from somewhere
else.

I'll update it to describe what "dead" vector features mean and
something about "A"rea features being superseded by "B"oundaries.
AFAIK, 6.1's v.digit makes features "dead" too, which could be part of a
future undo ability? "zombie" might be closer than "dead".


Hamish


Thu, Jul 6 2006 09:09:31    Mail sent by neteler@itc.it  
Return-Path <neteler@itc.it>
Delivered-To grass-bugs@lists.intevation.de
Date Thu, 6 Jul 2006 09:09:28 +0200
From Markus Neteler <neteler@itc.it>
To Hamish <hamish_nospam@yahoo.com>
Cc Maciek Sieczka <werchowyna@epf.pl>, grass-bugs@intevation.de
Subject Re: [bug #4437] (grass) v.in.ascii & 'Vector ASCII
Message-ID <20060706070928.GA27935@bartok.itc.it>
References <20060705141238.695371006B7@lists.intevation.de> <20060705185239.7fbd7947.werchowyna@epf.pl> <20060706185324.6a14b31e.hamish_nospam@yahoo.com>
Mime-Version 1.0
Content-Type text/plain; charset=us-ascii
Content-Disposition inline
In-Reply-To <20060706185324.6a14b31e.hamish_nospam@yahoo.com>
X-PGP-Key http://www.gdf-hannover.de/neteler/markus_gpgkey.asc
X-PGP-Fingerprint D4D5 2F80 120E AD60 E2F6 2297 21B3 D02B E1E7 E789
User-Agent Mutt/1.5.11
X-Virus-Scanned by amavisd-new at intevation.de
X-Spam-Status No, hits=-3.459 tagged_above=-999 required=4 tests=[AWL=1.275, BAYES_00=-5, FORGED_RCVD_HELO=0.266]
X-Spam-Level
On Thu, Jul 06, 2006 at 06:53:24PM +1200, Hamish wrote:
> > > the lower case versions aren't worthy of mention in the v.in.ascii
> > > help page as they represent deleted features which will be skipped
> > > during import.
> > 
> > > > > Are they still supported in Grass 6.1?
> > > 
> > > yes, but that just means that they are ignored.
> > 
> > OK, so this should be mentioned in "GRASS 5.7/6 Vector Format and
> > API". Which will also explain why lower case features are not
> > mentioned in v.in.ascii manual.
> > 
> > > > > v.in.ascii man contains more usefull comments which are missing
> > > > > in "GRASS 5.7/6 Vector Format and API" description.
> > > 
> > > the vector format specification is not a tutorial.
> > > which comments do you think should be added to the specification?
> > 
> > Propably only the "B" and "A" case, which is explained in v.in.ascii
> > manual.
> 
> 
> I just re-read grass6/doc/vector/vector.html and you are right- it is a
> bit thin on details. I must have remembered that text from somewhere
> else.


Let me suggest to retire doc/vector/vector.html and add
everything in
lib/vector/vectorlib.dox

Many parts I have already transferred, but description duplication
creates confusion. Everything in lib/vector/vectorlib.dox automagically
appears in the programmer's manual. The syntax is nearly
identical.

thanks...!

 Markus
 
> I'll update it to describe what "dead" vector features mean and
> something about "A"rea features being superseded by "B"oundaries.
> AFAIK, 6.1's v.digit makes features "dead" too, which could be part of a
> future undo ability? "zombie" might be closer than "dead".
> 
> 
> Hamish

-- 
Markus Neteler  <neteler itc it>  http://mpa.itc.it/markus/
ITC-irst -  Centro per la Ricerca Scientifica e Tecnologica
MPBA - Predictive Models for Biol. & Environ. Data Analysis
Via Sommarive, 18        -       38050 Povo (Trento), Italy


Fri, Jul 7 2006 16:05:23    Mail sent by neteler@itc.it  
Return-Path <neteler@itc.it>
Delivered-To grass-bugs@lists.intevation.de
Date Fri, 7 Jul 2006 16:05:19 +0200
From Markus Neteler <neteler@itc.it>
To Hamish <hamish_nospam@yahoo.com>
Cc Maciek Sieczka <werchowyna@epf.pl>, grass-bugs@intevation.de
Subject Re: [bug #4437] (grass) v.in.ascii & 'Vector ASCII
Message-ID <20060707140519.GA22272@bartok.itc.it>
References <20060705141238.695371006B7@lists.intevation.de> <20060705185239.7fbd7947.werchowyna@epf.pl> <20060706185324.6a14b31e.hamish_nospam@yahoo.com> <20060706070928.GA27935@bartok.itc.it>
Mime-Version 1.0
Content-Type text/plain; charset=us-ascii
Content-Disposition inline
In-Reply-To <20060706070928.GA27935@bartok.itc.it>
X-PGP-Key http://www.gdf-hannover.de/neteler/markus_gpgkey.asc
X-PGP-Fingerprint D4D5 2F80 120E AD60 E2F6 2297 21B3 D02B E1E7 E789
User-Agent Mutt/1.5.11
X-Virus-Scanned by amavisd-new at intevation.de
X-Spam-Status No, hits=-3.519 tagged_above=-999 required=4 tests=[AWL=1.215, BAYES_00=-5, FORGED_RCVD_HELO=0.266]
X-Spam-Level
On Thu, Jul 06, 2006 at 09:09:28AM +0200, Markus Neteler wrote:
> On Thu, Jul 06, 2006 at 06:53:24PM +1200, Hamish wrote:
> > > > the lower case versions aren't worthy of mention in the v.in.ascii
> > > > help page as they represent deleted features which will be skipped
> > > > during import.
> > > 
> > > > > > Are they still supported in Grass 6.1?
> > > > 
> > > > yes, but that just means that they are ignored.
> > > 
> > > OK, so this should be mentioned in "GRASS 5.7/6 Vector Format and
> > > API". Which will also explain why lower case features are not
> > > mentioned in v.in.ascii manual.
> > > 
> > > > > > v.in.ascii man contains more usefull comments which are missing
> > > > > > in "GRASS 5.7/6 Vector Format and API" description.
> > > > 
> > > > the vector format specification is not a tutorial.
> > > > which comments do you think should be added to the specification?
> > > 
> > > Propably only the "B" and "A" case, which is explained in v.in.ascii
> > > manual.
> > 
> > 
> > I just re-read grass6/doc/vector/vector.html and you are right- it is a
> > bit thin on details. I must have remembered that text from somewhere
> > else.
> 
> 
> Let me suggest to retire doc/vector/vector.html and add
> everything in
> lib/vector/vectorlib.dox

OK, almost done!
I have merged most stuff from
 doc/vector/vector.html
into
 lib/vector/vectorlib.dox

The rebuilt of the progman is currently running to show
the improvements online.

The improvement of the ASCII description (transfer of remaining
stuff from doc/vector/vector.html to vector/v.in.ascii/description.html)
I would leave to someone else.

cheers

 markus


Wed, Jul 26 2006 18:33:41    User changed to tutey@o2.pl by msieczka  
Comment | Reply | Take | Resolve

You are currently authenticated as guest.
[Show Configuration] [Login as another user]

Users Guide - Mail Commands - Homepage of RequestTracker 1.0.7 - list any request