r.rescale.eq(1grass)

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, 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
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.eq program rescales the range of category values appear‐
54       ing in a raster map layer with equalized histogram.  A new  raster  map
55       layer,  and an appropriate category file and color table based upon the
56       original raster map layer, are  generated  with  category  labels  that
57       reflect the original category values that produced each category.  This
58       command is useful for producing representations with a  reduced  number
59       of  categories  from  a raster map layer with a large range of category
60       values (e.g., elevation).  Rescaled map layers are appropriate for  use
61       in such GRASS GIS commands 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.eq 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.eq 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.eq,  the  input  raster  map
78       layer is examined, and the minimum and maximum non-NULL category values
79       are selected as the input range.
80

AUTHOR

86       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
87
88       Last changed: $Date: 2014-12-09 19:39:37 +0100 (Tue, 09 Dec 2014) $
89

SOURCE CODE

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