<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>GRASS GIS: d.vect</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>d.vect</b></em> - Displays GRASS vector data in the active frame on the graphics monitor. <h2>KEYWORDS</h2> display <h2>SYNOPSIS</h2> <b>d.vect</b><br> <b>d.vect help</b><br> <b>d.vect</b> [-<b>vacix</b>] <b>map</b>=<em>name</em> [<b>type</b>=<em>string</em>[,<i>string</i>,...]] [<b>display</b>=<em>string</em>[,<i>string</i>,...]] [<b>attrcol</b>=<em>string</em>] [<b>icon</b>=<em>string</em>] [<b>size</b>=<em>integer</em>] [<b>layer</b>=<em>integer</em>] [<b>cats</b>=<em>range</em>] [<b>where</b>=<em>sql_query</em>] [<b>width</b>=<em>integer</em>] [<b>wcolumn</b>=<em>string</em>] [<b>wscale</b>=<em>float</em>] [<b>color</b>=<em>string</em>] [<b>fcolor</b>=<em>string</em>] [<b>rgb_column</b>=<em>string</em>] [<b>llayer</b>=<em>integer</em>] [<b>lcolor</b>=<em>string</em>] [<b>bgcolor</b>=<em>string</em>] [<b>bcolor</b>=<em>string</em>] [<b>lsize</b>=<em>integer</em>] [<b>font</b>=<em>string</em>] [<b>xref</b>=<em>string</em>] [<b>yref</b>=<em>string</em>] [<b>minreg</b>=<em>float</em>] [<b>maxreg</b>=<em>float</em>] [<b>render</b>=<em>string</em>] [--<b>verbose</b>] [--<b>quiet</b>] <h3>Flags:</h3> <DL> <DT><b>-v</b></DT> <DD>Run verbosely</DD> <DT><b>-a</b></DT> <DD>Get colors from map table column (of form RRR:GGG:BBB)</DD> <DT><b>-c</b></DT> <DD>Random colors according to category number (or layer number if 'layer=-1' is given)</DD> <DT><b>-i</b></DT> <DD>Use values from 'cats' option as line ID</DD> <DT><b>-x</b></DT> <DD>Don't add to list of vectors and commands in monitor (it won't be drawn if the monitor is refreshed)</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>map</b>=<em>name</em></DT> <DD>Name of input vector map</DD> <DT><b>type</b>=<em>string[,<i>string</i>,...]</em></DT> <DD>Type</DD> <DD>Feature type(s)</DD> <DD>Options: <em>point,line,boundary,centroid,area,face</em></DD> <DD>Default: <em>point,line,boundary,centroid,area,face</em></DD> <DT><b>display</b>=<em>string[,<i>string</i>,...]</em></DT> <DD>Display</DD> <DD>Options: <em>shape,cat,topo,dir,attr,zcoor</em></DD> <DD>Default: <em>shape</em></DD> <DT><b>attrcol</b>=<em>string</em></DT> <DD>Name of column to be displayed</DD> <DT><b>icon</b>=<em>string</em></DT> <DD>Point and centroid symbol</DD> <DD>Options: <em>demo/muchomurka,demo/smrk,basic/arrow1,basic/arrow2,basic/box,basic/circle,basic/cross1,basic/cross2,basic/diamond,basic/marker,basic/octagon,basic/point,basic/pushpin,basic/star,basic/triangle,basic/x,extra/4pt_star,extra/adcp,extra/airport,extra/alpha_flag,extra/bridge,extra/compass,extra/dive_flag,extra/fancy_compass,extra/half-circle,extra/n_arrow1,extra/offbox_ne,extra/offbox_nw,extra/offbox_se,extra/offbox_sw,extra/pentagon,extra/target</em></DD> <DD>Default: <em>basic/x</em></DD> <DT><b>size</b>=<em>integer</em></DT> <DD>Symbol size</DD> <DD>Default: <em>5</em></DD> <DT><b>layer</b>=<em>integer</em></DT> <DD>Layer number</DD> <DD>Layer number. If -1, all layers are displayed.</DD> <DD>Default: <em>1</em></DD> <DT><b>cats</b>=<em>range</em></DT> <DD>Category values</DD> <DD>Example: 1,3,7-9,13</DD> <DT><b>where</b>=<em>sql_query</em></DT> <DD>WHERE conditions of SQL statement without 'where' keyword</DD> <DD>Example: income < 1000 and inhab >= 10000</DD> <DT><b>width</b>=<em>integer</em></DT> <DD>Line width</DD> <DD>Default: <em>0</em></DD> <DT><b>wcolumn</b>=<em>string</em></DT> <DD>Name of column for line widths (these values will be scaled by wscale)</DD> <DT><b>wscale</b>=<em>float</em></DT> <DD>Scale factor for wcolumn</DD> <DD>Default: <em>1</em></DD> <DT><b>color</b>=<em>string</em></DT> <DD>Line color</DD> <DD>Default: <em>black</em></DD> <DT><b>fcolor</b>=<em>string</em></DT> <DD>Area fill color</DD> <DD>Default: <em>200:200:200</em></DD> <DT><b>rgb_column</b>=<em>string</em></DT> <DD>Name of color definition column (for use with -a flag)</DD> <DD>Default: <em>GRASSRGB</em></DD> <DT><b>llayer</b>=<em>integer</em></DT> <DD>Layer for labels (default: the given layer number)</DD> <DT><b>lcolor</b>=<em>string</em></DT> <DD>Label color</DD> <DD>Default: <em>red</em></DD> <DT><b>bgcolor</b>=<em>string</em></DT> <DD>Label background color</DD> <DD>Default: <em>none</em></DD> <DT><b>bcolor</b>=<em>string</em></DT> <DD>Label border color</DD> <DD>Default: <em>none</em></DD> <DT><b>lsize</b>=<em>integer</em></DT> <DD>Label size (pixels)</DD> <DD>Default: <em>8</em></DD> <DT><b>font</b>=<em>string</em></DT> <DD>Font name</DD> <DT><b>xref</b>=<em>string</em></DT> <DD>Label horizontal justification</DD> <DD>Options: <em>left,center,right</em></DD> <DD>Default: <em>left</em></DD> <DT><b>yref</b>=<em>string</em></DT> <DD>Label vertical justification</DD> <DD>Options: <em>top,center,bottom</em></DD> <DD>Default: <em>center</em></DD> <DT><b>minreg</b>=<em>float</em></DT> <DD>Minimum region size (average from height and width) when map is displayed</DD> <DT><b>maxreg</b>=<em>float</em></DT> <DD>Maximum region size (average from height and width) when map is displayed</DD> <DT><b>render</b>=<em>string</em></DT> <DD>Rendering method for filled polygons</DD> <DD>Options: <em>g,r,d,c,l</em></DD> <DD>Default: <em>c</em></DD> <DD><b>g</b>: use the libgis render functions (features: clipping)</DD> <DD><b>r</b>: use the raster graphics library functions (features: polylines)</DD> <DD><b>d</b>: use the display library basic functions (features: polylines)</DD> <DD><b>c</b>: use the display library clipping functions (features: clipping)</DD> <DD><b>l</b>: use the display library culling functions (features: culling, polylines)</DD> </DL> <h2>DESCRIPTION</h2> <em>d.vect</em> displays GRASS vector data in the active frame on the graphics monitor. <h2>NOTES</h2> <em>d.vect</em> can simply be used typing <tt><b>d.vect map=</b>vector_map</tt>. There are a large variety of optional parameters which allow the user to specify vector type, colors, data fields, SQL queries, label size and justification, etc. <P> By default <em>d.vect</em> fills in holes in polygons (islands). If you only want to show active areas limit the features with, e.g., "<tt>d.vect cats=1-999999</tt>". <P> In order to display attributes in the map, <em>display=attr</em> must be specified in addition to the column name (<em>attrcol</em> parameter). <P> Colors may be specified in an attribute table column named 'GRASSRGB' (which is a <tt>varchar(11)</tt> column containing <tt>RRR:GGG:BBB</tt> values), see the flag <em>-a</em>. <P> A table for a vector map might look like this: <div class="code"><pre> echo "select * from testisola" | db.select cat|label|GRASSRGB 0|no data|255:255:255 90|FRASSILONGO|23:245:67 104|LEVICO|23:145:67 139|PERGINE VALSUGANA|223:45:237 168|SANT'ORSOLA|223:45:67 190|TENNA|123:45:67 </pre></div> <P> To add the GRASSRGB color column, use <em>v.db.addcol</em>: <div class="code"><pre> v.db.addcol testisola col="GRASSRGB varchar(11)" </pre></div> <P> To add/change a color, use <em>v.db.update</em>: <div class="code"><pre> v.db.update testisola col=GRASSRGB val="123:45:237" where="cat=139" </pre></div> <P> A much simpler method of color coding is by using the <em>-c</em> flag which displays vector elements of like category number with a random color. <P> This module can use FreeType/TrueType fonts if they have already been selected with <em>d.font.freetype</em>. <h2>EXAMPLES</h2> Spearfish examples: <div class="code"><pre> # display roads with category numbers: d.vect roads display=shape,cat lcolor=green # display randomly colorized soils map with attributes d.vect -c soils disp=attr attrcol=label # display randomly colorized selected vectors from soils map d.vect -c soils where="label='VBF'" display=shape,attr attrcol=label </pre></div> <h2>SEE ALSO</h2> <em> <a HREF="d.erase.html">d.erase</a>, <a HREF="d.what.vect.html">d.what.vect</a>, <a HREF="d.rast.html">d.rast</a>, <a HREF="d.font.freetype.html">d.font.freetype</a> <a HREF="v.db.addcol.html">v.db.addcol</a> <a HREF="v.db.update.html">v.db.update</a><br> <a HREF="sql.html">GRASS SQL interface</a> </em> <h2>AUTHOR</h2> Radim Blazek, ITC-Irst, Trento, Italy <p><i>Last changed: $Date: 2007-04-25 22:34:17 +0200 (Wed, 25 Apr 2007) $</i><p> <HR> <P><a href="index.html">Main index</a> - <a href="display.html">display index</a> - <a href="full_index.html">Full index</a></P> <P>© 2003-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p> </body> </html>