Note: A new GRASS GIS stable version has been released: GRASS GIS 7. Go directly to the new manual page here
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] [--verbose] [--quiet]
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
SEE ALSO
g.copy
g.list
g.remove
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
© 2003-2016 GRASS Development Team