POLYCONVERT

=From 30.000 feet= POLYCONVERT imports geometrical shapes (polygons or points of interest) from different sources, converts them to a representation that may be visualized using SUMO-GUI.
 * Purpose: Polygon and POI import, conversion, and projection
 * System: portable (Linux/Windows is tested); runs on command line
 * Input (mandatory): polygons or pois
 * Output: SUMO-shape file
 * Programming Language: C++
 * Programming Language: C++

Features

 * Imports OSM, VISUM, Elmar, XML, ArcView shape files
 * per-type import settings
 * projections using a given proj.4-definition or via a matching network
 * Writes simulation shape files usable within SUMO-GUI and SUMO

=Usage Description= POLYCONVERT is able to import shapes from different file types. Normally, for importing data of a certain type, the type name is used as option name and the value indicates the position of the file. So polyconvert --visum mynet.net -o converted.poi.xml imports from a VISUM-net file.

Options
You may use a XML schema definition file for setting up a POLYCONVERT configuration: polyconvertConfiguration.xsd.

Configuration
All applications of the SUMO-suite handle configuration options the same way. These options are discussed at Basics/Using the Command Line Applications.

Input
POLYCONVERT is capable to apply different attributes to the imported shapes in dependence of their "type". Not all imported formats have a type information. When using shape files, for example, all instances of an artifact type are normally stored in a distinct shape file.

Output
All imported shapes that have not been discarded are written into a file which has to be defined using.

Projection
One of the major uses of POLYCONVERT is to apply a projection on the read shapes. Normally, one wants the shapes to be aligned in accordance to a previously imported road network. In this case, the network should be given using. But it is also possible to use a different projection. In any case, if the read coordinates shall be changed, must be given.

Pruning
Sometimes, shapes cover a much larger area than the network. In order to reduce the amount of data, one can force POLYCONVERT to prune the imported data on the network's or a given boundary. Read shapes which are completely outside this boundary are discarded in these cases.

Building Defaults
When importing shapes for which no type-dependent attributes have been given, the following default values are used which can be changed on the command line.

Report
All applications of the SUMO-suite handle most of the reporting options the same way. These options are discussed at Basics/Using the Command Line Applications.

=See Also=
 * Using additional polygons and POIs within the Simulation
 * Using configuration files

--