<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>GRASS GIS: g.copy</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> <link rel="stylesheet" href="grassdocs.css" type="text/css"> </head> <body bgcolor="white"> <img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade> <h2>NAME</h2> <em><b>g.copy</b></em> - 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. <h2>KEYWORDS</h2> general, map management <h2>SYNOPSIS</h2> <b>g.copy</b><br> <b>g.copy help</b><br> <b>g.copy</b> [<b>rast</b>=<em>from,to</em>] [<b>rast3d</b>=<em>from,to</em>] [<b>vect</b>=<em>from,to</em>] [<b>oldvect</b>=<em>from,to</em>] [<b>asciivect</b>=<em>from,to</em>] [<b>icon</b>=<em>from,to</em>] [<b>labels</b>=<em>from,to</em>] [<b>sites</b>=<em>from,to</em>] [<b>region</b>=<em>from,to</em>] [<b>region3d</b>=<em>from,to</em>] [<b>group</b>=<em>from,to</em>] [<b>3dview</b>=<em>from,to</em>] [--<b>verbose</b>] [--<b>quiet</b>] <h3>Parameters:</h3> <DL> <DT><b>rast</b>=<em>from,to</em></DT> <DD>rast file(s) to be copied</DD> <DT><b>rast3d</b>=<em>from,to</em></DT> <DD>rast3d file(s) to be copied</DD> <DT><b>vect</b>=<em>from,to</em></DT> <DD>vect file(s) to be copied</DD> <DT><b>oldvect</b>=<em>from,to</em></DT> <DD>oldvect file(s) to be copied</DD> <DT><b>asciivect</b>=<em>from,to</em></DT> <DD>asciivect file(s) to be copied</DD> <DT><b>icon</b>=<em>from,to</em></DT> <DD>icon file(s) to be copied</DD> <DT><b>labels</b>=<em>from,to</em></DT> <DD>labels file(s) to be copied</DD> <DT><b>sites</b>=<em>from,to</em></DT> <DD>sites file(s) to be copied</DD> <DT><b>region</b>=<em>from,to</em></DT> <DD>region file(s) to be copied</DD> <DT><b>region3d</b>=<em>from,to</em></DT> <DD>region3d file(s) to be copied</DD> <DT><b>group</b>=<em>from,to</em></DT> <DD>group file(s) to be copied</DD> <DT><b>3dview</b>=<em>from,to</em></DT> <DD>3dview file(s) to be copied</DD> </DL> <h2>DESCRIPTION</h2> 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. <em>g.copy</em> allows the user to copy existing data files <em>from</em> other mapsets <em>to</em> 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. <h2>EXAMPLES</h2> If the user wished to copy the existing raster file <em>soils</em> to a file called <em>soils.ph</em> and to copy an existing vector map <em>roads</em> to a file called <em>rds.old</em>, the user could type: <p> <div class="code"><pre> g.copy rast=soils,soils.ph vect=roads,rds.old </pre></div> <p> Data files can also be specified by their mapsets. For example, the below command copies the raster map named <em>soils</em> from the mapset <em>wilson</em> to a new file called <em>soils</em> to be placed under the user's current mapset: <p> <div class="code"><pre> g.copy rast='soils@wilson',soils </pre></div> <p> If no mapset name is specified, <em>g.copy</em> searches for the named <em>from</em> 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 <em><a HREF="g.mapsets.html">g.mapsets</a></em>). <H2>NOTES</H2> If the user does not enter parameter values but instead types only <b>g.copy</b> 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. <p> If a file has support files (e.g., as do raster data files), these support files will also be copied. <h2>SEE ALSO</h2> <em><a HREF="g.access.html">g.access</a></em><br> <em><a HREF="g.list.html">g.list</a></em><br> <em><a HREF="g.mapsets.html">g.mapsets</a></em><br> <em><a HREF="g.remove.html">g.remove</a></em><br> <em><a HREF="g.rename.html">g.rename</a></em><br> <em><a HREF="parser.html">parser</a></em> <h2>AUTHOR</h2> Michael Shapiro, U.S.Army Construction Engineering Research Laboratory <p><i>Last changed: $Date: 2007-02-12 16:36:55 +0100 (Mon, 12 Feb 2007) $</i><p> <HR> <P><a href="index.html">Main index</a> - <a href="general.html">general index</a> - <a href="full_index.html">Full index</a></P> <P>© 2003-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p> </body> </html>