Package org.opentrafficsim.base.geometry

Class OtsGeometryUtil

java.lang.Object

org.opentrafficsim.base.geometry.OtsGeometryUtil

public final class OtsGeometryUtil
extends Object

Utility class for OTS geometry.

Copyright (c) 2013-2024 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Method Summary

Modifier and Type	Method	Description
static int	getNumSegmentsForRadius(double maxSpatialError, Angle angle, double r)	Returns the number of segments to use for a given maximum spatial error, and radius.
static PolyLine2d	offsetLine(PolyLine2d line, double[] relativeFractions, double[] offsets)	Create a line at linearly varying offset from this line.
static DirectedPoint2d	offsetPoint(DirectedPoint2d point, double offset)	Returns a point on a line through the given point, perpendicular to the given direction, at the offset distance.
static String	printCoordinate(String prefix, Point2d point)	Print one Point2d on the console.

Methods inherited from class java.lang.Object

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

Method Details

printCoordinate

public static String printCoordinate(String prefix,
 Point2d point)

Print one Point2d on the console.

Parameters:

prefix - text to put before the output

point - the coordinate to print

Returns:

String

getNumSegmentsForRadius

public static int getNumSegmentsForRadius(double maxSpatialError,
 Angle angle,
 double r)

Returns the number of segments to use for a given maximum spatial error, and radius.

Parameters:

maxSpatialError - maximum spatial error.

angle - angle of arc at radius.

r - critical radius (largest radius).

Returns:

number of segments to use for a given maximum spatial error, and radius.

offsetPoint

public static DirectedPoint2d offsetPoint(DirectedPoint2d point,
 double offset)

Returns a point on a line through the given point, perpendicular to the given direction, at the offset distance. A negative offset is towards the right hand side relative to the direction.

Parameters:

point - point.

offset - offset, negative values are to the right.

Returns:

offset point.

offsetLine

public static PolyLine2d offsetLine(PolyLine2d line,
 double[] relativeFractions,
 double[] offsets)
                             throws OtsGeometryException

Create a line at linearly varying offset from this line. The offset may change linearly from its initial value at the start of the reference line via a number of intermediate offsets at intermediate positions to its final offset value at the end of the reference line.

Parameters:

line - reference line.

relativeFractions - positional fractions for which the offsets have to be generated

offsets - offsets at the relative positions (positive value is Left, negative value is Right)

Returns:

the PolyLine2d of the line at multi-linearly changing offset of the reference line

Throws:

OtsGeometryException - when this method fails to create the offset line