VectorDataReprojection - Vector Data reprojection

Reproject a vector data using support image projection reference, or a user specified map projection

Detailed description

This application allows reprojecting a vector data using support image projection reference, or a user given map projection. If given, image keywordlist can be added to reprojected vectordata.

Parameters

This section describes in details the parameters available for this application. Table [1] presents a summary of these parameters and the parameters keys to be used in command-line and programming languages. Application key is VectorDataReprojection .

[1]Table: Parameters table for Vector Data reprojection.
Parameter Key Parameter Name Parameter Type
in Input data Group
in.vd Input vector data Input File name
in.kwl Use image keywords list Input image
out Output data Group
out.vd Output vector data Output File name
out.proj Output Projection choice Choices
out.proj image Choice Use image projection ref
out.proj user Choice User defined projection
out.proj.image.in Image used to get projection map Input image
out.proj.user.map Output Cartographic Map Projection Choices
out.proj.user.map utm Choice Universal Trans-Mercator (UTM)
out.proj.user.map lambert2 Choice Lambert II Etendu
out.proj.user.map lambert93 Choice Lambert93
out.proj.user.map wgs Choice WGS 84
out.proj.user.map epsg Choice EPSG Code
out.proj.user.map.utm.zone Zone number Int
out.proj.user.map.utm.northhem Northern Hemisphere Boolean
out.proj.user.map.epsg.code EPSG Code Int
elev Elevation management Group
elev.dem DEM directory Directory
elev.geoid Geoid File Input File name
elev.default Default elevation Float
inxml Load otb application from xml file XML input parameters file
outxml Save otb application to xml file XML output parameters file

[Input data]

  • Input vector data: The input vector data to reproject.
  • Use image keywords list: Optional input image to fill vector data with image kwl.

[Output data]

  • Output vector data: The reprojected vector data.
  • Output Projection choice Available choices are:
  • Use image projection ref: Vector data will be reprojected in image projection ref.
  • Image used to get projection map: Projection map will be found using image metadata.
  • User defined projection
  • Output Cartographic Map Projection: Parameters of the output map projection to be used. Available choices are:
  • Universal Trans-Mercator (UTM): A system of transverse mercator projections dividing the surface of Earth between 80S and 84N latitude.
  • Zone number: The zone number ranges from 1 to 60 and allows defining the transverse mercator projection (along with the hemisphere).
  • Northern Hemisphere: The transverse mercator projections are defined by their zone number as well as the hemisphere. Activate this parameter if your image is in the northern hemisphere.
  • Lambert II Etendu: This is a Lambert Conformal Conic projection mainly used in France.
  • Lambert93: This is a Lambert 93 projection mainly used in France.
  • WGS 84: This is a Geographical projection.
  • EPSG Code: This code is a generic way of identifying map projections, and allows specifying a large amount of them. See www.spatialreference.org to find which EPSG code is associated to your projection;.
  • EPSG Code: See www.spatialreference.org to find which EPSG code is associated to your projection.

[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: 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: 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 (http://hg.orfeo-toolbox.org/OTB-Data/raw-file/404aa6e4b3e0/Input/DEM/egm96.grd).
  • Default elevation: 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.

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_VectorDataReprojection -in.vd VectorData_QB1.shp -out.proj image -out.proj.image.in ROI_QB_MUL_1.tif -out.vd reprojected_vd.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 VectorDataReprojection application
VectorDataReprojection = otbApplication.Registry.CreateApplication("VectorDataReprojection")

# The following lines set all the application parameters:
VectorDataReprojection.SetParameterString("in.vd", "VectorData_QB1.shp")

VectorDataReprojection.SetParameterString("out.proj","image")

VectorDataReprojection.SetParameterString("out.proj.image.in", "ROI_QB_MUL_1.tif")

VectorDataReprojection.SetParameterString("out.vd", "reprojected_vd.shp")

# The following line execute the application
VectorDataReprojection.ExecuteAndWriteOutput()

Authors

This application has been written by OTB-Team.