i.rescale.rgb - GRASS GIS manual

NAME

i.rescale.rgb - Rescales raster values for optimized RGB visualization.

KEYWORDS

SYNOPSIS

i.rescale.rgb

i.rescale.rgb --help

i.rescale.rgb [-f] red=name green=name blue=name output=string [lower_percentile=integer] [upper_percentile=integer] [output_range=string] [suffix=string] [--help] [--verbose] [--quiet] [--ui]

Flags:

-f: Allow floating point values in output rasters (default is integer)
--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

red=name [required]: Name raster for red channel; Name of input raster map
green=name [required]: Name raster for green channel; Name of input raster map
blue=name [required]: Name raster for blue channel; Name of input raster map
output=string [required]: Name of output group
lower_percentile=integer: Lower percentile for raster reclassification (percent); Options: 1-100; Default: 2
upper_percentile=integer: Upper percentile for raster reclassification (percent); Options: 1-100; Default: 98
output_range=string: Output raster value range in format <min,max>; Default: 0,255
suffix=string: Suffix to be added to each reclassified raster (added with underscore); Default: reclassified

DESCRIPTION
EXAMPLES
SEE ALSO
AUTHOR

DESCRIPTION

i.rescale.rgb is a GRASS addon that works similar to i.colors.enhance but changes and rescales the actual raster values and not the corresponding color table. This is only useful for visualization purposes outside of GRASS GIS. The created group can be used as r.out.gdal input parameter for the multi-band export.

EXAMPLES

Optimize the raster values of three input bands for RGB visualization; enhance contrast by limiting input data to the area between the 2% and 98% percentile:

i.rescale.rgb red=red_channel green=green_channel blue=blue_channel output=output_group lower_percentile=2 upper_percentile=98

In case of export to Byte type with no-data (NULL) values being present, the way to go is rescaling to 0..254 range (rather than the default 0..255 range):

i.rescale.rgb red=red_channel green=green_channel blue=blue_channel output=output_group output_range=0,254 lower_percentile=2 upper_percentile=98

AUTHOR

Guido Riembauer, mundialis

SOURCE CODE

Available at: i.rescale.rgb source code (history)

Accessed: Tuesday Apr 16 18:31:15 2024