.TH d.his 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBd.his\fR\fR  - Displays the result obtained by combining hue, intensity, and saturation (his) values from user-specified input raster map layers.
.SH KEYWORDS
display, color transformation
.SH SYNOPSIS
\fBd.his\fR
.br
\fBd.his help\fR
.br
\fBd.his\fR [\-\fBn\fR] \fBh_map\fR=\fIstring\fR  [\fBi_map\fR=\fIstring\fR]   [\fBs_map\fR=\fIstring\fR]   [\fBbrighten\fR=\fIinteger\fR]   [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-n\fR" 4m
.br
Respect NULL values while drawing
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBh_map\fR=\fIstring\fR" 4m
.br
Name of layer to be used for HUE
.IP "\fBi_map\fR=\fIstring\fR" 4m
.br
Name of layer to be used for INTENSITY
.IP "\fBs_map\fR=\fIstring\fR" 4m
.br
Name of layer to be used for SATURATION
.IP "\fBbrighten\fR=\fIinteger\fR" 4m
.br
Percent to brighten intensity channel
.br
Options: \fI-99-99\fR
.br
Default: \fI0\fR
.PP
.SH DESCRIPTION
\fIhis\fR stands for hue, intensity, and saturation.
This program produces a raster map layer providing a
visually pleasing combination of hue, intensity, and
saturation values from two or three user-specified raster
map layers.
.PP
The human brain automatically interprets the vast amount of
visual information available according to basic rules. 
Color, or \fIhue\fR, is used to categorize objects. 
Shading, or \fIintensity\fR, is interpreted as
three-dimensional texturing. Finally, the degree of
haziness, or \fIsaturation\fR, is associated with
distance or depth. This program allows data from up to
three raster map layers to be combined into an image which
retains the original information in terms of \fIhue\fR,
\fIintensity\fR, and \fIsaturation\fR.
.SH OPTIONS
This program can be run non-interactively or
interactively.  It will run non-interactively if the user
specifies on the command line the name of a map containing
hue values (\fBh_map\fR), and the name(s) of map(s)
containing intensity values (\fBi_map\fR) and/or
saturation values (\fBs_map\fR).  The resulting image will
be displayed in the active display frame on the graphics
monitor.
.PP
Alternately, the user can run the program interactively by
typing \fBd.his\fR without naming parameter values on the
command line.  In this case, the program will prompt the
user for parameter values using the standard GRASS 
GUI interface.
.PP
While any raster map layer can be used to represent the hue
information, map layers with a few very distinct colors
work best.  Only raster map layers representing
continuously varying data like elevation, aspect, weights,
intensities, or amounts can suitably be used to provide
intensity and saturation information.
.PP
For example, a visually pleasing image can be
made by using a watershed map for the \fIhue\fR factor,
an aspect map for the \fIintensity\fR factor, and an
elevation map for \fIsaturation\fR.  (The user may wish
to leave out the elevation information for a first try.)
Ideally, the resulting image should resemble the view from
an aircraft looking at a terrain on a sunny day with a bit
of haze in the valleys.
.PP
The \fBbrighten\fR option does not truly represent a percentage,
but calling it that makes the option easy to understand, and it
sounds better than \fINormalized Scaling Factor\fR.
.SH THE PROCESS
Each map cell is processed individually. First, the working
color is set to the color of the corresponding cell in the
map layer chosen to represent \fIHUE\fR.  Second, this
color is multiplied by the \fIred\fR intensity of that
cell in the \fIINTENSITY\fR map layer.  This map layer
should have an appropriate gray-scale color table
associated with it. You can ensure this by using the color
manipulation capabilities of
\fId.colors\fR or
\fIr.colors\fR.
Finally, the color is made somewhat gray-based on the
\fIred\fR intensity of that cell in the
\fISATURATION\fR map layer.  Again, this map layer
should have a gray-scale color table associated with it.
.SH NOTES
The name is misleading. The actual conversion used is
\fC
.DS
.br
  <U>H.i.s + <U>G.(1-s)
.br
.br
where
.br
.br
  <U>H   is the R,G,B color from the hue map
.br
  i   is the red value from the intensity map
.br
  s   is the red value from the saturation map
.br
  <U>G   is 50% gray (R = G = B = 0.5)
.br
.br
.DE
\fR
.PP
Either (but not both) of the intensity or the saturation
map layers may be omitted. This means that it is possible
to produce output images that represent combinations of
\fIhis, hi,\fR or \fIhs\fR.
.PP
Users wishing to store the result in new raster map layers
instead of displaying it on the monitor should use the
program \fIr.his\fR.
.SH EXAMPLE
.SS Spearfish dataset
\fC
.DS
.br
  g.region rast=elevation.dem
.br
  r.shaded.relief map=elevation.dem shad=elev.shad_relf
.br
  d.mon x1
.br
  d.his h=elevation.dem i=elev.shad_relf brighten=50
.br
.DE
\fR
.br
.SH SEE ALSO
\fI
d.colors,
d.colortable,
d.frame,
d.rgb,
r.colors,
r.his,
i.his.rgb,
i.rgb.his
\fR
.SH AUTHOR
James Westervelt, U.S. Army Construction Engineering Research Laboratory
.PP
\fILast changed: $Date: 2011-11-08 12:29:50 +0100 (Tue, 08 Nov 2011) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team