GRASS GIS manual: g.rename

Note: This document is for an older version of GRASS GIS that is outdated. You should upgrade, and read the current manual page.

NAME

g.rename - Renames data base element files in the user's current mapset.

KEYWORDS

general, map management

SYNOPSIS

g.rename
g.rename help
g.rename [rast=old,new] [rast3d=old,new] [vect=old,new] [oldvect=old,new] [asciivect=old,new] [icon=old,new] [labels=old,new] [sites=old,new] [region=old,new] [region3d=old,new] [group=old,new] [3dview=old,new] [--overwrite] [--verbose] [--quiet]

Flags:

--overwrite: Allow output files to overwrite existing files
--verbose: Verbose module output
--quiet: Quiet module output

Parameters:

rast=old,new: rast file(s) to be renamed
rast3d=old,new: rast3d file(s) to be renamed
vect=old,new: vect file(s) to be renamed
oldvect=old,new: oldvect file(s) to be renamed
asciivect=old,new: asciivect file(s) to be renamed
icon=old,new: icon file(s) to be renamed
labels=old,new: labels file(s) to be renamed
sites=old,new: sites file(s) to be renamed
region=old,new: region file(s) to be renamed
region3d=old,new: region3d file(s) to be renamed
group=old,new: group file(s) to be renamed
3dview=old,new: 3dview file(s) to be renamed

DESCRIPTION

g.rename allows the user to rename data base element files in the user's current mapset. The user can specify all necessary information to g.rename on the command line, by specifying: the type of data base element to be renamed (one or more of: rast, vect, icon, labels, sites, region, and group); the specific file element in the current mapset to be renamed (old); and the new name to be assigned to this file element (new) in the current mapset. The file element old is then renamed to new.

Users can also simply type g.rename -help without arguments on the command line, to receive a menu of existing data base element types and files from which to choose for possible renaming:

     rast   rast file(s) to be renamed
  oldvect   oldvect file(s) to be renamed (GRASS 5.0)
     vect   vect file(s) to be renamed	  (GRASS >5.1)
     icon   icon file(s) to be renamed
   labels   labels file(s) to be renamed
    sites   sites file(s) to be renamed
   region   region file(s) to be renamed
    group   group file(s) to be renamed
   3dview   3dview file(s) to be renamed

NOTES

If a data base element has support files (e.g., as is commonly the case with raster maps), these support files also are renamed.

If the user attempts to rename a file to itself by setting the new file name equal to the old file name (e.g., g.rename rast=soils,soils), g.rename will not execute the rename, but instead state that no rename is needed. However, g.rename will allow the user to overwrite other existing files in the current mapset by making the new file name that of an already existing file.

For portability reasons, g.rename is ignoring case of names. To change the case of a map name, first rename the map to a name which differs by more than case, then rename it to the intended name.

EXAMPLE

# rename raster map
g.rename rast=oldrast,newrast

# rename vector map
g.rename vect=oldvect,newvect

# combined renaming
g.rename rast=oldrast,newrast vect=oldvect,newvect

AUTHOR

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

Last changed: $Date: 2008-10-11 23:55:55 -0700 (Sat, 11 Oct 2008) $

Main index - general index - Full index