NAME

       g.copy   -  Copies  available  data  files  in  the  user's current mapset search path and
       location to the appropriate element directories under the user's current mapset.

KEYWORDS

       general, map management

SYNOPSIS

       g.copy
       g.copy help
       g.copy     [rast=from,to]      [rast3d=from,to]      [vect=from,to]      [oldvect=from,to]
       [asciivect=from,to]         [icon=from,to]         [labels=from,to]        [sites=from,to]
       [region=from,to]   [region3d=from,to]   [group=from,to]    [3dview=from,to]    [--verbose]
       [--quiet]

   Parameters:
       rast=from,to
           rast file(s) to be copied

       rast3d=from,to
           rast3d file(s) to be copied

       vect=from,to
           vect file(s) to be copied

       oldvect=from,to
           oldvect file(s) to be copied

       asciivect=from,to
           asciivect file(s) to be copied

       icon=from,to
           icon file(s) to be copied

       labels=from,to
           labels file(s) to be copied

       sites=from,to
           sites file(s) to be copied

       region=from,to
           region file(s) to be copied

       region3d=from,to
           region3d file(s) to be copied

       group=from,to
           group file(s) to be copied

       3dview=from,to
           3dview file(s) to be copied

DESCRIPTION

       A  user  may  access data stored under the other mapsets listed in his mapset search path.
       However, the user may only modify data stored under his own current mapset.  g.copy allows
       the  user  to  copy  existing  data  files from other mapsets to the user's current mapset
       ($MAPSET).  The files to be copied must exist in the user's current mapset search path and
       location;  output  is  sent  to  the relevant data element directory(ies) under the user's
       current mapset.

EXAMPLES

       If the user wished to copy the existing raster file soils to a file called soils.ph and to
       copy an existing vector map roads to a file called rds.old, the user could type:

       g.copy rast=soils,soils.ph vect=roads,rds.old

       Data  files can also be specified by their mapsets.  For example, the below command copies
       the raster map named soils from the mapset wilson to a new file called soils to be  placed
       under the user's current mapset:

       g.copy rast='soils@wilson',soils

       If  no  mapset  name  is  specified, g.copy searches for the named from map in each of the
       mapset directories listed in the user's current mapset search path in the order  in  which
       mapsets are listed there (see g.mapsets).

NOTES

       If  the  user does not enter parameter values but instead types only g.copy on the command
       line the program will prompt the user for a data type, the name of a  file  of  this  data
       type  to  copy,  and  the name of a new file to hold the copy.  After both file names have
       been entered, the copy is created and the user is again prompted for a data element to  be
       copied,  until  the  user  hits  RETURN.  When prompted for file names, the user may enter
       'list' to see a list of existing files, or hit RETURN to end the file listing.

       If a file has support files (e.g., as do raster data files), these support files will also
       be copied.

SEE ALSO

       g.access
       g.list
       g.mapsets
       g.remove
       g.rename

AUTHOR

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

       Last changed: $Date: 2009-01-05 14:04:18 -0800 (Mon, 05 Jan 2009) $

       Full index

       © 2003-2013 GRASS Development Team