xenial (1) d.vect.thematic.1grass.gz

Provided by: grass-doc_7.0.3-1build1_all bug

NAME

       d.vect.thematic  - Displays a thematic vector map in the active graphics frame.

KEYWORDS

       display, cartography, choropleth map, legend

SYNOPSIS

       d.vect.thematic
       d.vect.thematic --help
       d.vect.thematic    [-len]    map=name     [layer=string]     column=name     [breaks=string[,string,...]]
       [algorithm=string]         [nclasses=integer]        colors=string[,string,...]         [where=sql_query]
       [boundary_width=integer]      [boundary_color=name]      [legendfile=name]      [--overwrite]    [--help]
       [--verbose]  [--quiet]  [--ui]

   Flags:
       -l
           Create legend information and send to stdout

       -e
           When printing legend info, include extended statistical info from classification algorithm

       -n
           Do not draw map, only output the legend

       --overwrite
           Allow output files to overwrite existing files

       --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
           Layer number. If -1, all layers are displayed.
           Default: 1

       column=name [required]
           Name of attribute column to be classified

       breaks=string[,string,...]
           Class breaks, without minimum and maximum

       algorithm=string
           Algorithm to use for classification
           Options: int, std, qua, equ, dis
           int: simple intervals
           std: standard deviations
           qua: quantiles
           equ: equiprobable (normal distribution)

       nclasses=integer
           Number of classes to define

       colors=string[,string,...] [required]
           Colors (one per class)

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

       boundary_width=integer
           Boundary width
           Default: 0

       boundary_color=name
           Boundary color
           Either a standard color name or R:G:B triplet
           Default: black

       legendfile=name
           File in which to save d.graph instructions for legend display

DESCRIPTION

       d.vect.thematic draws thematic choropleth vector maps based on  an  attribute  column  or  an  expression
       involving  several  columns.   It takes a list of class breaks (excluding the minimum and maximum values)
       and a list of colors to apply to the classes (has to be the number of class breaks + 1).

       Instead of a list of class breaks, the user can also chose a classification algorithm  and  a  number  of
       classes (nbclasses). See the v.class for more information on these different algorithms.

       Important  note:  The module currently supports only area vector type. For displaying thematic choropleth
       vector maps of other types  (points,  lines)  can  be  used  d.vect.thematic2  available  in  AddOns  via
       g.extension.

NOTES

       The  -l  flag  instructs  the  module  to  print  legend  information  (class min | class max | number of
       observations in class | color) to standard output for futher use in graphical  software.   When  combined
       with  the  -e flag, the legend information will be extended with some additional statistical information.
       If the -n flag is set, the module will only print the legend information without drawing the map. If  the
       user gives a legendfile, the module will write d.graph instructions for painting a legend into that file.

EXAMPLES

   Thematic map with classes
       d.vect.thematic -l map=communes3 column=pop \
         breaks=111393.250000,222785.500000,334177.750000 \
         colors="255:0:0,0:255:0,0:0:255,0,0,0"

   Thematic map with calculated class breaks
       The  following  example  uses  a  calculated  attribute  (density  = pop/area) and the standard deviation
       algorithm to calculate class breaks for 5 classes:
       d.vect.thematic -l map=communes2 column=pop/area algorithm=std \
         nbclasses=5 colors="0:0:255,50:100:255,255:100:50,255:0:0,156:0:0"
       To actually draw the legend for the polygons in the graphical display, the procedure is:
       # first save legend instructions to a file
       d.vect.thematic -n map=communes2 column=pop/area algorithm=std \
         nbclasses=5 colors="0:0:255,50:100:255,255:100:50,255:0:0,156:0:0" \
         legendfile=legend_pop_dens
       # open a monitor
       d.mon wx0
       # draw the map
       d.vect.thematic map=communes2 column=pop/area algorithm=std \
         nbclasses=5 colors="0:0:255,50:100:255,255:100:50,255:0:0,156:0:0"
       # draw the legend
       d.graph input=legend_pop_dens
       In order to further enhance this legend, edit the legend file accordingly and rerun the process.

   Thematic map with calculated class breaks
       Example for the North Carolina sample dataset, colorizing polygons by area size:
       # first save legend instructions to a file
       d.vect.thematic -n map=geology column=SHAPE_area algorithm=int nclasses=6 \
        colors=215:48:39,252:141:89,254:224:139,217:239:139,145:207:96,26:152:80 \
        legendfile=geology.leg
       # open the graphical display
       d.mon wx0
       # draw outline of polygons
       d.vect map=geology type=boundary
       # draw color fill
       d.vect.thematic map=geology column=SHAPE_area algorithm=int nclasses=6 \
        colors="215:48:39,252:141:89,254:224:139,217:239:139,145:207:96,26:152:80" \
       # draw legend
       d.graph input=geology.leg
       Thematic map of area sizes

SEE ALSO

        v.class, d.vect, d.graph, v.univar

       Check also Python module from AddOns: d.vect.thematic2

AUTHOR

       Moritz Lennert

       Last changed: $Date: 2015-08-11 23:07:09 +0200 (Tue, 11 Aug 2015) $

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

       © 2003-2016 GRASS Development Team, GRASS GIS 7.0.3 Reference Manual