maps.convert.osm2gml

Class ConvertTools

java.lang.Object

maps.convert.osm2gml.ConvertTools

public final class ConvertTools
extends java.lang.Object

Useful tools for converting OSM to GML.

Method Summary

Modifier and Type	Method and Description
static java.util.List<ShapeDebugFrame.ShapeInfo>	createGMLObjectDebug(java.util.Collection<? extends GMLObject> objects) Create ShapeInfo objects for a set of GMLObjects.
static java.util.List<ShapeDebugFrame.ShapeInfo>	createGMLObjectDebug(GMLObject... objects) Create ShapeInfo objects for a set of GMLObjects.
static java.util.List<ShapeDebugFrame.ShapeInfo>	createGMLShapeDebug(java.util.Collection<? extends GMLShape> objects) Create ShapeInfo objects for a set of GMLShapes.
static java.util.List<ShapeDebugFrame.ShapeInfo>	createGMLShapeDebug(GMLShape... objects) Create ShapeInfo objects for a set of GMLShapes.
static java.util.List<ShapeDebugFrame.ShapeInfo>	createTemporaryObjectDebug(java.util.Collection<? extends TemporaryObject> objects) Create ShapeInfo objects for a set of TemporaryObjects.
static java.util.List<ShapeDebugFrame.ShapeInfo>	createTemporaryObjectDebug(TemporaryObject... objects) Create ShapeInfo objects for a set of TemporaryObjects.
static Edge	findBestTurn(DirectedEdge from, java.util.Set<? extends Edge> candidates, boolean preferLeft) Find the "best" turn in a particular direction.
static Edge	findLeftTurn(DirectedEdge from, java.util.Set<? extends Edge> candidates) Find the "leftmost" turn in a particular direction, i.e.
static Edge	findRightTurn(DirectedEdge from, java.util.Set<? extends Edge> candidates) Find the "rightmost" turn in a particular direction, i.e.
static java.util.List<ShapeDebugFrame.ShapeInfo>	getAllDebugShapes(GMLMap map) Create ShapeInfo objects for all GMLShapes in a map.
static java.util.List<ShapeDebugFrame.ShapeInfo>	getAllDebugShapes(TemporaryMap map) Create ShapeInfo objects for all TemporaryObjects in a map.
static double	getAnglesSum(OSMBuilding building, OSMMap map) Sum the angles of all turns in an OSMBuilding.
static Line2D	gmlDirectedEdgeToLine(GMLDirectedEdge edge) Convert a GMLDirectedEdge to a Line2D.
static Line2D	gmlEdgeToLine(GMLEdge edge) Convert a GMLEdge to a Line2D.
static Line2D	gmlEdgeToLine(GMLEdge edge, GMLNode start) Convert a GMLEdge to a Line2D.
static boolean	isClockwise(OSMBuilding building, OSMMap map) Find out if an OSMBuilding is defined clockwise or not.
static boolean	isConvex(java.util.List<DirectedEdge> edges) Find out if a set of GMLDirectedEdges is convex.
static double	nearbyThreshold(OSMMap map, double thresholdM) Compute the nearby-node threshold for an OSMMap in degrees.
static boolean	nearlyEqual(double n, double expected, double threshold) Is a number approximately equal to another number?
static double	sizeOf1Metre(OSMMap map) Compute the size of one metre in latitude/longitude for an OSMMap.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

sizeOf1Metre

public static double sizeOf1Metre(OSMMap map)

Compute the size of one metre in latitude/longitude for an OSMMap.

Parameters:

map - The map to look up.

Returns:

The size of one metre on the given map.

nearbyThreshold

public static double nearbyThreshold(OSMMap map,
                                     double thresholdM)

Compute the nearby-node threshold for an OSMMap in degrees.

Parameters:

map - The map to look up.

thresholdM - The desired threshold in meters.

Returns:

The size of the nearby-node threshold for the map in degrees.

gmlEdgeToLine

public static Line2D gmlEdgeToLine(GMLEdge edge)

Convert a GMLEdge to a Line2D.

Parameters:

edge - The edge to convert.

Returns:

A new Line2D.

gmlEdgeToLine

public static Line2D gmlEdgeToLine(GMLEdge edge,
                                   GMLNode start)

Convert a GMLEdge to a Line2D.

Parameters:

edge - The edge to convert.

start - The node to start from. This must be one of the endpoints of the edge.

Returns:

A new Line2D.

gmlDirectedEdgeToLine

public static Line2D gmlDirectedEdgeToLine(GMLDirectedEdge edge)

Convert a GMLDirectedEdge to a Line2D.

Parameters:

edge - The edge to convert.

Returns:

A new Line2D.

findLeftTurn

public static Edge findLeftTurn(DirectedEdge from,
                                java.util.Set<? extends Edge> candidates)

