GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
v.db.select(1) Grass User's Manual v.db.select(1)

v.db.select - Prints vector map attributes.

vector, attribute table, database, SQL

v.db.select
 
v.db.select --help
 
v.db.select [-rcvf] map=name [layer=string] [ columns=name[,name,...]] [where=sql_query] [group=string] [separator= character] [vertical_separator=character] [ null_value=string] [ file=name] [--overwrite] [-- help] [--verbose] [--quiet] [--ui]

-r
 
Print minimal region extent of selected vector features instead of attributes
-c
 
Do not include column names in output
-v
 
Vertical output (instead of horizontal)
-f
 
Exclude attributes not linked to features
--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

map=name [required]
 
Name of vector map
 
Or data source for direct OGR access
layer=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
columns=name[,name,...]
 
Name of attribute column(s)
where=sql_query
 
WHERE conditions of SQL statement without ’where’ keyword
 
Example: income < 1000 and population >= 10000
group=string
 
GROUP BY conditions of SQL statement without ’group by’ keyword
separator=character
 
Field separator
 
Special characters: pipe, comma, space, tab, newline
 
Default: pipe
vertical_separator=character
 
Output vertical record separator
 
Special characters: pipe, comma, space, tab, newline
null_value=string
 
String representing NULL value
file=name
 
Name for output file (if omitted or "-" output to stdout)

v.db.select prints attributes of a vector map from one or several user selected attribute table columns.

All examples are based on the North Carolina sample dataset.

v.db.select map=roadsmajor
cat|MAJORRDS_|ROAD_NAME|MULTILANE|PROPYEAR|OBJECTID|SHAPE_LEN
1|1|NC-50|no|0|1|4825.369405
2|2|NC-50|no|0|2|14392.589058
3|3|NC-98|no|0|3|3212.981242
4|4|NC-50|no|0|4|13391.907552
...

Note: multiple columns can be specified as comma separated list.
 
v.db.select map=roadsmajor column=ROAD_NAME
NC-50
NC-50
NC-98
NC-50
NC-98
...
v.db.select -r map=roadsmajor where="ROAD_NAME = ’NC-98’"
n=248425.389891
s=245640.640081
w=635906.517653
e=661979.801880

v.db.select geonames_wake where="ALTERNATEN IS NULL"
cat|GEONAMEID|NAME|ASCIINAME|ALTERNATEN|FEATURECLA|FEATURECOD|...
8|4498303|West Raleigh|West Raleigh||P|PPL|US||NC|338759|123|...
14|4459467|Cary|Cary||P|PPL|US||NC|103945|146|152|America/Iqaluit|...
31|4452808|Apex|Apex||P|PPL|US||NC|30873|167|134|America/Iqaluit|...
...

v.db.select geonames_wake where="ALTERNATEN IS NOT NULL"
cat|GEONAMEID|NAME|ASCIINAME|ALTERNATEN|FEATURECLA|FEATURECOD|...
9|4487042|Raleigh|Raleigh|Raleigh,...
31299|4487056|Raleigh-Durham Airport|Raleigh-Durham Airport|...
...

v.db.select map=roadsmajor columns=ROAD_NAME group=ROAD_NAME
ROAD_NAME
I-40
I-440
I-540
NC-231
NC-39
NC-42
...
It is also possible to combine with where option
 
v.db.select map=roadsmajor columns=ROAD_NAME,MULTILANE group=ROAD_NAME where=’ROAD_NAME is not null’
ROAD_NAME|MULTILANE
I-40|yes
I-440|yes
I-540|yes
NC-231|no
NC-39|no
NC-42|no
NC-50|no
NC-54|no
NC-55|no
NC-96|no
NC-97|no
NC-98|no
US-1|
US-401|no
US-64|yes
US-70|yes
It can also use more columns in group option
 
v.db.select map=roadsmajor columns=ROAD_NAME,MULTILANE group=ROAD_NAME,MULTILANE where=’ROAD_NAME is not null’
ROAD_NAME|MULTILANE
I-40|yes
I-440|yes
I-540|yes
NC-231|no
NC-39|no
NC-42|no
NC-50|no
NC-54|no
NC-55|no
NC-96|no
NC-97|no
NC-98|no
US-1|
US-1|yes
US-401|no
US-401|yes
US-64|yes
US-70|yes

db.select

Radim Blazek, ITC-Irst, Trento, Italy
 
Minimal region extent added by Martin Landa, FBK-irst (formerly ITC-irst), Trento, Italy (2008/08)
 
Group option added by Luca Delucchi, Fondazione Edmund Mach, Trento, Italy (2015/12)
Last changed: $Date: 2016-10-27 23:20:55 +0200 (Thu, 27 Oct 2016) $

Available at: v.db.select source code (history)
Main index | Vector index | Topics index | Keywords index | Graphical index | Full index
© 2003-2018 GRASS Development Team, GRASS GIS 7.4.3 Reference Manual
GRASS 7.4.3

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.