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.

Parameters

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()