Provided by: grass-doc_7.4.0-1_all bug

NAME

       d.vect  - Displays user-specified vector map in the active graphics frame.

KEYWORDS

       display, graphics, vector, level1

SYNOPSIS

       d.vect
       d.vect --help
       d.vect       [-cirs]       map=name       [layer=string]       display=string[,string,...]
       [type=string[,string,...]]       [cats=range]        [where=sql_query]        [color=name]
       [fill_color=name]         [rgb_column=name]         [zcolor=style]         [width=integer]
       [width_column=name]         [width_scale=float]         [icon=string]         [size=float]
       [size_column=name]     [rotation_column=name]     [icon_area=string]    [icon_line=string]
       [legend_label=string]             [label_layer=string]             [attribute_column=name]
       [label_color=name]     [label_bgcolor=name]    [label_bcolor=name]    [label_size=integer]
       [font=string]     [encoding=string]     [xref=string]     [yref=string]     [minreg=float]
       [maxreg=float]   [--help]  [--verbose]  [--quiet]  [--ui]

   Flags:
       -c
           Random colors according to category number (or layer number if ’layer=-1’ is given)

       -i
           Use values from ’cats’ option as feature id

       -r
           Use square root of the value of size_column
           This  makes  circle  areas  proportionate  to the size_column values instead of circle
           radius

       -s
           Do not show this layer in vector legend

       --help
           Print usage summary

       --verbose
           Verbose module output

       --quiet
           Quiet module output

       --ui
           Force launching GUI dialog

   Parameters:
       map=name [required]
           Name of vector map
           Or data source for direct OGR access

       layer=string
           Layer number or name (’-1’ for all layers)
           A single vector map  can  be  connected  to  multiple  database  tables.  This  number
           determines  which  table  to  use.  When used with direct OGR access this is the layer
           name.
           Default: 1

       display=string[,string,...] [required]
           Display
           Options: shape, cat, topo, vert, dir, zcoor
           Default: shape
           shape: Display geometry of features
           cat: Display category numbers of features
           topo: Display topology information (nodes, edges)
           vert: Display vertices of features
           dir: Display direction of linear features
           zcoor: Display z-coordinate of features (only for 3D vector maps)

       type=string[,string,...]
           Input feature type
           Options: point, line, boundary, centroid, area, face
           Default: point,line,area,face

       cats=range
           Category values
           Example: 1,3,7-9,13

       where=sql_query
           WHERE conditions of SQL statement without ’where’ keyword
           Example: income < 1000 and population >= 10000

       color=name
           Feature color
           Either a standard color name, R:G:B triplet, or "none"
           Default: black

       fill_color=name
           Area fill color
           Either a standard color name, R:G:B triplet, or "none"
           Default: 200:200:200

       rgb_column=name
           Colorize features according to color definition column
           Color definition in R:G:B form

       zcolor=style
           Colorize point or area features according to z-coordinate
           Options: aspect, aspectcolr, bcyr, bgyr, blues, byg, byr, celsius, corine,  curvature,
           differences,  elevation,  etopo2,  evi, fahrenheit, gdd, grass, greens, grey, grey.eq,
           grey.log, grey1.0, grey255, gyr,  haxby,  kelvin,  ndvi,  ndwi,  oranges,  population,
           population_dens,  precipitation,  precipitation_daily, precipitation_monthly, rainbow,
           ramp, random, reds, roygbiv, rstcurv, ryb,  ryg,  sepia,  slope,  soilmoisture,  srtm,
           srtm_plus, terrain, viridis, water, wave
            aspect: aspect oriented grey colors
            aspectcolr: aspect oriented rainbow colors
            bcyr: blue through cyan through yellow to red
            bgyr: blue through green through yellow to red
            blues: white to blue
            byg: blue through yellow to green
            byr: blue through yellow to red
            celsius: blue to red for degree Celsius temperature
            corine: EU Corine land cover colors
            curvature: for terrain curvatures (from v.surf.rst and r.slope.aspect)
            differences: differences oriented colors
            elevation: maps relative ranges of raster values to elevation color ramp
            etopo2: colors for ETOPO2 worldwide bathymetry/topography
            evi: enhanced vegetative index colors
            fahrenheit: blue to red for Fahrenheit temperature
            gdd: accumulated growing degree days
            grass: GRASS GIS green (perceptually uniform)
            greens: white to green
            grey: grey scale
            grey.eq: histogram-equalized grey scale
            grey.log: histogram logarithmic transformed grey scale
            grey1.0: grey scale for raster values between 0.0-1.0
            grey255: grey scale for raster values between 0-255
            gyr: green through yellow to red
            haxby: relative colors for bathymetry or topography
            kelvin: blue to red for temperature in Kelvin scale
            ndvi: Normalized Difference Vegetation Index colors
            ndwi: Normalized Difference Water Index colors
            oranges: white to orange
            population: color table covering human population classification breaks
            population_dens: color table covering human population density classification breaks
            precipitation: precipitation color table (0..2000mm)
            precipitation_daily: precipitation color table (0..1000mm)
            precipitation_monthly: precipitation color table (0..1000mm)
            rainbow: rainbow color table
            ramp: color ramp
            random: random color table
            reds: white to red
            roygbiv: no description
            rstcurv: terrain curvature (from r.resamp.rst)
            ryb: red through yellow to blue
            ryg: red through yellow to green
            sepia: yellowish-brown through to white
            slope: r.slope.aspect-type slope colors for raster values 0-90
            soilmoisture: soilmoisture color table (0.0-1.0)
            srtm: color palette for Shuttle Radar Topography Mission elevation
            srtm_plus:  color  palette  for  Shuttle  Radar  Topography  Mission  elevation (with
           seafloor colors)
            terrain: global elevation color table covering -11000 to +8850m
            viridis: perceptually uniform sequential color table viridis
            water: water depth
            wave: color wave

       width=integer
           Line width
           Default: 0

       width_column=name
           Name of numeric column containing line width
           These values will be scaled by width_scale

       width_scale=float
           Scale factor for width_column
           Default: 1

       icon=string
           Point and centroid symbol
           Options:   basic/arrow,   basic/arrow1,   basic/arrow2,    basic/arrow3,    basic/box,
           basic/circle,  basic/cross1, basic/cross2, basic/cross3, basic/diamond, basic/hexagon,
           basic/marker, basic/octagon,  basic/pin,  basic/pin_dot,  basic/point,  basic/pushpin,
           basic/star,   basic/triangle,  basic/x,  demo/muchomurka,  demo/smrk,  extra/4pt_star,
           extra/adcp,   extra/airport,    extra/alpha_flag,    extra/bridge,    extra/dim_arrow,
           extra/dive_flag,   extra/fiducial,   extra/fish,   extra/half-box,  extra/half-circle,
           extra/offbox_ne, extra/offbox_nw,  extra/offbox_se,  extra/offbox_sw,  extra/pentagon,
           extra/ping,    extra/ring,   extra/simple_zia,   extra/target,   geology/circle_cross,
           geology/half-arrow_left,         geology/half-arrow_right,         geology/strike_box,
           geology/strike_circle,       geology/strike_cleavage,      geology/strike_half-bowtie,
           geology/strike_line,  geology/strike_parallel,  geology/strike_triangle,  legend/area,
           legend/area_curved,    legend/line,    legend/line_crooked,    n_arrows/basic_compass,
           n_arrows/fancy_compass,  n_arrows/n_arrow1a,  n_arrows/n_arrow1b,   n_arrows/n_arrow2,
           n_arrows/n_arrow3,     n_arrows/n_arrow4,     n_arrows/n_arrow5,    n_arrows/n_arrow6,
           n_arrows/n_arrow7a,   n_arrows/n_arrow7b,   n_arrows/n_arrow8a,    n_arrows/n_arrow8b,
           n_arrows/n_arrow9
           Default: basic/x

       size=float
           Symbol size
           When used with the size_column option this becomes the scale factor
           Default: 5

       size_column=name
           Name of numeric column containing symbol size

       rotation_column=name
           Name of numeric column containing symbol rotation angle
           Measured in degrees CCW from east

       icon_area=string
           Area/boundary symbol for legend
           Options:    basic/arrow,    basic/arrow1,   basic/arrow2,   basic/arrow3,   basic/box,
           basic/circle, basic/cross1, basic/cross2, basic/cross3, basic/diamond,  basic/hexagon,
           basic/marker,  basic/octagon,  basic/pin,  basic/pin_dot,  basic/point, basic/pushpin,
           basic/star,  basic/triangle,  basic/x,  demo/muchomurka,  demo/smrk,   extra/4pt_star,
           extra/adcp,    extra/airport,    extra/alpha_flag,    extra/bridge,   extra/dim_arrow,
           extra/dive_flag,  extra/fiducial,   extra/fish,   extra/half-box,   extra/half-circle,
           extra/offbox_ne,  extra/offbox_nw,  extra/offbox_se,  extra/offbox_sw, extra/pentagon,
           extra/ping,   extra/ring,   extra/simple_zia,   extra/target,    geology/circle_cross,
           geology/half-arrow_left,         geology/half-arrow_right,         geology/strike_box,
           geology/strike_circle,      geology/strike_cleavage,       geology/strike_half-bowtie,
           geology/strike_line,  geology/strike_parallel,  geology/strike_triangle,  legend/area,
           legend/area_curved,    legend/line,    legend/line_crooked,    n_arrows/basic_compass,
           n_arrows/fancy_compass,   n_arrows/n_arrow1a,  n_arrows/n_arrow1b,  n_arrows/n_arrow2,
           n_arrows/n_arrow3,    n_arrows/n_arrow4,     n_arrows/n_arrow5,     n_arrows/n_arrow6,
           n_arrows/n_arrow7a,    n_arrows/n_arrow7b,   n_arrows/n_arrow8a,   n_arrows/n_arrow8b,
           n_arrows/n_arrow9
           Default: legend/area

       icon_line=string
           Line symbol for legend
           Options:   basic/arrow,   basic/arrow1,   basic/arrow2,    basic/arrow3,    basic/box,
           basic/circle,  basic/cross1, basic/cross2, basic/cross3, basic/diamond, basic/hexagon,
           basic/marker, basic/octagon,  basic/pin,  basic/pin_dot,  basic/point,  basic/pushpin,
           basic/star,   basic/triangle,  basic/x,  demo/muchomurka,  demo/smrk,  extra/4pt_star,
           extra/adcp,   extra/airport,    extra/alpha_flag,    extra/bridge,    extra/dim_arrow,
           extra/dive_flag,   extra/fiducial,   extra/fish,   extra/half-box,  extra/half-circle,
           extra/offbox_ne, extra/offbox_nw,  extra/offbox_se,  extra/offbox_sw,  extra/pentagon,
           extra/ping,    extra/ring,   extra/simple_zia,   extra/target,   geology/circle_cross,
           geology/half-arrow_left,         geology/half-arrow_right,         geology/strike_box,
           geology/strike_circle,       geology/strike_cleavage,      geology/strike_half-bowtie,
           geology/strike_line,  geology/strike_parallel,  geology/strike_triangle,  legend/area,
           legend/area_curved,    legend/line,    legend/line_crooked,    n_arrows/basic_compass,
           n_arrows/fancy_compass,  n_arrows/n_arrow1a,  n_arrows/n_arrow1b,   n_arrows/n_arrow2,
           n_arrows/n_arrow3,     n_arrows/n_arrow4,     n_arrows/n_arrow5,    n_arrows/n_arrow6,
           n_arrows/n_arrow7a,   n_arrows/n_arrow7b,   n_arrows/n_arrow8a,    n_arrows/n_arrow8b,
           n_arrows/n_arrow9
           Default: legend/line

       legend_label=string
           Label to display after symbol in vector legend

       label_layer=string
           Layer number for labels (default: the given layer number)
           Vector  features  can have category values in different layers. This number determines
           which layer to use. When used with direct OGR access this is the layer name.
           Default: 1

       attribute_column=name
           Name of column to be displayed as a label

       label_color=name
           Label color
           Either a standard color name or R:G:B triplet
           Default: red

       label_bgcolor=name
           Label background color
           Either a standard color name, R:G:B triplet, or "none"
           Default: none

       label_bcolor=name
           Label border color
           Either a standard color name, R:G:B triplet, or "none"
           Default: none

       label_size=integer
           Label size (pixels)
           Default: 8

       font=string
           Font name

       encoding=string
           Text encoding

       xref=string
           Label horizontal justification
           Options: left, center, right
           Default: left

       yref=string
           Label vertical justification
           Options: top, center, bottom
           Default: center

       minreg=float
           Minimum region size (average from height and width) when map is displayed

       maxreg=float
           Maximum region size (average from height and width) when map is displayed

