OGRMERGE(1) GDAL OGRMERGE(1)
NAME
ogrmerge - Merge several vector datasets into a single one.
SYNOPSIS
ogrmerge.py -o out_dsname src_dsname [src_dsname]*
[-f format] [-single] [-nln layer_name_template]
[-update | -overwrite_ds] [-append | -overwrite_layer]
[-src_geom_type geom_type_name[,geom_type_name]*]
[-dsco NAME=VALUE]* [-lco NAME=VALUE]*
[-s_srs srs_def] [-t_srs srs_def | -a_srs srs_def]
[-progress] [-skipfailures] [--help-general]
Options specific to the -single option:
[-field_strategy FirstLayer|Union|Intersection]
[-src_layer_field_name name]
[-src_layer_field_content layer_name_template]
DESCRIPTION
New in version 2.2.
ogrmerge.py script takes as input several vector datasets, each of them
having one or several vector layers, and copy them in a target dataset.
There are essential two modes:
• the default one, where each input vector layer, is copied as a sepa-
rate layer into the target dataset
• another one, activated with the -single switch, where the content of
all input vector layers is appended into a single target layer. This
assumes that the schema of those vector layers is more or less the
same.
Internally this generates a vector.vrt file, and if the output format
is not VRT, final translation is done with ogr2ogr or gdal.VectorTrans-
late(). So, for advanced uses, output to VRT, potential manual editing
of it and ogr2ogr can be done.
-o <out_dsname
Output dataset name. Required.
<src_dsname>
One or several input vector datasets. Required
-f <format>
Select the output format. Starting with GDAL 2.3, if not speci-
fied, the format is guessed from the extension (previously was
ESRI Shapefile). Use the short format name
-single
If specified, all input vector layers will be merged into a sin-
gle one.
-nln <layer_name_template>
Name of the output vector layer (in single mode, and the default
is "merged"), or template to name the output vector layers in
default mode (the default value is {AUTO_NAME}). The template
can be a string with the following variables that will be susb-
stitued with a value computed from the input layer being pro-
cessed:
• {AUTO_NAME}: equivalent to {DS_BASENAME}_{LAYER_NAME} if both
values are different, or {LAYER_NAME} when they are identical
(case of shapefile). 'different
• {DS_NAME}: name of the source dataset
• {DS_BASENAME}: base name of the source dataset
• {DS_INDEX}: index of the source dataset
• {LAYER_NAME}: name of the source layer
• {LAYER_INDEX}: index of the source layer
-update
Open an existing dataset in update mode.
-overwrite_ds
Overwrite the existing dataset if it already exists (for file
based datasets)
-append
Open an existing dataset in update mode, and if output layers
already exist, append the content of input layers to them.
-overwrite_layer
Open an existing dataset in update mode, and if output layers
already exist, replace their content with the one of the input
layer.
-src_geom_type <geom_type_name[,geom_type_name]\*]>
Only take into account input layers whose geometry type match
the type(s) specified. Valid values for geom_type_name are GEOM-
ETRY, POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING,
MULTIPOLYGON, GEOMETRYCOLLECTION, CIRCULARSTRING, CURVEPOLYGON,
MULTICURVE, MULTISURFACE, CURVE, SURFACE, TRIANGLE, POLYHEDRAL-
SURFACE and TIN.
-dsco <NAME=VALUE>
Dataset creation option (format specific)
-lco <NAME=VALUE>
Layer creation option (format specific)
-a_srs <srs_def>
Assign an output SRS
-t_srs <srs_def>
Reproject/transform to this SRS on output
-s_srs <srs_def>
Override source SRS
-progress
Display progress on terminal. Only works if input layers have
the "fast feature count" capability.
-skipfailures
Continue after a failure, skipping the failed feature.
-field_strategy FirstLayer|Union|Intersection
Only used with -single. Determines how the schema of the target
layer is built from the schemas of the input layers. May be
FirstLayer to use the fields from the first layer found, Union
to use a super-set of all the fields from all source layers, or
Intersection to use a sub-set of all the common fields from all
source layers. Defaults to Union.
-src_layer_field_name <name>
Only used with -single. If specified, the schema of the target
layer will be extended with a new field 'name', whose content is
determined by -src_layer_field_content.
-src_layer_field_content <layer_name_template>
Only used with -single. If specified, the schema of the target
layer will be extended with a new field (whose name is given by
-src_layer_field_name, or 'source_ds_lyr' otherwise), whose con-
tent is determined by layer_name_template. The syntax of
layer_name_template is the same as for -nln.
EXAMPLES
Create a VRT with a layer for each input shapefiles
ogrmerge.py -f VRT -o merged.vrt *.shp
Same, but creates a GeoPackage file
ogrmerge.py -f GPKG -o merged.gpkg *.shp
Concatenate the content of france.shp and germany.shp in merged.shp,
and adds a 'country' field to each feature whose value is 'france' or
'germany' depending where it comes from.
ogrmerge.py -single -o merged.shp france.shp germany.shp -src_layer_field_name country
AUTHOR
Even Rouault <even.rouault@spatialys.com>
COPYRIGHT
1998-2021
Dec 27, 2021 OGRMERGE(1)
Generated by dwww version 1.14 on Fri Jan 24 06:29:06 CET 2025.