NAMEg.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.
KEYWORDSgeneral, map management
SYNOPSISg.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
DESCRIPTIONA 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.
EXAMPLESIf 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).
NOTESIf 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 ALSOg.access g.list g.mapsets g.remove g.rename
AUTHORMichael Shapiro, U.S.Army Construction Engineering Research Laboratory Last changed: $Date: 2009-01-05 23:08:26 +0100 (Mon, 05 Jan 2009) $ Full index (C) 2003-2010 GRASS Development Team G.COPY(1)