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

DESCRIPTION

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

EXAMPLE

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

NOTES

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

SEE ALSO

82         r.coin,  r.describe,  r.info,  r.mapcalc,  r.reclass,   r.rescale.eq,
83       r.report, r.resample, r.stats, r.univar
84

AUTHOR

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

SOURCE CODE

89       Available at: r.rescale source code (history)
90
91       Main  index  | Raster index | Topics index | Keywords index | Graphical
92       index | Full index
93
94       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
95
96
97
98GRASS 7.8.5                                                       r.rescale(1)