1t.vect.extract(1) Grass User's Manual t.vect.extract(1)
2
6 t.vect.extract - Extracts a subset of a space time vector dataset.
7
9 temporal, extract, vector, time
10
12 t.vect.extract
13 t.vect.extract --help
14 t.vect.extract [-n] input=name [where=sql_query] [expres‐
15 sion=sql_query] output=name [layer=string]
16 [type=string[,string,...]] [basename=string] [suffix=string]
17 [nprocs=integer] [--overwrite] [--help] [--verbose] [--quiet]
18 [--ui]
19 Flags:
21 -n
22 Register empty maps
23 --overwrite
25 Allow output files to overwrite existing files
26 --help
28 Print usage summary
29 --verbose
31 Verbose module output
32 --quiet
34 Quiet module output
35 --ui
37 Force launching GUI dialog
38 Parameters:
40 input=name [required]
41 Name of the input space time vector dataset
42 where=sql_query
44 WHERE conditions of SQL statement without ’where’ keyword used in
45 the temporal GIS framework
46 Example: start_time > ’2001-01-01 12:30:00’
47 expression=sql_query
49 WHERE conditions of SQL statement without ’where’ keyword
50 Example: income < 1000 and population >= 10000
51 output=name [required]
53 Name of the output space time vector dataset
54 layer=string
56 Layer number or name
57 Vector features can have category values in different layers. This
58 number determines which layer to use. When used with direct OGR
59 access this is the layer name.
60 Default: 1
61 type=string[,string,...]
63 Input feature type
64 Options: point, line, boundary, centroid, area
65 Default: point,line,boundary,centroid,area
66 basename=string
68 Basename of the new generated output maps
69 A numerical suffix separated by an underscore will be attached to
70 create a unique identifier
71 suffix=string
73 Suffix to add at basename: set ’gran’ for granularity, ’time’ for
74 the full time format, ’num’ for numerical suffix with a specific
75 number of digits (default %05)
76 Default: gran
77 nprocs=integer
79 The number of v.extract processes to run in parallel. Use only if
80 database backend is used which supports concurrent writing
81 Default: 1
82
84 The purpose of t.vect.extract is to extract a subset of a space time
85 vector dataset and to store that subset in a different space time vec‐
86 tor dataset.
87
89 In the following example a new space time vector dataset will be create
90 with all the data later than 2000:
91 t.vect.extract input=shoreline where="start_time > 2000" \
92 output=shoreline_later_2000 basename=new_shoreline
93 t.info shoreline_later_2000@shoreline type=stvds
94 +-------------------- Space Time Vector Dataset -----------------------------+
95 | |
96 +-------------------- Basic information -------------------------------------+
97 | Id: ........................ shoreline_later_2000@shoreline
98 | Name: ...................... shoreline_later_2000
99 | Mapset: .................... shoreline
100 | Creator: ................... lucadelu
101 | Temporal type: ............. relative
102 | Creation time: ............. 2014-11-29 08:43:50.043219
103 | Modification time:.......... 2014-11-29 08:43:50.085407
104 | Semantic type:.............. mean
105 +-------------------- Relative time -----------------------------------------+
106 | Start time:................. 2003
107 | End time:................... 2009
108 | Relative time unit:......... years
109 | Granularity:................ 1
110 | Temporal type of maps:...... point
111 +-------------------- Spatial extent ----------------------------------------+
112 | North:...................... 1039175.31479
113 | South:...................... 34705.216018
114 | East:.. .................... 3052322.44671
115 | West:....................... 2130004.16779
116 | Top:........................ 0.0
117 | Bottom:..................... 0.0
118 +-------------------- Metadata information ----------------------------------+
119 | Vector register table:...... vector_map_register_8395740fc8de42149fef74a3d25bbb05
120 | Number of points ........... 0
121 | Number of lines ............ 407
122 | Number of boundaries ....... 0
123 | Number of centroids ........ 0
124 | Number of faces ............ 0
125 | Number of kernels .......... 0
126 | Number of primitives ....... 407
127 | Number of nodes ............ 767
128 | Number of areas ............ 0
129 | Number of islands .......... 0
130 | Number of holes ............ 0
131 | Number of volumes .......... 0
132 | Number of registered maps:.. 3
133 |
134 | Title:
135 | North Carolina shoreline
136 | Description:
137 | North Caroline shoreline from 2000 to 2009
138 | Command history:
139 | # 2014-11-29 08:43:50
140 | t.vect.extract input="shoreline"
141 | where="start_time > 2000" output="shoreline_later_2000"
142 | basename="new_shoreline"
143 | # 2014-11-29 08:44:14
144 | t.support type="stvds"
145 | input="shoreline_later_2000@shoreline"
146 | descr="North Caroline shoreline from 2000 to 2009"
147 +----------------------------------------------------------------------------+
148 t.vect.list shoreline_later_2000
149 name|layer|mapset|start_time|end_time
150 shoreline_2003|None|shoreline|2003|None
151 shoreline_2004|None|shoreline|2004|None
152 shoreline_2009|None|shoreline|2009|None
153
155 t.create, t.info
156
158 Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
159
161 Available at: t.vect.extract source code (history)
162 Main index | Temporal index | Topics index | Keywords index | Graphical
164 index | Full index
165 © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual
167GRASS 7.8.2 t.vect.extract(1)