<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>GRASS GIS: r.his</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> <link rel="stylesheet" href="grassdocs.css" type="text/css"> </head> <body bgcolor="white"> <img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade> <h2>NAME</h2> <em><b>r.his</b></em> - Generates red, green and blue raster map layers combining hue, intensity and saturation (HIS) values from user-specified input raster map layers. <h2>KEYWORDS</h2> raster <h2>SYNOPSIS</h2> <b>r.his</b><br> <b>r.his help</b><br> <b>r.his</b> [-<b>n</b>] <b>h_map</b>=<em>string</em> [<b>i_map</b>=<em>string</em>] [<b>s_map</b>=<em>string</em>] <b>r_map</b>=<em>string</em> <b>g_map</b>=<em>string</em> <b>b_map</b>=<em>string</em> [--<b>overwrite</b>] [--<b>verbose</b>] [--<b>quiet</b>] <h3>Flags:</h3> <DL> <DT><b>-n</b></DT> <DD>Respect NULL values while drawing</DD> <DT><b>--overwrite</b></DT> <DD>Allow output files to overwrite existing files</DD> <DT><b>--verbose</b></DT> <DD>Verbose module output</DD> <DT><b>--quiet</b></DT> <DD>Quiet module output</DD> </DL> <h3>Parameters:</h3> <DL> <DT><b>h_map</b>=<em>string</em></DT> <DD>Name of layer to be used for HUE</DD> <DT><b>i_map</b>=<em>string</em></DT> <DD>Name of layer to be used for INTENSITY</DD> <DT><b>s_map</b>=<em>string</em></DT> <DD>Name of layer to be used for SATURATION</DD> <DT><b>r_map</b>=<em>string</em></DT> <DD>Name of output layer to be used for RED</DD> <DT><b>g_map</b>=<em>string</em></DT> <DD>Name of output layer to be used for GREEN</DD> <DT><b>b_map</b>=<em>string</em></DT> <DD>Name of output layer to be used for BLUE</DD> </DL> <H2>DESCRIPTION</H2> <EM>his</EM> stands for hue, intensity, and saturation. This program produces red, green and blue raster map layers providing a visually pleasing combination of hue, intensity, and saturation values from two or three user-specified raster map layers. <P> The human brain automatically interprets the vast amount of visual information available according to basic rules. Color, or <EM>hue</EM>, is used to categorize objects. Shading, or <EM>intensity</EM>, is interpreted as three-dimensional texturing. Finally, the degree of haziness, or <EM>saturation</EM>, is associated with distance or depth. This program allows data from up to three raster map layers to be combined into a color image (in the form of separate red, green and blue raster map layers) which retains the original information in terms of <EM>hue</EM>, <EM>intensity</EM>, and <EM>saturation</EM>. <P> 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. <P> For example, a visually pleasing image can be made by using a watershed map for the <EM>hue</EM> factor, an aspect map for the <EM>intensity</EM> factor, and an elevation map for <EM>saturation</EM>. (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. <H2>THE PROCESS</H2> 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 <EM>HUE</EM>. Second, this color is multiplied by the <EM>red</EM> intensity of that cell in the <EM>INTENSITY</EM> 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 <EM><A HREF="d.colors.html">d.colors</A></EM> or <EM><A HREF="r.colors.html">r.colors</A></EM>. Finally, the color is made somewhat gray-based on the <EM>red</EM> intensity of that cell in the <EM>SATURATION</EM> map layer. Again, this map layer should have a gray-scale color table associated with it. <H2>NOTES</H2> The name is misleading. The actual conversion used is <PRE> <U>H</U>.i.s + <U>G</U>.(1-s) where <U>H</U> is the R,G,B color from the hue map i is the red value from the intensity map s is the red value from the saturation map <U>G</U> is 50% gray (R = G = B = 0.5) </PRE> <P> 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 <EM>his, hi,</EM> or <EM>hs</EM>. The separate <EM>red</EM>, <EM>green</EM> and <EM>blue</EM> maps can be displayed on the graphics monitor using <EM><A HREF="d.rgb.html">d.rgb</A></EM>, or combined into a composite RGB layer using <EM><A HREF="r.composite.html">r.composite</A></EM>. Users wishing to simply display an <EM>his</EM> composite image without actually generating any layers should use the program <EM><A HREF="d.his.html">d.his</A></EM>. <H2>EXAMPLE</H2> Recreate the following <em>d.his</em> command using <em>r.his</em>: <div class="code"><pre> r.shaded.relief map=elevation.dem shad=elev.shad_relf d.his h=elevation.dem i=elev.shad_relf brighten=50 </pre></div> <div class="code"><pre> r.mapcalc 'elev.shad_relf_bright50 = #elev.shad_relf * 1.5' r.colors elev.shad_relf_bright50 color=grey255 r.his h=elevation.dem i=elev.shad_relf_bright50 r=esr.r g=esr.g b=esr.b d.rgb r=esr.r g=esr.g b=esr.b </pre></div> <H2>SEE ALSO</H2> <EM><A HREF="d.his.html">d.his</A></EM>, <EM><A HREF="d.colors.html">d.colors</A></EM>, <EM><A HREF="d.colortable.html">d.colortable</A></EM>, <EM><A HREF="d.rgb.html">d.rgb</A></EM>, <EM><A HREF="r.blend.html">r.blend</A></EM>, <EM><A HREF="r.colors.html">r.colors</A></EM>, <EM><A HREF="r.composite.html">r.composite</A></EM> <EM><A HREF="i.his.rgb.html">i.his.rgb</A></EM>, <EM><A HREF="i.rgb.his.html">i.rgb.his</A></EM> <H2>AUTHOR</H2> Glynn Clements (based upon <EM><A HREF="d.his.html">d.his</A></EM>) <p><i>Last changed: $Date: 2007-10-25 14:33:03 +0200 (Thu, 25 Oct 2007) $</i> <HR> <P><a href="index.html">Main index</a> - <a href="raster.html">raster index</a> - <a href="full_index.html">Full index</a></P> <P>© 2003-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p> </body> </html>
