r.texture.tiled - GRASS GIS manual

NAME

r.texture.tiled - Runs r.texture in parallel over tiles

KEYWORDS

SYNOPSIS

r.texture.tiled

r.texture.tiled --help

r.texture.tiled input=name output=basename method=string size=integer distance=integer tile_width=integer tile_height=integer processes=integer [mapset_prefix=string] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

--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 raster map
output=basename [required]: Name for output basename raster map(s)
method=string [required]: Texture method to apply; Options: asm, contrast, corr, var, idm, sa, sv, se, entr, dv, de, moc1, moc2
size=integer [required]: The size of moving window (odd and >= 3); Default: 3
distance=integer [required]: The distance between two samples (>= 1); The distance must be smaller than the size of the moving window; Default: 1
tile_width=integer [required]: Width of tiles; Default: 1000
tile_height=integer [required]: Height of tiles; Default: 1000
processes=integer [required]: Number of parallel processes; Default: 1
mapset_prefix=string: Mapset prefix

DESCRIPTION
NOTES
EXAMPLE
SEE ALSO
AUTHOR

DESCRIPTION

r.texture.tiled cuts a raster input map into tiles and runs r.texture over these tiles before patching the result together into a single output raster map.

The overlap between tiles is calculated internally in order to correspond to the window size in order to avoid any border effects.

Tiles can be defined with the tile_width, tile_height and overlap parameters. If processes is higher than one, these tiles will be processed in parallel.

The mapset_prefix parameter allows to make sure that the temporary mapsets created during the tiled processing have unique names. This is useful if the user runs r.texture.tiled several times in parallel (e.g. in an HPC environment).

NOTES

The parameters for texture calculation are identical to those of r.texture. Currently, this module only allows calculating one texture feature at a time. The n flag allowing null cells is automatically set in order to avoid issues at the border of the current computational region / of the input map.

EXAMPLE

Run r.texture over tiles with size 1000x1000 using 4 parallel processes:

 
g.region rast=ortho_2001_t792_1m
r.texture.tiled ortho_2001_t792_1m output=ortho_texture method=idm \
   tile_width=1000 tile_height=1000 processes=4

AUTHOR

Moritz Lennert

SOURCE CODE

Available at: r.texture.tiled source code (history)