.TH t.rast.neighbors 1grass "" "GRASS 7.8.5" "GRASS GIS User's Manual"
.SH NAME
\fI\fBt.rast.neighbors\fR\fR  \- Performs a neighborhood analysis for each map in a space time raster dataset.
.SH KEYWORDS
temporal, aggregation, raster, time
.SH SYNOPSIS
\fBt.rast.neighbors\fR
.br
\fBt.rast.neighbors \-\-help\fR
.br
\fBt.rast.neighbors\fR [\-\fBnr\fR] \fBinput\fR=\fIname\fR \fBoutput\fR=\fIname\fR  [\fBwhere\fR=\fIsql_query\fR]   [\fBsize\fR=\fIinteger\fR]  \fBmethod\fR=\fIstring\fR \fBbasename\fR=\fIstring\fR  [\fBsuffix\fR=\fIstring\fR]   [\fBnprocs\fR=\fIinteger\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBhelp\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR]  [\-\-\fBui\fR]
.SS Flags:
.IP "\fB\-n\fR" 4m
.br
Register Null maps
.IP "\fB\-r\fR" 4m
.br
Ignore the current region settings and use the raster map regions
.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 raster dataset
.IP "\fBoutput\fR=\fIname\fR \fB[required]\fR" 4m
.br
Name of the output space time raster dataset
.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 "\fBsize\fR=\fIinteger\fR" 4m
.br
Neighborhood size
.br
Default: \fI3\fR
.IP "\fBmethod\fR=\fIstring\fR \fB[required]\fR" 4m
.br
Aggregate operation to be performed on the raster maps
.br
Options: \fIaverage, median, mode, minimum, maximum, range, stddev, sum, count, variance, diversity, interspersion, quart1, quart3, perc90, quantile\fR
.br
Default: \fIaverage\fR
.IP "\fBbasename\fR=\fIstring\fR \fB[required]\fR" 4m
.br
Basename of the new generated output maps
.br
A numerical suffix separated by an underscore will be attached to create a unique identifier
.IP "\fBsuffix\fR=\fIstring\fR" 4m
.br
Suffix to add at basename: set \(cqgran\(cq for granularity, \(cqtime\(cq for the full time format, \(cqnum\(cq for numerical suffix with a specific number of digits (default %05)
.br
Default: \fIgran\fR
.IP "\fBnprocs\fR=\fIinteger\fR" 4m
.br
Number of r.neighbor processes to run in parallel
.br
Default: \fI1\fR
.SH DESCRIPTION
\fIt.rast.neighbors\fR performs r.neighbors
computations on the maps of a space time raster dataset (STRDS). This
module supports a subset of options that are available in
r.neighbors. The size of the neighborhood
and the aggregation method can be chosen.
.PP
The user must provide an input and an output space time raster dataset and
the basename of the resulting raster maps. The resulting STRDS will have
the same temporal resolution as the input dataset.
All maps will be processed using the current region settings.
.PP
The user can select a subset of the input space time raster dataset for
processing using a SQL WHERE statement. The number of CPU\(cqs to be used
for parallel processing can be specified with the \fInprocs\fR
option to speedup the computation on multi\-core system.
.SH EXAMPLE
To smooth the maps contained in a space time dataset run:
.br
.nf
\fC
t.rast.neighbors input=tempmean_monthly output=smooth_tempmean_monthly \(rs
                 basename=tmean_smooth size=5 method=average nprocs=4
# show some info about the new space time dataset
t.info smooth_tempmean_monthly
 +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- Space Time Raster Dataset \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
 |                                                                            |
 +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- Basic information \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
 | Id: ........................ smooth_tempmean_monthly@climate_2000_2012
 | Name: ...................... smooth_tempmean_monthly
 | Mapset: .................... climate_2000_2012
 | Creator: ................... lucadelu
 | Temporal type: ............. absolute
 | Creation time: ............. 2014\-11\-27 11:41:36.444579
 | Modification time:.......... 2014\-11\-27 11:41:39.978232
 | Semantic type:.............. mean
 +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- Absolute time \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
 | Start time:................. 2009\-01\-01 00:00:00
 | End time:................... 2013\-01\-01 00:00:00
 | Granularity:................ 1 month
 | Temporal type of maps:...... interval
 +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- Spatial extent \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
 | North:...................... 320000.0
 | South:...................... 10000.0
 | East:.. .................... 935000.0
 | West:....................... 120000.0
 | Top:........................ 0.0
 | Bottom:..................... 0.0
 +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- Metadata information \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
 | Raster register table:...... raster_map_register_ea1c9a83524e41a784d72744b08c6107
 | North\-South resolution min:. 500.0
 | North\-South resolution max:. 500.0
 | East\-west resolution min:... 500.0
 | East\-west resolution max:... 500.0
 | Minimum value min:.......... \-6.428905
 | Minimum value max:.......... 18.867296
 | Maximum value min:.......... 4.247691
 | Maximum value max:.......... 28.767953
 | Aggregation type:........... None
 | Number of registered maps:.. 48
 |
 | Title:
 | Monthly precipitation
 | Description:
 | Dataset with monthly precipitation
 | Command history:
 | # 2014\-11\-27 11:41:36
 | t.rast.neighbors input=\(dqtempmean_monthly\(dq
 |     output=\(dqsmooth_tempmean_monthly\(dq basename=\(dqtmean_smooth\(dq size=\(dq5\(dq
 |     method=\(dqaverage\(dq nprocs=\(dq4\(dq
 |
 +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
# now compare the values between the original and the smoothed dataset
t.rast.list input=smooth_tempmean_monthly columns=name,start_time,min,max
name|start_time|min|max
tmean_smooth_1|2009\-01\-01 00:00:00|\-3.361714|7.409861
tmean_smooth_2|2009\-02\-01 00:00:00|\-1.820261|7.986794
tmean_smooth_3|2009\-03\-01 00:00:00|2.912971|11.799684
\&...
tmean_smooth_46|2012\-10\-01 00:00:00|9.38767|18.709297
tmean_smooth_47|2012\-11\-01 00:00:00|1.785653|10.911189
tmean_smooth_48|2012\-12\-01 00:00:00|1.784212|11.983857
t.rast.list input=tempmean_monthly columns=name,start_time,min,max
name|start_time|min|max
2009_01_tempmean|2009\-01\-01 00:00:00|\-3.380823|7.426054
2009_02_tempmean|2009\-02\-01 00:00:00|\-1.820261|8.006386
2009_03_tempmean|2009\-03\-01 00:00:00|2.656992|11.819274
\&...
2012_10_tempmean|2012\-10\-01 00:00:00|9.070884|18.709297
2012_11_tempmean|2012\-11\-01 00:00:00|1.785653|10.911189
2012_12_tempmean|2012\-12\-01 00:00:00|1.761019|11.983857
\fR
.fi
.SH SEE ALSO
\fI
r.neighbors,
t.rast.aggregate.ds,
t.rast.extract,
t.info,
g.region,
r.mask
\fR
.SH AUTHOR
Sören Gebbert, Thünen Institute of Climate\-Smart Agriculture
.SH SOURCE CODE
.PP
Available at: t.rast.neighbors 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