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


       d.rast.edit  - Edits cell values in a raster map.


       display, editing, raster


       d.rast.edit --help
       d.rast.edit  input=name  output=name   [aspect=name]    [width=integer]   [height=integer]
       [size=integer]   [rows=integer]   [cols=integer]    [--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]
           Name of input raster map

       output=name [required]
           Name for output raster map

           Name of input aspect raster map

           Width of display canvas
           Default: 640

           Height of display canvas
           Default: 480

           Minimum size of each cell
           Default: 12

           Maximum number of rows to load
           Default: 100

           Maximum number of columns to load
           Default: 100


       The  d.rast.edit  program  allows  users  to  interactively edit cell category values in a
       raster map layer displayed to the graphics monitor using a mouse cursor.


       Note: this help page refers to the old Tcl/Tk version of this program. Parts of it may  be
       out of date or wrong.

   Overview window
       An overview window shows the entire map with a box showing the current editing region. The
       edit window shows the cells within the selected area.  Click on a new spot on the overview
       window to move the editing area.  Moving the editing view can take a while.

   Mouse and menus
       Cell  editing is done using a mouse cursor to choose menu selections and indicate areas on
       the displayed raster map that are to be edited.

       Selections available at the top of the edit window are Save and Exit.

       As the mouse travels over the  cells  in  the  edit  window  you  are  shown  the  current
       coordinates and current cell values under the cursor.

       To  change  the  value  of  a  cell put the new value to use in the "New value" box at the
       bottom left of the edit window under the  coordinate  information  bar.  A  value  of  "*"
       indicates a NULL value should be used.

       This  function  is  available  for users editing aspect maps.  The d.rast.arrow program is
       called, which draws arrows over the displayed cells to indicate the downslope direction of
       the  cell.   You  can  set  the  aspect  map  to use on the command line.  Aspect maps are
       expected to be in regular "GRASS" format, as  produced  by  r.slope.aspect;  i.e.  degrees
       counter-clockwise from east.


       There is no "undo" command or way to exit edit mode without saving changes.

       Any  MASK  in place will be respected when writing the new raster map layer, including any
       edits to the MASKed areas.

   Geographic Region Concerns
       d.rast.edit reads the region definition for the raster map layer  being  edited  from  its
       internal  cell  header file. The new, edited copy of the raster layer will be created with
       the same resolution and region dimensions.

       The primary bane of the d.rast.edit program involves large map layers with  lots  of  rows
       and  columns)  and/or  slow  computers,  since  the program must read and write raster map
       layers row by row for the full size of the map layer as dictated by its  region  size  and
       resolution.   (The  current region settings of north, south, east, and west will not limit
       the size of the edited copy of the map layer, since by use of the overview selection these
       values may change several times during the editing session).


       It  would be nice to incorporate a scrollable version of d.legend (such that one could see
       a label legend for files with many categories on a standard size sub-frame).  It would  be
       even  nicer  to be able to select the category values from a graphical legend when editing
       cell values (thereby saving a trip to the text frame to type in the new value).

       Perhaps method(s) for multiple  or mass cell edits would be useful.  This could be done by
       providing modes in which the user may:

       1      edit a block of cells to a given value by drawing a box;

       2      be  able  to  choose  a given value which is automatically used as the new value on
              each cell chosen until a different value is desired.

       There is no interrupt handling.  This could leave files in  .tmp  or  (rarely)  result  in
       half-baked raster maps.  The original file would survive unscathed by an interrupt at most
       any point in execution.  Beware of exiting the program by means other than using  exit  on
       the Main Menu.


        d.rast.arrow, d.rast.num


       Tcl/Tk and wxPython versions: Glynn Clements
       Replaces  Xdriver  version  in  C  by  Chris  Rewerts,  Agricultural  Engineering,  Purdue

       Last changed: $Date: 2012-08-13 17:31:56 +0200 (Mon, 13 Aug 2012) $


       Available at: d.rast.edit source code (history)

       Main index | Display index | Topics index | Keywords index | Graphical index | Full index

       © 2003-2018 GRASS Development Team, GRASS GIS 7.4.0 Reference Manual