1t.vect.extract(1)             Grass User's Manual            t.vect.extract(1)
2
3
4

NAME

6       t.vect.extract  - Extracts a subset of a space time vector dataset.
7

KEYWORDS

9       temporal, extract, vector, time
10

SYNOPSIS

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
20   Flags:
21       -n
22           Register empty maps
23
24       --overwrite
25           Allow output files to overwrite existing files
26
27       --help
28           Print usage summary
29
30       --verbose
31           Verbose module output
32
33       --quiet
34           Quiet module output
35
36       --ui
37           Force launching GUI dialog
38
39   Parameters:
40       input=name [required]
41           Name of the input space time vector dataset
42
43       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
48       expression=sql_query
49           WHERE conditions of SQL statement without ’where’ keyword
50           Example: income < 1000 and population >= 10000
51
52       output=name [required]
53           Name of the output space time vector dataset
54
55       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
62       type=string[,string,...]
63           Input feature type
64           Options: point, line, boundary, centroid, area
65           Default: point,line,boundary,centroid,area
66
67       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
72       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
78       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

DESCRIPTION

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

EXAMPLE

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

SEE ALSO

155        t.create, t.info
156

AUTHOR

158       Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
159

SOURCE CODE

161       Available at: t.vect.extract source code (history)
162
163       Main index | Temporal index | Topics index | Keywords index | Graphical
164       index | Full index
165
166       © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual
167
168
169
170GRASS 7.8.2                                                  t.vect.extract(1)
Impressum