Flags:¶

-g

Shell script style, currently only for report
Format: layer type count min max

-t

Do not copy attribute table(s)

--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:¶

input=name [required]

Name of input vector map
Or data source for direct OGR access

layer=string[,string,...]

Layer number or name
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

type=string[,string,...]

Input feature type
Options: point, line, boundary, centroid, area, face, kernel
Default: point,line,centroid,face

ids=range

Feature ids (by default all features are processed)
Example: 1,3,7-9,13

output=name

Name for output vector map

option=string [required]

Action to be done
Options: add, del, chlayer, sum, report, print, layers, transfer
add: add a category to features without category in the given layer
del: delete category (cat=-1 to delete all categories of given layer)
chlayer: change layer number (e.g. layer=3,1 changes layer 3 to layer 1)
sum: add the value specified by cat option to the current category value
report: print report (statistics), in shell style: layer type count min max
print: print category values, layers are separated by ’|’, more cats in the same layer are separated by ’/’
layers: print only layer numbers
transfer: copy values from one layer to another (e.g. layer=1,2,3 copies values from layer 1 to layer 2 and 3)

cat=integer

Category value
Default: 1

step=integer

Category increment
Default: 1

Report vector categories¶

v.category input=testmap option=report
LAYER/TABLE 1/testmap:
type       count        min        max
point          0          0          0
line        1379          1       1379
boundary       0          0          0
centroid       0          0          0
area           0          0          0
all         1379          1       1379

Delete all vector categories in layer 1¶

v.category input=testmap output=outmap option=del cat=-1

Add vector categories in layer 1 with step=2¶

v.category input=outmap output=stepmap option=add step=2
# report
v.category input=stepmap option=report
LAYER/TABLE 1/outmap:
type       count        min        max
point          0          0          0
line        1379          1       2757
boundary       0          0          0
centroid       0          0          0
area           0          0          0
all         1379          1       2757

Add categories/centroids to a vector map without categories¶

v.category input=wkt output=wktnew option=add

Copy categories from layer 1 to layer 2,3,4,5,6,7 and 8¶

v.category input=observer output=observer_new option=transfer layer=1,2,3,4,5,6,7,8

Print vector categories of given layer¶

v.category input=roads option=print layer=1 id=1-50