1OGRMERGE(1) GDAL OGRMERGE(1)
2
6 ogrmerge - Merge 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 Options specific to the -single option:
18 [-field_strategy FirstLayer|Union|Intersection]
20 [-src_layer_field_name name]
21 [-src_layer_field_content layer_name_template]
22
24 New in version 2.2.
25 ogrmerge.py script takes as input several vector datasets, each of them
28 having one or several vector layers, and copy them in a target dataset.
29 There are essential two modes:
31 • the default one, where each input vector layer, is copied as a sepa‐
33 rate layer into the target dataset
34 • another one, activated with the -single switch, where the content of
36 all input vector layers is appended into a single target layer. This
37 assumes that the schema of those vector layers is more or less the
38 same.
39 Internally this generates a vector.vrt file, and if the output format
41 is not VRT, final translation is done with ogr2ogr or gdal.VectorTrans‐
42 late(). So, for advanced uses, output to VRT, potential manual editing
43 of it and ogr2ogr can be done.
44 -o <out_dsname
46 Output dataset name. Required.
47 <src_dsname>
49 One or several input vector datasets. Required
50 -f <format>
52 Select the output format. Starting with GDAL 2.3, if not speci‐
53 fied, the format is guessed from the extension (previously was
54 ESRI Shapefile). Use the short format name
55 -single
57 If specified, all input vector layers will be merged into a sin‐
58 gle one.
59 -nln <layer_name_template>
61 Name of the output vector layer (in single mode, and the default
62 is "merged"), or template to name the output vector layers in
63 default mode (the default value is {AUTO_NAME}). The template
64 can be a string with the following variables that will be susb‐
65 stitued with a value computed from the input layer being pro‐
66 cessed:
67 • {AUTO_NAME}: equivalent to {DS_BASENAME}_{LAYER_NAME} if both
69 values are different, or {LAYER_NAME} when they are identical
70 (case of shapefile). 'different
71 • {DS_NAME}: name of the source dataset
73 • {DS_BASENAME}: base name of the source dataset
75 • {DS_INDEX}: index of the source dataset
77 • {LAYER_NAME}: name of the source layer
79 • {LAYER_INDEX}: index of the source layer
81 -update
83 Open an existing dataset in update mode.
84 -overwrite_ds
86 Overwrite the existing dataset if it already exists (for file
87 based datasets)
88 -append
90 Open an existing dataset in update mode, and if output layers
91 already exist, append the content of input layers to them.
92 -overwrite_layer
94 Open an existing dataset in update mode, and if output layers
95 already exist, replace their content with the one of the input
96 layer.
97 -src_geom_type <geom_type_name[,geom_type_name]\*]>
99 Only take into account input layers whose geometry type match
100 the type(s) specified. Valid values for geom_type_name are GEOM‐
101 ETRY, POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING,
102 MULTIPOINT, GEOMETRYCOLLECTION, CIRCULARSTRING, CURVEPOLYGON,
103 MULTICURVE, MULTISURFACE, CURVE, SURFACE, TRIANGLE, POLYHEDRAL‐
104 SURFACE and TIN.
105 -dsco <NAME=VALUE>
107 Dataset creation option (format specific)
108 -lco <NAME=VALUE>
110 Layer creation option (format specific)
111 -a_srs <srs_def>
113 Assign an output SRS
114 -t_srs <srs_def>
116 Reproject/transform to this SRS on output
117 -s_srs <srs_def>
119 Override source SRS
120 -progress
122 Display progress on terminal. Only works if input layers have
123 the "fast feature count" capability.
124 -skipfailures
126 Continue after a failure, skipping the failed feature.
127 -field_strategy FirstLayer|Union|Intersection
129 Only used with -single. Determines how the schema of the target
130 layer is built from the schemas of the input layers. May be
131 FirstLayer to use the fields from the first layer found, Union
132 to use a super-set of all the fields from all source layers, or
133 Intersection to use a sub-set of all the common fields from all
134 source layers. Defaults to Union.
135 -src_layer_field_name <name>
137 Only used with -single. If specified, the schema of the target
138 layer will be extended with a new field 'name', whose content is
139 determined by -src_layer_field_content.
140 -src_layer_field_content <layer_name_template>
142 Only used with -single. If specified, the schema of the target
143 layer will be extended with a new field (whose name is given by
144 -src_layer_field_name, or 'source_ds_lyr' otherwise), whose con‐
145 tent is determined by layer_name_template. The syntax of
146 layer_name_template is the same as for -nln.
147
149 Create a VRT with a layer for each input shapefiles
150 ogrmerge.py -f VRT -o merged.vrt *.shp
152 Same, but creates a GeoPackage file
154 ogrmerge.py -f GPKG -o merged.gpkg *.shp
156 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 ogrmerge.py -single -o merged.shp france.shp germany.shp -src_layer_field_name country
162
164 Even Rouault <even.rouault@spatialys.com>
165
167 1998-2021
168 Mar 24, 2021 OGRMERGE(1)