ConcatenateVectorData

Concatenate vector data files

Description

This application concatenates a list of vector data files to produce a unique vector data output file.

This application will gather all the geometries from the input files and write them into an output vector data file. Any format supported by OGR can be used. Ideally, all inputs should have the same set of fields and the same spatial reference system.

This application has several output images and supports “multi-writing”. Instead of computing and writing each image independently, the streamed image blocks are written in a synchronous way for each output. The output images will be computed strip by strip, using the available RAM to compute the strip size, and a user defined streaming mode can be specified using the streaming extended filenames (type, mode and value). Note that multi-writing can be disabled using the multi-write extended filename option: &multiwrite=false, in this case the output images will be written one by one. Note that multi-writing is not supported for MPI writers.

Parameters

Input vector files -vd vectorfile1 vectorfile2... Mandatory
Vector data files to be concatenated.

Concatenated output -out vectorfile Mandatory
Output conctenated vector data file.

Examples

From the command-line:

otbcli_ConcatenateVectorData -vd toulousepoints_examples.shp ToulouseRoad-examples.shp -out ConcatenatedVectorData.shp

From Python:

import otbApplication

app = otbApplication.Registry.CreateApplication("ConcatenateVectorData")

app.SetParameterStringList("vd", ['toulousepoints_examples.shp', 'ToulouseRoad-examples.shp'])
app.SetParameterString("out", "ConcatenatedVectorData.shp")

app.ExecuteAndWriteOutput()

Limitations

The vector data must be contain the same type of geometries (point / lines / polygons). The fields present in the output file are the ones from the first input.