NAME

       ogrmerge -  Merge several vector datasets into a single one.

SYNOPSIS

          ogrmerge.py [--help] [--help-general]
                      -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 essentially two modes:

       • the default one, where each input vector layer, is copied as a separate 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 VRT -- Virtual Format file, and if  the  output  format  is  not  VRT,  final
       translation  is  done  with  ogr2ogr  or  gdal.VectorTranslate().  So,  for advanced uses, output to VRT,
       potential manual editing of it and ogr2ogr can be done.

       --help Show this help message and exit

       --help-general
              Gives a brief usage message for the generic GDAL commandline options and exit.

       -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 specified, 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 single 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 susbstitued with a value computed from the  input
              layer being processed:

              • {AUTO_NAME}:   equivalent  to  {DS_BASENAME}_{LAYER_NAME}  if  both  values  are  different,  or
                {LAYER_NAME} when they are identical (case of shapefile).

              • {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  GEOMETRY,  POINT,  LINESTRING,  POLYGON,  MULTIPOINT,  MULTILINESTRING,
              MULTIPOLYGON, GEOMETRYCOLLECTION, CIRCULARSTRING, CURVEPOLYGON, MULTICURVE,  MULTISURFACE,  CURVE,
              SURFACE, TRIANGLE, POLYHEDRALSURFACE 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 content
              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-2024

                                                  Jun 23, 2024                                       OGRMERGE(1)