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

GRASS 6.4.3                                                                                       g.copy(1grass)