db.univar.1grass - Man Page
Calculates univariate statistics on selected table column.
Keywords
database, statistics, attribute table
Synopsis
db.univar
db.univar --help
db.univar [-eg] table=name column=name [database=name] [driver=name] [where=sql_query] [percentile=float[,float,...]] format=name [--help] [--verbose] [--quiet] [--ui]
Flags
- -e
Extended statistics (quartiles and 90th percentile)
- -g
Print stats in shell script style [deprecated]
This flag is deprecated and will be removed in a future release. Use format=shell instead.- --help
Print usage summary
- --verbose
Verbose module output
- --quiet
Quiet module output
- --ui
Force launching GUI dialog
Parameters
- table=name [required]
Name of attribute table
- column=name [required]
Name of attribute column on which to calculate statistics (must be numeric)
- database=name
Name of database
- driver=name
Name of database driver
Options: dbf, odbc, ogr, sqlite, pg- where=sql_query
WHERE conditions of SQL statement without ’where’ keyword
Example: income < 1000 and population >= 10000- percentile=float[,float,...]
Percentile to calculate (requires extended statistics flag)
Options: 0-100
Default: 90- format=name [required]
Output format
Options: plain, json, shell
Default: plain
plain: Plain text output
json: JSON (JavaScript Object Notation)
shell: Shell script style for Bash eval
Description
db.univar calculates basic univariate statistics for numeric attributes in a data table. It will calculate minimum, maximum, range, mean, standard deviation, variance, coefficient of variation, quartiles, median, and 90th percentile. It uses db.select to create list values for statistical calculations. NOTES If the database and driver are not specified, the default values set in db.connect will be used.
Example
In this example, random points are sampled from the elevation map (North Carolina sample dataset) and univariate statistics performed:
g.region raster=elevation -p v.random output=samples n=100 v.db.addtable samples column="heights double precision" v.what.rast samples raster=elevation column=heights v.db.select samples db.univar samples column=heights
See Also
v.db.univar, r.univar, v.univar, db.select, d.vect.thematic
Authors
Michael Barton, Arizona State University
and authors of r.univar.sh
Source Code
Available at: db.univar source code (history)
Latest change: Saturday Feb 14 00:16:26 2026 in commit: ae1ae67e52b94c5cef185fac50aa33b38a56875f
Main index | Database index | Topics index | Keywords index | Graphical index | Full index
© 2003-2026 GRASS Development Team, GRASS 8.5.0 Reference Manual