Details Ticket 5060


Comment | Reply | Take | Open


Serial Number 5060
Subject v.out.ascii: Improved documentation
Area grass6
Queue grass
Requestors epatton@nrcan.gc.ca
Owner none
Status resolved
Last User Contact Mon Aug 28 17:33:44 2006 (2 yr ago)
Current Priority 30
Final Priority 70
Due No date assigned
Last Action Mon Aug 28 17:34:00 2006 (2 yr ago)
Created Mon Aug 28 17:11:50 2006 (2 yr ago)

Transaction History Ticket 5060


Mon, Aug 28 2006 17:11:50    Request created by epatton@nrcan.gc.ca  
Return-Path <epatton@nrcan.gc.ca>
Delivered-To grass-bugs@lists.intevation.de
Message-ID <0E5A77B55A57D511BB3F0002A537C26208C55B3D@s5-dar-r1.nrn.nrcan.gc.ca>
From "Patton, Eric" <epatton@nrcan.gc.ca>
To "'grass-bugs@intevation.de '" <grass-bugs@intevation.de>
Cc "'tutey@o2.pl '" <tutey@o2.pl>
Subject v.out.ascii: Improved documentation
Date Mon, 28 Aug 2006 12:11:42 -0300
MIME-Version 1.0
X-Mailer Internet Mail Service (5.5.2657.72)
Content-Type multipart/mixed; boundary="----_=_NextPart_000_01C6CAB2.EB6B47C6"
X-Virus-Scanned by amavisd-new at intevation.de
X-Spam-Status No, hits=-2.279 tagged_above=-999 required=3 tests=[AWL=-1.279, BAYES_20=-1]
X-Spam-Level
This message is in MIME format. Since your mail reader does not understand
this format, some or all of this message may not be legible.

------_=_NextPart_000_01C6CAB2.EB6B47C6
Content-Type: text/plain


Attached is some improved documentation for v.out.ascii. I've included
information on what the Grass 'standard' format is, largel based on the
description given in v.in.ascii. I've also included an example showing what
the 'standard' output looks like on the 'quads' vector in Spearfish.

Let me know if in the future you prefer the documentation improvements to be
attached as a diff file, or pasted within the email text itself.

Regards,

~ Eric.


------_=_NextPart_000_01C6CAB2.EB6B47C6
Content-Type: application/octet-stream;
	name="v.out.ascii.diff"
Content-Transfer-Encoding: quoted-printable
Content-Disposition: attachment;
	filename="v.out.ascii.diff"

--- v.out.ascii.html	2006-08-28 11:55:18.000000000 -0300=0A=
+++ v.out.ascii_improved.html	2006-08-28 11:54:56.000000000 -0300=0A=
@@ -61,6 +61,20 @@=0A=
 vector files between GRASS and other software, and for transferring =
data =0A=
 between machines.=0A=
 =0A=
+<p>=0A=
+If the <b>format</b> parameter is set to <b>standard</b>, a GRASS =
ASCII vector file will be exported, which may contain a mix of =
primitives including points, lines, boundaries, centroids, areas, =
faces, and kernels. A header will be written to the output ascii file =
containing vector metadata, if such metadata exists.=0A=
+<p>=0A=
+The primitive codes are as follows:=0A=
+<UL>=0A=
+<LI>'P': point</LI>=0A=
+<LI>'L': line</LI>=0A=
+<LI>'B': boundary</LI>=0A=
+<LI>'C': centroid</LI>=0A=
+<LI>'F': face (3D boundary)</LI>=0A=
+<LI>'K': kernel (3D centroid)</LI>=0A=
+<LI>'A': area (boundary) - better use 'B'; kept only for backward =
compatibility</LI>=0A=
+</UL>=0A=
+The coordinates are listed following the initial line containing the =
primitive code, the total number of vectors in the series, and the =
number of categories (1 for a single layer, higher for multiple =
layers). Below that 1 or several lines follow to indicate the layer =
number and the category number (ID).=0A=
 <p> =0A=
 The order of coordinates for new (standard) version of ASCII file is =
<BR><BR>=0A=
 X Y [Z]=0A=
@@ -90,6 +104,47 @@=0A=
 <em>v.to.points</em> and then exporting with <em>v.out.ascii</em> in =
=0A=
 <em>points</em> mode.=0A=
 =0A=
+<h2>EXAMPLE</h2>=0A=
+=0A=
+<h3>Example 1) - export to standard mode</h3>=0A=
+Sample ASCII polygon vector map output for 'standard' mode. =0A=
+The example can be tested in the Spearfish sample dataset:=0A=
+<p>=0A=
+<div class=3D"code"><pre>=0A=
+v.out.ascii input=3Dquads format=3Dstandard=0A=
+</pre></div>=0A=
+<p>=0A=
+<div class=3D"code"><pre>=0A=
+ORGANIZATION: US Army Const. Eng. Rsch. Lab=0A=
+DIGIT DATE:   May 1987=0A=
+DIGIT NAME:   grass=0A=
+MAP NAME:     Quads=0A=
+MAP DATE:     May 1987=0A=
+MAP SCALE:    24000=0A=
+OTHER INFO:=0A=
+ZONE:         13=0A=
+MAP THRESH:   18.288000=0A=
+VERTI:=0A=
+B  4=0A=
+ 599587.1820962 4914067.53414294=0A=
+ 589639.15126831 4913922.5687301=0A=
+ 589440.96838162 4927803.62500018=0A=
+ 599375.87959179 4927959.83330436=0A=
+B  2=0A=
+ 599375.87959179 4927959.83330436=0A=
+ 599587.1820962 4914067.53414294=0A=
+B  4=0A=
+ 599587.1820962 4914067.53414294=0A=
+ 609541.5508239 4914236.0597482=0A=
+ 609316.10665227 4928116.8490555=0A=
+ 599375.87959179 4927959.83330436=0A=
+C  1 1=0A=
+ 594125.63    4921115.58=0A=
+ 1     1=0A=
+C  1 1=0A=
+ 604433.84    4921087.1=0A=
+ 1     2=0A=
+</pre></div>=0A=
 =0A=
 <h2>SEE ALSO</h2>=0A=
 =0A=

------_=_NextPart_000_01C6CAB2.EB6B47C6--


Mon, Aug 28 2006 17:33:44    Mail sent by msieczka  
Eric,

Unfortunatelly posting patches to the bugtracker as it is now is no good
because it is hard to extract them (see how your patch looks now). Please send
this patch again to me via personal email as an attachment. Markus promised me
CVS write access soon so I will be able to apply it for you in close future.
Closing this report.

Thanks for helping!

Best,
Maciek

P.S.
I should be back to Grass for good tomorrow or the day after. I'll catch up
with your other bugtracker-related emails then.
Mon, Aug 28 2006 17:33:56    Area changed to grass6 by msieczka  
Mon, Aug 28 2006 17:34:00    Status changed to resolved by msieczka  
Comment | Reply | Take | Open

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