1g.copy(1)                     Grass User's Manual                    g.copy(1)
2
3
4

NAME

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

KEYWORDS

11       general, map management
12

SYNOPSIS

14       g.copy
15       g.copy help
16       g.copy    [rast=from,to]    [rast3d=from,to]    [vect=from,to]    [old‐
17       vect=from,to]   [asciivect=from,to]   [icon=from,to]   [labels=from,to]
18       [sites=from,to]           [region=from,to]           [region3d=from,to]
19       [group=from,to]   [3dview=from,to]   [--verbose]  [--quiet]
20
21   Parameters:
22       rast=from,to
23           rast file(s) to be copied
24
25       rast3d=from,to
26           rast3d file(s) to be copied
27
28       vect=from,to
29           vect file(s) to be copied
30
31       oldvect=from,to
32           oldvect file(s) to be copied
33
34       asciivect=from,to
35           asciivect file(s) to be copied
36
37       icon=from,to
38           icon file(s) to be copied
39
40       labels=from,to
41           labels file(s) to be copied
42
43       sites=from,to
44           sites file(s) to be copied
45
46       region=from,to
47           region file(s) to be copied
48
49       region3d=from,to
50           region3d file(s) to be copied
51
52       group=from,to
53           group file(s) to be copied
54
55       3dview=from,to
56           3dview file(s) to be copied
57

DESCRIPTION

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

EXAMPLES

68       If the user wished to copy the existing raster file  soils  to  a  file
69       called  soils.ph  and  to  copy  an existing vector map roads to a file
70       called rds.old, the user could type:
71
72
73       g.copy rast=soils,soils.ph vect=roads,rds.old
74
75
76       Data files can also be specified by their mapsets.   For  example,  the
77       below  command copies the raster map named soils from the mapset wilson
78       to a new file called soils  to  be  placed  under  the  user's  current
79       mapset:
80
81
82       g.copy rast='soils@wilson',soils
83
84
85       If  no mapset name is specified, g.copy searches for the named from map
86       in each of the mapset directories listed in the user's  current  mapset
87       search  path  in  the  order  in  which  mapsets  are listed there (see
88       g.mapsets).
89

NOTES

91       If the user does not enter parameter  values  but  instead  types  only
92       g.copy  on the command line the program will prompt the user for a data
93       type, the name of a file of this data type to copy, and the name  of  a
94       new  file  to  hold the copy.  After both file names have been entered,
95       the copy is created and the user is again prompted for a  data  element
96       to  be  copied,  until  the  user  hits RETURN.  When prompted for file
97       names, the user may enter 'list' to see a list of  existing  files,  or
98       hit RETURN to end the file listing.
99
100       If a file has support files (e.g., as do raster data files), these sup‐
101       port files will also be copied.
102

SEE ALSO

104       g.access
105       g.list
106       g.mapsets
107       g.remove
108       g.rename
109       parser
110

AUTHOR

112       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
113
114       Last changed: $Date: 2007-02-12 16:36:55 +0100 (Mon, 12 Feb 2007) $
115
116       Full index
117
118       © 2003-2008 GRASS Development Team
119
120
121
122GRASS 6.3.0                                                          g.copy(1)
Impressum