Find the "leftmost" turn in a particular direction, i.e. the one with the highest left angle, or the lowest right angle if there are no left turns possible.

Parameters:

from - The edge we're turning from.

candidates - The set of edges we could turn into.

Returns:

The leftmost turn.

findRightTurn

public static Edge findRightTurn(DirectedEdge from,
                                 java.util.Set<? extends Edge> candidates)

Find the "rightmost" turn in a particular direction, i.e. the one with the highest right angle, or the lowest left angle if there are no right turns possible.

Parameters:

from - The edge we're turning from.

candidates - The set of edges we could turn into.

Returns:

The rightmost turn.

findBestTurn

public static Edge findBestTurn(DirectedEdge from,
                                java.util.Set<? extends Edge> candidates,
                                boolean preferLeft)

Find the "best" turn in a particular direction. If left turns are preferred then the "best" turn is the one with the highest left angle, or the lowest right angle. For right turns, the "best" is the one with the highest right angle or the lowest left angle.

Parameters:

from - The edge we're turning from.

candidates - The set of edges we could turn into.

preferLeft - Whether to prefer left turns or not.

Returns:

The best turn.

getAllDebugShapes

public static java.util.List<ShapeDebugFrame.ShapeInfo> getAllDebugShapes(GMLMap map)

Create ShapeInfo objects for all GMLShapes in a map.

Parameters:

map - The map to debug.

Returns:

A list of ShapeInfo objects.

getAllDebugShapes

public static java.util.List<ShapeDebugFrame.ShapeInfo> getAllDebugShapes(TemporaryMap map)

Create ShapeInfo objects for all TemporaryObjects in a map.

Parameters:

map - The map to debug.

Returns:

A list of ShapeInfo objects.

createGMLShapeDebug

public static java.util.List<ShapeDebugFrame.ShapeInfo> createGMLShapeDebug(GMLShape... objects)

Create ShapeInfo objects for a set of GMLShapes.

Parameters:

objects - The objects to debug.

Returns:

A list of ShapeInfo objects.

createGMLShapeDebug

public static java.util.List<ShapeDebugFrame.ShapeInfo> createGMLShapeDebug(java.util.Collection<? extends GMLShape> objects)

Create ShapeInfo objects for a set of GMLShapes.

Parameters:

objects - The objects to debug.

Returns:

A list of ShapeInfo objects.

createGMLObjectDebug

public static java.util.List<ShapeDebugFrame.ShapeInfo> createGMLObjectDebug(GMLObject... objects)

Create ShapeInfo objects for a set of GMLObjects.

Parameters:

objects - The objects to debug.

Returns:

A list of ShapeInfo objects.

createGMLObjectDebug

public static java.util.List<ShapeDebugFrame.ShapeInfo> createGMLObjectDebug(java.util.Collection<? extends GMLObject> objects)

Create ShapeInfo objects for a set of GMLObjects.

Parameters:

objects - The objects to debug.

Returns:

A list of ShapeInfo objects.

createTemporaryObjectDebug

public static java.util.List<ShapeDebugFrame.ShapeInfo> createTemporaryObjectDebug(TemporaryObject... objects)

Create ShapeInfo objects for a set of TemporaryObjects.

Parameters:

objects - The objects to debug.

Returns:

A list of ShapeInfo objects.

createTemporaryObjectDebug

public static java.util.List<ShapeDebugFrame.ShapeInfo> createTemporaryObjectDebug(java.util.Collection<? extends TemporaryObject> objects)

Create ShapeInfo objects for a set of TemporaryObjects.

Parameters:

objects - The objects to debug.

Returns:

A list of ShapeInfo objects.

nearlyEqual

public static boolean nearlyEqual(double n,
                                  double expected,
                                  double threshold)

Is a number approximately equal to another number?

Parameters:

n - The number to test.

expected - The expected value.

threshold - The threshold.

Returns:

If n is within [expected - threshold, expected + threshold].

isConvex

public static boolean isConvex(java.util.List<DirectedEdge> edges)

Find out if a set of GMLDirectedEdges is convex.

Parameters:

edges - The set of edges to test.

Returns:

True iff the face is convex.

getAnglesSum

public static double getAnglesSum(OSMBuilding building,
                                  OSMMap map)

Sum the angles of all turns in an OSMBuilding.

Parameters:

building - The building to check.

map - The OSMMap the building is part of.

Returns:

The sum of angles in the building.

isClockwise

public static boolean isClockwise(OSMBuilding building,
                                  OSMMap map)

Find out if an OSMBuilding is defined clockwise or not.

Parameters:

building - The OSMBuilding to check.

map - The OSM map.

Returns:

True if the building is defined clockwise, false if anti-clockwise.