Skip to content

i.his.rgb

Transforms raster maps from HIS (Hue-Intensity-Saturation) color space to RGB (Red-Green-Blue) color space.

i.his.rgb hue=name intensity=name saturation=name red=name green=name blue=name [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

i.his.rgb hue=name intensity=name saturation=name red=name green=name blue=name

grass.script.run_command("i.his.rgb", hue, intensity, saturation, red, green, blue, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("i.his.rgb", hue="name", intensity="name", saturation="name", red="name", green="name", blue="name")

Parameters

hue=name [required]
    Name of input raster map (hue)
intensity=name [required]
    Name of input raster map (intensity)
saturation=name [required]
    Name of input raster map (saturation)
red=name [required]
    Name for output raster map (red)
green=name [required]
    Name for output raster map (green)
blue=name [required]
    Name for output raster map (blue)
--overwrite
    Allow output files to overwrite existing files
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

hue : str, required
    Name of input raster map (hue)
    Used as: input, raster, name
intensity : str, required
    Name of input raster map (intensity)
    Used as: input, raster, name
saturation : str, required
    Name of input raster map (saturation)
    Used as: input, raster, name
red : str, required
    Name for output raster map (red)
    Used as: output, raster, name
green : str, required
    Name for output raster map (green)
    Used as: output, raster, name
blue : str, required
    Name for output raster map (blue)
    Used as: output, raster, name
overwrite: bool, optional
    Allow output files to overwrite existing files
    Default: False
verbose: bool, optional
    Verbose module output
    Default: False
quiet: bool, optional
    Quiet module output
    Default: False
superquiet: bool, optional
    Very quiet module output
    Default: False

DESCRIPTION

i.his.rgb is an image processing program that processes three input raster map layers as hue, intensity and saturation components and produces three output raster map layers representing the red, green and blue components of this data. The output raster map layers are created by a standard hue-intensity-saturation (HIS) to red-green-blue (RGB) color transformation. Each output raster map layer is given a linear gray scale color table. The current geographic region and mask settings are respected.

NOTES

It is not possible to process three bands with i.his.rgb and then exactly recover the original bands with i.rgb.his. This is due to loss of precision because of integer computations and rounding. Tests have shown that more than 70% of the original cell values will be reproduced exactly after transformation in both directions and that 99% will be within plus or minus 1. A few cell values may differ significantly from their original values.

SEE ALSO

i.rgb.his, r.colors

AUTHOR

David Satnik, GIS Laboratory, Central Washington University

with acknowledgements to Ali Vali, Univ. of Texas Space Research Center, for the core routine.

SOURCE CODE

Available at: i.his.rgb source code (history)
Latest change: Friday Feb 07 19:16:09 2025 in commit a82a39f