1r.rescale(1)                GRASS GIS User's Manual               r.rescale(1)
2
3
4

NAME

6       r.rescale   -  Rescales  the  range  of category values in a raster map
7       layer.
8

KEYWORDS

10       raster, rescale
11

SYNOPSIS

13       r.rescale
14       r.rescale --help
15       r.rescale  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 program rescales the range of category  values  appearing
53       in a raster map layer. A new raster map layer, and an appropriate cate‐
54       gory file and color table based upon the original raster map layer, are
55       generated  with category labels that reflect the original category val‐
56       ues that produced each category.  This command is useful for  producing
57       representations  with  a reduced number of categories from a raster map
58       layer  with  a  large  range  of  category  values  (e.g.,  elevation).
59       Rescaled  map layers are appropriate for use in such GRASS GIS commands
60       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 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 program to determine this range, or can ob‐
75       tain it using the r.describe or r.info command.  If the category  value
76       range  is determined using r.rescale, the input raster map layer is ex‐
77       amined, and the minimum and maximum non-NULL category  values  are  se‐
78       lected as the input range.
79

SEE ALSO

81         r.coin, r.describe, r.info, r.mapcalc, r.reclass, r.rescale.eq, r.re‐
82       port, r.resample, r.stats, r.univar
83

AUTHOR

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

SOURCE CODE

88       Available at: r.rescale source code (history)
89
90       Accessed: Saturday Oct 28 18:17:55 2023
91
92       Main index | Raster index | Topics index | Keywords index  |  Graphical
93       index | Full index
94
95       © 2003-2023 GRASS Development Team, GRASS GIS 8.3.1 Reference Manual
96
97
98
99GRASS 8.3.1                                                       r.rescale(1)