.TH t.vect.list 1grass "" "GRASS 7.8.5" "GRASS GIS User's Manual"
.SH NAME
\fI\fBt.vect.list\fR\fR  \- Lists registered maps of a space time vector dataset.
.SH KEYWORDS
temporal, map management, vector, list, time
.SH SYNOPSIS
\fBt.vect.list\fR
.br
\fBt.vect.list \-\-help\fR
.br
\fBt.vect.list\fR [\-\fBu\fR] \fBinput\fR=\fIname\fR  [\fBorder\fR=\fIstring\fR[,\fIstring\fR,...]]   [\fBcolumns\fR=\fIstring\fR[,\fIstring\fR,...]]   [\fBwhere\fR=\fIsql_query\fR]   [\fBmethod\fR=\fIstring\fR]   [\fBseparator\fR=\fIcharacter\fR]   [\fBoutput\fR=\fIname\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBhelp\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR]  [\-\-\fBui\fR]
.SS Flags:
.IP "\fB\-u\fR" 4m
.br
Suppress printing of column names
.IP "\fB\-\-overwrite\fR" 4m
.br
Allow output files to overwrite existing files
.IP "\fB\-\-help\fR" 4m
.br
Print usage summary
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.IP "\fB\-\-ui\fR" 4m
.br
Force launching GUI dialog
.SS Parameters:
.IP "\fBinput\fR=\fIname\fR \fB[required]\fR" 4m
.br
Name of the input space time vector dataset
.IP "\fBorder\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Sort the space time dataset by category
.br
Options: \fIid, name, layer, creator, mapset, temporal_type, creation_time, start_time, end_time, north, south, west, east, points, lines, boundaries, centroids, faces, kernels, primitives, nodes, areas, islands, holes, volumes\fR
.br
Default: \fIstart_time\fR
.IP "\fBcolumns\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Columns to be printed to stdout
.br
Options: \fIid, name, layer, creator, mapset, temporal_type, creation_time, start_time, end_time, north, south, west, east, points, lines, boundaries, centroids, faces, kernels, primitives, nodes, areas, islands, holes, volumes\fR
.br
Default: \fIname,layer,mapset,start_time,end_time\fR
.IP "\fBwhere\fR=\fIsql_query\fR" 4m
.br
WHERE conditions of SQL statement without \(cqwhere\(cq keyword used in the temporal GIS framework
.br
Example: start_time > \(cq2001\-01\-01 12:30:00\(cq
.IP "\fBmethod\fR=\fIstring\fR" 4m
.br
Method used for data listing
.br
Options: \fIcols, comma, delta, deltagaps, gran\fR
.br
Default: \fIcols\fR
.IP "\fBseparator\fR=\fIcharacter\fR" 4m
.br
Field separator character between the output columns
.br
Special characters: pipe, comma, space, tab, newline
.br
Default: \fIpipe\fR
.IP "\fBoutput\fR=\fIname\fR" 4m
.br
Name for output file
.SH DESCRIPTION
This module provides the same functionality as
t.rast.list, the only difference is the
vector map layer metadata.
.SH EXAMPLE
.SS Default query
This example show a relative space time vector dataset with the first
three maps with a range of years, instead the last five are valid only
for one year:
.br
.nf
\fC
t.vect.list shoreline@shoreline
name|layer|mapset|start_time|end_time
shoreline_1849_1873|None|shoreline|1849|1873
shoreline_1925_1946|None|shoreline|1925|1946
shoreline_1970_1988|None|shoreline|1970|1988
shoreline_1997|None|shoreline|1997|None
shoreline_1998|None|shoreline|1998|None
shoreline_2003|None|shoreline|2003|None
shoreline_2004|None|shoreline|2004|None
shoreline_2009|None|shoreline|2009|None
\fR
.fi
.SS Using method option
Method option is able to show vector in different way. By default \fIcols\fR
value is used, the value \fIdeltagaps\fR will print the delta between
maps and also the gaps if they exist (like in this example).
.br
.nf
\fC
t.vect.list method=deltagaps input=shoreline
id|name|layer|mapset|start_time|end_time|interval_length|distance_from_begin
shoreline_1849_1873@shoreline|shoreline_1849_1873|None|shoreline|1849|1873|24|0
None|None|None|None|1873|1925|52|24
shoreline_1925_1946@shoreline|shoreline_1925_1946|None|shoreline|1925|1946|21|76
None|None|None|None|1946|1970|24|97
shoreline_1970_1988@shoreline|shoreline_1970_1988|None|shoreline|1970|1988|18|121
None|None|None|None|1988|1997|9|139
shoreline_1997@shoreline|shoreline_1997|None|shoreline|1997|None|None|148
None|None|None|None|1997|1998|1|148
shoreline_1998@shoreline|shoreline_1998|None|shoreline|1998|None|None|149
None|None|None|None|1998|2003|5|149
shoreline_2003@shoreline|shoreline_2003|None|shoreline|2003|None|None|154
None|None|None|None|2003|2004|1|154
shoreline_2004@shoreline|shoreline_2004|None|shoreline|2004|None|None|155
None|None|None|None|2004|2009|5|155
shoreline_2009@shoreline|shoreline_2009|None|shoreline|2009|None|None|160
\fR
.fi
.SH SEE ALSO
\fI
g.list,
t.create,
t.info,
t.list,
t.rast.list,
t.rast3d.list
\fR
.SH AUTHOR
Sören Gebbert
.SH SOURCE CODE
.PP
Available at: t.vect.list source code (history)
.PP
Main index |
Temporal index |
Topics index |
Keywords index |
Graphical index |
Full index
.PP
© 2003\-2020
GRASS Development Team,
GRASS GIS 7.8.5 Reference Manual