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 [#]_ presents a summary of these parameters and the parameters keys to be used in command-line and programming languages. Application key is *VectorDataReprojection* . .. [#] 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.