4.2.3 VectorData Extract ROI

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

Detailed 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

This section describes in details the parameters available for this application. Table 4.32, page 461 presents a summary of these parameters and the parameters keys to be used in command-line and programming languages. Application key is VectorDataExtractROI.





Parameter key

Parameter type

Parameter description




io

Group

Input and output data

io.vd

Input vector data

Input Vector data

io.in

Input image

Support image

io.out

Output vector data

Output Vector data

elev

Group

Elevation management

elev.dem

Directory

DEM directory

elev.geoid

Input File name

Geoid File

elev.default

Float

Default elevation

inxml

XML input parameters file

Load otb application from xml file

outxml

XML output parameters file

Save otb application to xml file











Table 4.32: Parameters table for VectorData Extract ROI.

Input and output data Group containing input and output parameters

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.

Load otb application from xml file Load otb application from xml file

Save otb application to xml file Save otb application to xml file

Example

To run this example in command-line, use the following:

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

To run this example from Python, use the following code snippet:

#!/usr/bin/python 
 
# Import the otb applications package 
import otbApplication 
 
# The following line creates an instance of the VectorDataExtractROI application 
VectorDataExtractROI = otbApplication.Registry.CreateApplication("VectorDataExtractROI") 
 
# The following lines set all the application parameters: 
VectorDataExtractROI.SetParameterString("io.in", "qb_RoadExtract.tif") 
 
VectorDataExtractROI.SetParameterString("io.vd", "qb_RoadExtract_classification.shp") 
 
VectorDataExtractROI.SetParameterString("io.out", "apTvUtVectorDataExtractROIApplicationTest.shp") 
 
# The following line execute the application 
VectorDataExtractROI.ExecuteAndWriteOutput()

Limitations

None

Authors

This application has been written by OTB-Team.