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 | Use image projection ref | Choice |
| out.proj user | User defined projection | Choice |
| 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 | Universal Trans-Mercator (UTM) | Choice |
| out.proj.user.map lambert2 | Lambert II Etendu | Choice |
| out.proj.user.map lambert93 | Lambert93 | Choice |
| out.proj.user.map wgs | WGS 84 | Choice |
| out.proj.user.map epsg | EPSG Code | Choice |
| 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.