1g.copy(1) GRASS GIS User's Manual g.copy(1)
2
6 g.copy - Creates copies of maps and other elements
7 Copies available data files in the current mapset search path to the
8 user’s current mapset.
9
11 general, map management, copy
12
14 g.copy
15 g.copy --help
16 g.copy [raster=from,to] [raster_3d=from,to] [vector=from,to]
17 [label=from,to] [region=from,to] [group=from,to] [--overwrite]
18 [--help] [--verbose] [--quiet] [--ui]
19 Flags:
21 --overwrite
22 Allow output files to overwrite existing files
23 --help
25 Print usage summary
26 --verbose
28 Verbose module output
29 --quiet
31 Quiet module output
32 --ui
34 Force launching GUI dialog
35 Parameters:
37 raster=from,to
38 raster map(s) to be copied
39 raster_3d=from,to
41 3D raster map(s) to be copied
42 vector=from,to
44 vector map(s) to be copied
45 label=from,to
47 paint label file(s) to be copied
48 region=from,to
50 region definition(s) to be copied
51 group=from,to
53 imagery group(s) to be copied
54
56 The g.copy module creates a copy of existing raster maps, vector maps,
57 or other elements. The copy is always created in the current mapset.
58 The source data can be in the current mapset, in an explicitly speci‐
59 fied mapset, or in a mapset which is in the current mapset search path
60 (typically the PERMANENT mapset).
61 The maps and other elements to copy are specified in pairs from,to ac‐
63 cording to their types. Although typically only one map is copied in
64 one module call, multiple pairs can be provided for each type and mul‐
65 tiple types can be provided at the same time.
66 Relation to mapsets
68 A user may access data stored under the other mapsets listed in their
69 mapset search path. However, the user may only modify data stored under
70 their own current mapset. g.copy allows the user to copy existing data
71 files from other mapsets to the user’s current mapset (g.mapset -p).
72 The files to be copied must exist in the user’s current mapset search
73 path (g.mapsets -p) and location; output is sent to the relevant data
74 element directory(ies) under the user’s current mapset.
75 Behavior on error
77 Errors typically occur when a map or other element does not exist, from
78 and to are the same, to element already exists and overwriting (e.g.,
79 by --overwrite) is not enabled, or the to element has an illegal name.
80 When only one map or other element is requested to be copied and the
81 copying is not possible or fails, an error is reported.
82 If multiple maps or other elements are copied in one command, g.copy
84 attempts to copy as much as possible even when problems occur with one
85 of the elements. In that case, copying of the element causing problems
86 is skipped, and g.copy proceeds with copying the remaining elements.
87 If nothing can be copied or an error occurred during one of the copy
88 operations, an error message is reported after other possible copy op‐
89 erations were performed.
90
92 If the user wished to copy the existing raster file soils to a file
93 called soils.ph and to copy an existing vector map roads to a file
94 called rds.old, the user could type:
95 g.copy raster=soils,soils.ph
96 g.copy vector=roads,rds.old
97 # or even combined:
98 g.copy raster=soils,soils.ph vector=roads,rds.old
99 Data files can also be specified by their mapsets. For example, the
101 below command copies the raster map named soils from the mapset wilson
102 to a new file called soils to be placed under the user’s current
103 mapset:
104 g.copy raster=soils@wilson,soils
105 If no mapset name is specified, g.copy searches for the named from map
106 in each of the mapset directories listed in the user’s current mapset
107 search path in the order in which mapsets are listed there (see
108 g.mapsets).
109
111 g.access, g.list, g.mapsets, g.remove, g.rename
112
114 Michael Shapiro, U.S. Army Construction Engineering Research Laboratory
115
117 Available at: g.copy source code (history)
118 Accessed: Saturday Jan 21 21:14:18 2023
120 Main index | General index | Topics index | Keywords index | Graphical
122 index | Full index
123 © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
125GRASS 8.2.1 g.copy(1)