VectorDataExtractROI¶

Perform an extract ROI on the input vector data according to the input image extent

Description¶

This application extracts the vector data features belonging to a region specified by the support image envelope. Any features intersecting the support region is copied to output. The output geometries are NOT cropped.

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.

Input and output data ¶

Group containing input and output parameters

Input Vector data -io.vd vectorfile Mandatory
Input vector data

Support image -io.in image Mandatory
Support image that specifies the extracted region

Output Vector data -io.out vectorfile Mandatory
Output extracted vector data

Elevation management ¶

This group of parameters allows managing elevation values. Supported formats are SRTM, DTED or any geotiff. DownloadSRTMTiles application could be a useful tool to list/download tiles related to a product.

DEM directory -elev.dem directory
This parameter allows selecting a directory containing Digital Elevation Model files. Note that this directory should contain only DEM files. Unexpected behaviour might occurs if other images are found in this directory.

Geoid File -elev.geoid filename [dtype]
Use a geoid grid to get the height above the ellipsoid in case there is no DEM available, no coverage for some points or pixels with no_data in the DEM tiles. A version of the geoid can be found on the OTB website(https://gitlab.orfeo-toolbox.org/orfeotoolbox/otb-data/blob/master/Input/DEM/egm96.grd).

Default elevation -elev.default float Default value: 0
This parameter allows setting the default height above ellipsoid when there is no DEM available, no coverage for some points or pixels with no_data in the DEM tiles, and no geoid file has been set. This is also used by some application as an average elevation value.

Examples¶

From the command-line:

otbcli_VectorDataExtractROI -io.in qb_RoadExtract.tif -io.vd qb_RoadExtract_classification.shp -io.out apTvUtVectorDataExtractROIApplicationTest.shp

From Python:

import otbApplication

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

app.SetParameterString("io.in", "qb_RoadExtract.tif")
app.SetParameterString("io.vd", "qb_RoadExtract_classification.shp")
app.SetParameterString("io.out", "apTvUtVectorDataExtractROIApplicationTest.shp")

app.ExecuteAndWriteOutput()