DESCRIPTION

       d.vect displays vector maps in the active frame on the graphics monitor.

NOTES

       d.vect can simply be used typing d.vect map=vector_map.  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.

       By default d.vect areas are filled with fill_color and outlined with color. Area  outlines
       can be suppressed with
       d.vect map=vector_map color=none
       and areas can be made transparent with
       d.vect map=vector_map fill_color=none

       In order to display attributes in the map, attribute_column must be specified.

       Feature  colors  may  be specified by v.colors in a form of color table or in an attribute
       table column containing RRR:GGG:BBB values.

       A table for a vector map might look like this:
       db.select sql="select * from testisola"
       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

       To add the GRASSRGB color column, use v.db.addcolumn:
       v.db.addcolumn map=testisola columns="GRASSRGB varchar(11)"

       To add/change a color, use v.db.update:
       v.db.update map=testisola column=GRASSRGB value="123:45:237" where="cat=139"

       A much simpler method of color coding is by  using  the  -c  flag  which  displays  vector
       elements of like category number with a random color.

       This  module  can  use  FreeType/TrueType  fonts  if  they have already been selected with
       d.font.

       Parameter width is set by default to ’0’. XDRIVER  specifies  the  precise  behaviour  for
       non-zero line width, but drivers have some freedom as to how zero-width lines are handled,
       so they can use the hardware’s "thin line" drawing primitive, if it has one.  A  width  of
       zero  can  potentially result in significantly faster operation. On drivers where there is
       no such thing as a "thin" line, the driver will use a sensible default (which might not be
       the same as ’1’).

