GRASS logo

Note: This addon document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade your GRASS GIS installation, and read the current addon manual page.

NAME

r3.count.categories - Count categories in vertical direction

KEYWORDS

raster3d, conversion, raster, category, voxel

SYNOPSIS

r3.count.categories
r3.count.categories --help
r3.count.categories [-ds] input=name output=basename slices=basename [multiply=float] [add=float] [size=integer] [surface=name] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-d
Divide count by the number of cells in the surface
-s
Expect the slices to be already present
When running the module over and over, this saves the slicing 3D raster step
--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 input 3D raster map
output=basename [required]
Name for output basename raster map(s)
slices=basename [required]
Basename for horizontal slices of the 3D raster
Name for output basename raster map(s)
multiply=float
Value to multiply the raster values with
Coefficient a in the equation y = ax + b
add=float
Value to add to the raster values
Coefficient b in the equation y = ax + b
size=integer
Moving window size
By default, only the given cell is considered
surface=name
Count only those cells which are under the surface (in cells)

Table of contents

DESCRIPTION

r3.count.categories iterates over whole numbers (categories, classes) in the 3D raster (considers values to be integers) and for each vertical column counts them in the given column.

The 3D raster map is considered to be integer, i.e. all values are converted to integer values with truncation. When some conversion is appropriate the multiply option can be used to scale the value before conversion. For example, if the values are percentages with values between 0 and 1, value 100 can be used to obtain percentages between 0 and 100. The values will be then preserved with precision 1 (decimal part is truncated).

SEE ALSO

r3.to.rast, r3.to.group, r3.what

AUTHORS

Vaclav Petras, NCSU GeoForAll Lab

SOURCE CODE

Available at: r3.count.categories source code (history)

Latest change: Monday Jun 28 07:54:09 2021 in commit: 1cfc0af029a35a5d6c7dae5ca7204d0eb85dbc55


Note: This addon document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade your GRASS GIS installation, and read the current addon manual page.

Main index | 3D raster index | Topics index | Keywords index | Graphical index | Full index

© 2003-2023 GRASS Development Team, GRASS GIS 7.8.9dev Reference Manual