GRASS logo

NAME

t.rast.stats - Compute area statistics of maps in a SpaceTimeRasterDataset

KEYWORDS

temporal, statistics, raster, time

SYNOPSIS

t.rast.stats
t.rast.stats --help
t.rast.stats [-Rhacpl1gxArCinN] input=name [zone=name[,name,...]] [where=sql_query] [output=name] [columns=string[,string,...]] [separator=character] [null_value=string] [nsteps=integer] [sort=string] [region_relation=string] [nprocs=integer] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-R
Use the raster map regions for statistic calculation instead of the current region
-h
Print header
-a
Print area totals in square meters
-c
Print cell counts (sortable)
-p
Print approximate (total percent may not be 100%) percents
-l
Print category labels
-1
One cell (range) per line
-g
Print grid coordinates (east and north)
-x
Print x and y (column and row)
Indexing starts with 1: first column and row are 1
-A
Print averaged values instead of intervals (floating-point mapsonly)
-r
Print raw indexes of floating-point ranges (floating-point mapsonly)
-C
Report for cats floating-point ranges (floating-point maps only)
-i
Read floating-point map as integer (use map's quant rules)
-n
Do not report no data value
-N
Do not report cells where all maps have no data
--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

Parameters:

input=name [required]
Name of the input space time raster dataset
zone=name[,name,...]
Name of input raster map
where=sql_query
WHERE conditions of SQL statement without 'where' keyword used in the temporal GIS framework
Example: start_time > '2001-01-01 12:30:00'
output=name
Name for output file
columns=string[,string,...]
Map metadata columns to be written to the utput
Options: creator, ctime, semantic_label, min, max, nsres, ewres, rows, cols, number_of_cells
separator=character
Field separator
Special characters: pipe, comma, space, tab, newline
Default: pipe
null_value=string
String representing NULL value
Default: *
nsteps=integer
Number of floating-point subranges to collect stats from
Default: 255
sort=string
Sort output statistics by cell counts
Default: sorted by categories or intervals
Options: asc, desc
asc: Sort by cell counts in ascending order, desc
region_relation=string
Process only maps with this spatial relation to the current computational region
Options: overlaps, contains, is_contained
nprocs=integer
Number of threads for parallel computing
Number of r.stats processes to run in parallel
Default: 1

Table of contents

DESCRIPTION

t.rast.stats is a wrapper around the r.stats module and computes area statistics for each registered map of a space time raster dataset. Most flags of r.stats are supported.

A zone map can be specified to compute statistics for each of the zones. The zone map should be of CELL type, otherwise flags for handling of floating point data should be specified.

Starting with GRASS GIS version 8.3 the computational region can be used for spatially selecting maps in the SpaceTimeRasterDataset to process. To do so, operators can be chosen in the region_relation option. This can be useful for STRDS with maps with varying spatial extent

Computational region -R

NOTES

Parallel processing is supported in t.rast.stats. Internally, several r.stats modules will be started, depending on the number of specified parallel processes (nprocs) and the number of input maps to reclassify.

EXAMPLES

Statistics of monthly data

t.rast.stats input=tempmean_monthly zone=tempmean_year

SEE ALSO

r.stats, t.rast.univar,

Temporal data processing Wiki

AUTHOR

Stefan Blumentrath

SOURCE CODE

Available at: t.rast.stats source code (history)

Accessed: Monday Jul 27 12:30:03 2026

Main index | Temporal index | Topics index | Keywords index | Graphical index | Full index

© 2003-2026 GRASS Development Team, GRASS 8.5.1dev Reference Manual