1ogrmerge(1) General Commands Manual ogrmerge(1)
2
3
4
6 ogrmergeMerge several vector datasets into a single one.
7
9 ogrmerge.py -o out_dsname src_dsname [src_dsname]*
10 [-f format] [-single] [-nln layer_name_template]
11 [-update | -overwrite_ds] [-append | -overwrite_layer]
12 [-src_geom_type geom_type_name[,geom_type_name]*]
13 [-dsco NAME=VALUE]* [-lco NAME=VALUE]*
14 [-s_srs srs_def] [-t_srs srs_def | -a_srs srs_def]
15 [-progress] [-skipfailures] [--help-general]
16
17 Options specific to -single:
18 [-field_strategy FirstLayer|Union|Intersection]
19 [-src_layer_field_name name]
20 [-src_layer_field_content layer_name_template]
21
23 (Available since GDAL 2.2)
24
25 The ogrmerge.py script takes as input several vector datasets, each of
26 them having one or several vector layers, and copy them in a target
27 dataset.
28
29 There are essential two modes :
30
31 · the default one, where each input vector layer, is copied as a
32 separate layer into the target dataset
33
34 · another one, activated with the -single switch, where the content of
35 all input vector layers is appended into a single target layer. This
36 assumes that the schema of those vector layers is more or less the
37 same.
38
39 Internally this generates a VRT file, and if the output format is not
40 VRT, final translation is done with ogr2ogr / gdal.VectorTranslate. So
41 for advanced uses, output to VRT, potential manual editing of it and
42 ogr2ogr can be done.
43
44 -o out_dsname:
45 Output dataset name. Required.
46
47 src_dsname:
48 One or several input vector datasets. Required
49
50 -f format:
51 Select the output format. Starting with GDAL 2.3, if not specified,
52 the format is guessed from the extension (previously was ESRI
53 Shapefile). Use the short format name
54
55 -single:
56 If specified, all input vector layers will be merged into a single
57 one.
58
59 -nln layer_name_template:
60 Name of the output vector layer (in single mode, and the default is
61 'merged'), or template to name the output vector layers in default
62 mode (the default value is '{AUTO_NAME}'). The template can be a
63 string with the following variables that will be susbstitued with a
64 value computed from the input layer being processed:
65
66 · {AUTO_NAME}: equivalent to {DS_BASENAME}_{LAYER_NAME} if both values
67 are different, or {LAYER_NAME} when they are identical (case of
68 shapefile). 'different
69
70 · {DS_NAME} : name of the source dataset
71
72 · {DS_BASENAME}: base name of the source dataset
73
74 · {DS_INDEX} : index of the source dataset
75
76 · {LAYER_NAME} : name of the source layer
77
78 · {LAYER_INDEX}: index of the source layer
79
80 -update
81 Open an existing dataset in update mode.
82
83 -overwrite_ds
84 Overwrite the existing dataset if it already exists (for file based
85 datasets)
86
87 -append
88 Open an existing dataset in update mode, and if output layers
89 already exist, append the content of input layers to them.
90
91 -overwrite_layer
92 Open an existing dataset in update mode, and if output layers
93 already exist, replace their content with the one of the input
94 layer.
95
96 -src_geom_type geom_type_name[,geom_type_name]*]:
97 Only take into account input layers whose geometry type match the
98 type(s) specified. Valid values for geom_type_name are GEOMETRY,
99 POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING,
100 MULTIPOINT, GEOMETRYCOLLECTION, CIRCULARSTRING, CURVEPOLYGON,
101 MULTICURVE, MULTISURFACE, CURVE, SURFACE, TRIANGLE,
102 POLYHEDRALSURFACE and TIN.
103
104 -dsco NAME=VALUE:
105 Dataset creation option (format specific)
106
107 -lco NAME=VALUE:
108 Layer creation option (format specific)
109
110 -a_srs srs_def:
111 Assign an output SRS
112
113 -t_srs srs_def:
114 Reproject/transform to this SRS on output
115
116 -s_srs srs_def:
117 Override source SRS
118
119 -progress:
120 Display progress on terminal. Only works if input layers have the
121 'fast feature count' capability.
122
123 -skipfailures:
124 Continue after a failure, skipping the failed feature.
125
126 -field_strategy FirstLayer|Union|Intersection:
127 Only used with -single. Determines how the schema of the target
128 layer is built from the schemas of the input layers. May be
129 FirstLayer to use the fields from the first layer found, Union to
130 use a super-set of all the fields from all source layers, or
131 Intersection to use a sub-set of all the common fields from all
132 source layers. Defaults to Union.
133
134 -src_layer_field_name name:
135 Only used with -single. If specified, the schema of the target
136 layer will be extended with a new field 'name', whose content is
137 determined by -src_layer_field_content.
138
139 -src_layer_field_content layer_name_template:
140 Only used with -single. If specified, the schema of the target
141 layer will be extended with a new field (whose name is given by
142 -src_layer_field_name, or 'source_ds_lyr' otherwise), whose content
143 is determined by layer_name_template. The syntax of
144 layer_name_template is the same as for -nln.
145
147 · Creates a VRT with a layer for each input shapefiles
148
149 ogrmerge.py -f VRT -o merged.vrt *.shp
150
151
152 · Same, but creates a GeoPackage file
153
154 ogrmerge.py -f GPKG -o merged.gpkg *.shp
155
156
157 · Concatenate the content of france.shp and germany.shp in merged.shp,
158 and adds a 'country' field to each feature whose value is 'france' or
159 'germany' depending where it comes from.
160
161 ogrmerge.py -single -o merged.shp france.shp germany.shp -src_layer_field_name country
162
163
165 Even Rouault even.rouault@spatialys.com
166
167
168
169GDAL Tue Mar 3 2020 ogrmerge(1)