VectorDataTransform

Apply a transform to each vertex of the input VectorData

Description

This application iterates over each vertex in the input vector data file and performs a transformation on this vertex.

It is the equivalent of [1] that transforms images. For instance, if you extract the envelope of an image with [2], and you transform this image with [1], you may want to use this application to operate the same transform on the envelope.

The applied transformation is a 2D similarity. It manages translation, rotation, scaling, and can be centered or not. Note that the support image is used to define the reference coordinate system in which the transform is applied. For instance the input vector data can have WGS84 coordinates, the support image is in UTM, so a translation of 1 pixel along X corresponds to the X pixel size of the input image along the X axis of the UTM coordinates frame. This image can also be in sensor geometry.

Parameters

Input Vector data -vd vectorfile Mandatory
Input vector data file to transform

Output Vector data -out vectorfile Mandatory
Output vector data with

Support image -in image Mandatory
Image defining the reference coordinate system in which the transform is applied. Both projected and sensor images are supported.

Transform parameters

Group of parameters to define the transform

X Translation -transform.tx float Default value: 0
Translation in the X direction (in pixels)

Y Translation -transform.ty float Default value: 0
Translation in the Y direction (in pixels)

Rotation Angle -transform.ro float Default value: 0
Angle of the rotation (in degrees)

Center X -transform.centerx float Default value: 0
X coordinate of the rotation and scaling center (in physical units)

Center Y -transform.centery float Default value: 0
Y coordinate of the rotation and scaling center (in physical units)

Scale -transform.scale float Default value: 1
The scale coefficient to apply

Examples

From the command-line:

otbcli_VectorDataTransform -vd qb_RoadExtract_easyClassification.shp -in qb_RoadExtract.tif -out VectorDataTransform.shp -transform.ro 5

From Python:

import otbApplication

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

app.SetParameterString("vd", "qb_RoadExtract_easyClassification.shp")
app.SetParameterString("in", "qb_RoadExtract.tif")
app.SetParameterString("out", "VectorDataTransform.shp")
app.SetParameterFloat("transform.ro", 5)

app.ExecuteAndWriteOutput()

See also