r.rescale.eq(1)

1r.rescale.eq(1)               Grass User's Manual              r.rescale.eq(1)
2
3
4

NAME

6       r.rescale.eq  - Rescales histogram equalized the range of category val‐
7       ues in a raster map layer.
8

KEYWORDS

10       raster
11

SYNOPSIS

13       r.rescale.eq
14       r.rescale.eq help
15       r.rescale.eq   [-q]   input=string     [from=min,max]     output=string
16       to=min,max  [title="phrase"]   [--overwrite]  [--verbose]  [--quiet]
17
18   Flags:
19       -q
20           Quiet
21
22       --overwrite
23           Allow output files to overwrite existing files
24
25       --verbose
26           Verbose module output
27
28       --quiet
29           Quiet module output
30
31   Parameters:
32       input=string
33           The name of the raster map to be rescaled
34
35       from=min,max
36           The  input  data range to be rescaled (default: full range of input
37           map)
38
39       output=string
40           The resulting raster map name
41
42       to=min,max
43           The output data range
44
45       title=
46           Title for new raster map
47

DESCRIPTION

49       The r.rescale.eq program rescales the range of category values  appear‐
50       ing  in  a raster map layer with equalized histogram.  A new raster map
51       layer, and an appropriate category file and color table based upon  the
52       original  raster  map  layer,  are  generated with category labels that
53       reflect the original category values that produced each category.  This
54       command  is  useful for producing representations with a reduced number
55       of categories from a raster map layer with a large  range  of  category
56       values  (e.g., elevation).  Rescaled map layers are appropriate for use
57       in such GRASS programs as r.stats, r.report, and r.coin.
58

EXAMPLE

60       To rescale an elevation raster map layer with category  values  ranging
61       from  1090  meters  to  1800 meters into the range 0-255, the following
62       command line could be used: r.rescale.eq input=elevation from=1090,1800
63       output=elevation.255 to=0,255
64

NOTES

66       Category  values  that  fall  beyond  the input range will become NULL.
67       This allows the user to select a subset  of  the  full  category  value
68       range  for  rescaling if desired.  This also means that the user should
69       know the category value range for the input raster map layer.  The user
70       can  request  the  r.rescale.eq program to determine this range, or can
71       obtain it using the r.describe or  r.info  command.   If  the  category
72       value  range  is  determined  using  r.rescale.eq, the input raster map
73       layer is examined, and the minimum and maximum non-NULL category values
74       are selected as the input range.
75

AUTHOR

81       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
82
83       Last changed: $Date: 2003-05-06 17:35:18 +0200 (Tue, 06 May 2003) $
84
85       Full index
86
87       © 2003-2008 GRASS Development Team
88
89
90
91GRASS 6.3.0                                                    r.rescale.eq(1)