EXAMPLES

       Spearfish examples:
       # display roads with category numbers:
       d.vect map=roads display=shape,cat label_color=green
       # display randomly colorized soils map with attributes
       d.vect -c map=soils attribute_column=label
       # display randomly colorized selected vectors from soils map
       d.vect -c map=soils where="label=’VBF’" display=shape attribute_column=label

       3D points, 3D lines and 3D polygons colorized according to z height:
       g.region raster=elevation.10m
       r.random input=elevation.10m n=5000 vector=random3d -d
       d.mon start=x0
       # display as black points
       d.vect map=random3d
       # display 3D points colorized according to z height
       d.vect map=random3d zcolor=gyr
       # 3D contour lines
       r.contour input=elevation.10m output=contour20m step=20
       d.vect map=contour20m zcolor=gyr
       # generate 3D triangles
       v.delaunay input=random3d output=random3d_del
       # display 3D polygons colorized according to z height
       d.vect map=random3d_del type=area zcolor=gyr

SEE ALSO

        v.colors, d.erase, d.rast, v.colors, v.db.addcolumn, v.db.update

        GRASS SQL interface

AUTHORS

       CERL
       Radim Blazek, ITC-Irst, Trento, Italy
       Support for color tables by Martin Landa, Czech Technical University in Prague (8/2011)
       and many other GRASS developers

       Last changed: $Date: 2014-12-19 22:17:36 +0100 (Fri, 19 Dec 2014) $

SOURCE CODE

       Available at: d.vect source code (history)

       Main index | Display index | Topics index | Keywords index | Graphical index | Full index

       © 2003-2018 GRASS Development Team, GRASS GIS 7.4.0 Reference Manual