1r.rescale.eq(1)             GRASS GIS 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, rescale
11

SYNOPSIS

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

DESCRIPTION

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

EXAMPLE

63       To rescale an elevation raster map layer with category  values  ranging
64       from  1090  meters  to  1800 meters into the range 0-255, the following
65       command line could be used (without the from parameter, the full  value
66       range will be used):
67       r.rescale.eq input=elevation from=1090,1800 output=elevation.255 to=0,255
68

NOTES

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

SEE ALSO

81        r.coin, r.describe, r.info, r.mapcalc, r.reclass, r.rescale, r.report,
82       r.resample, r.stats
83

AUTHOR

85       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
86

SOURCE CODE

88       Available at: r.rescale.eq source code (history)
89
90       Accessed: Mon Jun 20 16:46:24 2022
91
92       Main index | Raster index | Topics index | Keywords index  |  Graphical
93       index | Full index
94
95       © 2003-2022 GRASS Development Team, GRASS GIS 8.2.0 Reference Manual
96
97
98
99GRASS 8.2.0                                                    r.rescale.eq(1)
Impressum