Provided by: grass-doc_7.6.0-1_all bug


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


       raster, rescale


       r.rescale --help
       r.rescale    input=name     [from=min,max]     output=name    to=min,max    [title=phrase]
       [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

           Allow output files to overwrite existing files

           Print usage summary

           Verbose module output

           Quiet module output

           Force launching GUI dialog

       input=name [required]
           The name of the raster map to be rescaled

           The input data range to be rescaled (default: full range of input map)

       output=name [required]
           The resulting raster map name

       to=min,max [required]
           The output data range

           Title for new raster map


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


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


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


        r.coin, r.describe,, r.mapcalc,  r.reclass,  r.rescale.eq,,  r.resample,
       r.stats, r.univar


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

       Last changed: $Date: 2016-05-03 19:09:18 +0200 (Tue, 03 May 2016) $


       Available at: r.rescale source code (history)

       Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

       © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual