d.rast.num.html 5.36 KB
Newer Older
xuebingbing's avatar
xuebingbing committed
1 2 3
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
xuebingbing's avatar
xuebingbing committed
4
<title>d.rast.num - GRASS GIS manual</title>
xuebingbing's avatar
xuebingbing committed
5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159
<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">
<div id="container">

<a href="index.html"><img src="grass_logo.png" alt="GRASS logo"></a>
<hr class="header">

<h2>NAME</h2>
<em><b>d.rast.num</b></em>  - Overlays cell category values on a raster map displayed in the active graphics frame.
<h2>KEYWORDS</h2>
<a href="display.html">display</a>, <a href="topic_map_annotations.html">map annotations</a>, <a href="keywords.html#raster">raster</a>
<h2>SYNOPSIS</h2>
<div id="name"><b>d.rast.num</b><br></div>
<b>d.rast.num --help</b><br>
<div id="synopsis"><b>d.rast.num</b> [-<b>af</b>] <b>map</b>=<em>name</em>  [<b>text_color</b>=<em>name</em>]   [<b>grid_color</b>=<em>name</em>]   [<b>precision</b>=<em>integer</em>]   [<b>font</b>=<em>string</em>]   [<b>path</b>=<em>name</em>]   [<b>charset</b>=<em>string</em>]   [--<b>help</b>]  [--<b>verbose</b>]  [--<b>quiet</b>]  [--<b>ui</b>] 
</div>

<div id="flags">
<h3>Flags:</h3>
<dl>
<dt><b>-a</b></dt>
<dd>Align grids with raster cells</dd>

<dt><b>-f</b></dt>
<dd>Get text color from cell color value</dd>

<dt><b>--help</b></dt>
<dd>Print usage summary</dd>
<dt><b>--verbose</b></dt>
<dd>Verbose module output</dd>
<dt><b>--quiet</b></dt>
<dd>Quiet module output</dd>
<dt><b>--ui</b></dt>
<dd>Force launching GUI dialog</dd>
</dl>
</div>

<div id="parameters">
<h3>Parameters:</h3>
<dl>
<dt><b>map</b>=<em>name</em>&nbsp;<b>[required]</b></dt>
<dd>Name of raster map</dd>

<dt><b>text_color</b>=<em>name</em></dt>
<dd>Text color</dd>
<dd>Either a standard color name or R:G:B triplet</dd>
<dd>Default: <em>black</em></dd>

<dt><b>grid_color</b>=<em>name</em></dt>
<dd>Grid color</dd>
<dd>Either a standard color name, R:G:B triplet, or "none"</dd>
<dd>Default: <em>gray</em></dd>

<dt><b>precision</b>=<em>integer</em></dt>
<dd>Number of significant digits (floating point only)</dd>
<dd>Options: <em>0, 1, 2, 3, 4, 5, 6, 7, 8, 9</em></dd>
<dd>Default: <em>1</em></dd>

<dt><b>font</b>=<em>string</em></dt>
<dd>Font name</dd>

<dt><b>path</b>=<em>name</em></dt>
<dd>Path to font file</dd>

<dt><b>charset</b>=<em>string</em></dt>
<dd>Text encoding (only applicable to TrueType fonts)</dd>

</dl>
</div>
<div class="toc">
<h4 class="toc">Table of contents</h4>
<ul class="toc">
    <li class="toc"><a href="#description" class="toc">DESCRIPTION</a></li>
    <li class="toc"><a href="#notes" class="toc">NOTES</a></li>
    <li class="toc"><a href="#example" class="toc">EXAMPLE</a></li>
    <li class="toc"><a href="#see-also" class="toc">SEE ALSO</a></li>
    <li class="toc"><a href="#authors" class="toc">AUTHORS</a></li>
</ul>
</div>
<h2><a name="description">DESCRIPTION</a></h2>

<em>d.rast.num</em>
overlays cell category values onto a raster map layer displayed
on the user's graphics monitor.

Category values will be displayed in the text color given and scaled
to fit within a single cell. A grid outlining each map cell will also 
be overlain in a user-specified color, unless it has been set to "none".

<p>If no grid color is given the default will be used. If no map layer
is specified, the program will use whatever raster map layer is
currently displayed in the active frame on the graphics monitor.
<p>If the <b>-f</b> flag is given the displayed number will take on the color 
of the base map in that cell.


<h2><a name="notes">NOTES</a></h2>

The user is advised to set the current region to a relatively
small area (i.e., less than 100 rows by 100 columns);
otherwise, the individual cells being displayed will be small
and the category value associated with each will be difficult to see.
No data cells are indicated with "Null".

<h2><a name="example">EXAMPLE</a></h2>

A) Distance from the streams network (North Carolina sample dataset):
<div class="code"><pre>
g.region raster=streams_derived -p
r.grow.distance input=streams_derived distance=dist_from_streams
d.rast.num dist_from_streams -a
</pre></div>

<div align="center" style="margin: 10px">
<img src="d_rast_num_zoom.png" border=0><br>
<i>Euclidean distance from the streams network in meters (detail, numbers shown
   with d.rast.num)</i>
</div>

<h2><a name="see-also">SEE ALSO</a></h2>

<em>
<a href="d.frame.html">d.frame</a>,
<a href="d.grid.html">d.grid</a>,
<a href="d.rast.html">d.rast</a>,
<a href="d.rast.arrow.html">d.rast.arrow</a>,
<a href="d.rast.edit.html">d.rast.edit</a>,
<a href="g.region.html">g.region</a>,
<a href="r.slope.aspect.html">r.slope.aspect</a>
</em>


<h2><a name="authors">AUTHORS</a></h2>

Raghavan Srinivasan,
and Chris Rewerts,<br>
Agricultural Engineering, Purdue University

<!--
<p>
<i>Last changed: $Date$</i>
--><h2>SOURCE CODE</h2>
<p>Available at: <a href="https://github.com/OSGeo/grass/tree/master/display/d.rast.num">d.rast.num source code</a> (<a href="https://github.com/OSGeo/grass/commits/master/display/d.rast.num">history</a>)</p>
<hr class="header">
<p>
<a href="index.html">Main index</a> |
<a href="display.html">Display index</a> |
<a href="topics.html">Topics index</a> |
<a href="keywords.html">Keywords index</a> |
<a href="graphical_index.html">Graphical index</a> |
<a href="full_index.html">Full index</a>
</p>
<p>
xuebingbing's avatar
xuebingbing committed
160
&copy; 2003-2020
xuebingbing's avatar
xuebingbing committed
161
<a href="http://grass.osgeo.org">GRASS Development Team</a>,
xuebingbing's avatar
xuebingbing committed
162
GRASS GIS 7.8.5 Reference Manual
xuebingbing's avatar
xuebingbing committed
163 164 165 166 167
</p>

</div>
</body>
</html>