LaneStructure.java
package org.opentrafficsim.road.gtu.lane.perception;
import java.util.Map;
import java.util.SortedSet;
import org.djunits.value.vdouble.scalar.Length;
import org.opentrafficsim.core.gtu.GTUException;
import org.opentrafficsim.core.gtu.GTUType;
import org.opentrafficsim.core.gtu.RelativePosition;
import org.opentrafficsim.core.network.route.Route;
import org.opentrafficsim.road.gtu.lane.LaneBasedGTU;
import org.opentrafficsim.road.network.lane.DirectedLanePosition;
import org.opentrafficsim.road.network.lane.object.LaneBasedObject;
/**
* Interface for lane structures.
* <p>
* Copyright (c) 2013-2018 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. <br>
* BSD-style license. See <a href="http://opentrafficsim.org/node/13">OpenTrafficSim License</a>.
* <p>
* @version $Revision$, $LastChangedDate$, by $Author$, initial version 13 aug. 2018 <br>
* @author <a href="http://www.tbm.tudelft.nl/averbraeck">Alexander Verbraeck</a>
* @author <a href="http://www.tudelft.nl/pknoppers">Peter Knoppers</a>
* @author <a href="http://www.transport.citg.tudelft.nl">Wouter Schakel</a>
*/
public interface LaneStructure
{
/**
* Updates the underlying structure shifting the root position to the input.
* @param pos DirectedLanePosition; current position of the GTU
* @param route Route; current route of the GTU
* @param gtuType GTUType; GTU type
* @throws GTUException on a problem while updating the structure
*/
void update(DirectedLanePosition pos, Route route, GTUType gtuType) throws GTUException;
/**
* Returns the root record.
* @return LaneRecord; root record
*/
LaneStructureRecord getRootRecord();
/**
* Returns the extended cross-section, which includes all lanes for which a first record is present.
* @return SortedSet; the cross-section
*/
SortedSet<RelativeLane> getExtendedCrossSection();
/**
* Returns the first record on the given lane. This is often a record in the current cross section, but it may be one
* downstream for a lane that starts further downstream.
* @param lane RelativeLane; lane
* @return first record on the given lane, or {@code null} if no such record
*/
LaneStructureRecord getFirstRecord(RelativeLane lane);
/**
* Retrieve objects of a specific type. Returns objects over a maximum length of the look ahead distance downstream from the
* relative position, or as far as the lane structure goes.
* @param clazz Class; class of objects to find
* @param gtu LaneBasedGTU; gtu
* @param pos RelativePosition.TYPE; relative position to start search from
* @param <T> type of objects to find
* @return Map; sorted set of objects of requested type per lane
* @throws GTUException if lane is not in current set
*/
<T extends LaneBasedObject> Map<RelativeLane, SortedSet<Entry<T>>> getDownstreamObjects(Class<T> clazz, LaneBasedGTU gtu,
RelativePosition.TYPE pos) throws GTUException;
/**
* Retrieve objects on a lane of a specific type. Returns objects over a maximum length of the look ahead distance
* downstream from the relative position, or as far as the lane structure goes.
* @param lane RelativeLane; lane
* @param clazz Class; class of objects to find
* @param gtu LaneBasedGTU; gtu
* @param pos RelativePosition.TYPE; relative position to start search from
* @param <T> type of objects to find
* @return SortedSet; sorted set of objects of requested type
* @throws GTUException if lane is not in current set
*/
<T extends LaneBasedObject> SortedSet<Entry<T>> getDownstreamObjects(RelativeLane lane, Class<T> clazz, LaneBasedGTU gtu,
RelativePosition.TYPE pos) throws GTUException;
/**
* Retrieve objects of a specific type. Returns objects over a maximum length of the look ahead distance downstream from the
* relative position, or as far as the lane structure goes. Objects on links not on the route are ignored.
* @param clazz Class; class of objects to find
* @param gtu LaneBasedGTU; gtu
* @param pos RelativePosition.TYPE; relative position to start search from
* @param <T> type of objects to find
* @param route Route; the route
* @return SortedSet; sorted set of objects of requested type per lane
* @throws GTUException if lane is not in current set
*/
<T extends LaneBasedObject> Map<RelativeLane, SortedSet<Entry<T>>> getDownstreamObjectsOnRoute(Class<T> clazz,
LaneBasedGTU gtu, RelativePosition.TYPE pos, Route route) throws GTUException;
/**
* Retrieve objects on a lane of a specific type. Returns objects over a maximum length of the look ahead distance
* downstream from the relative position, or as far as the lane structure goes. Objects on links not on the route are
* ignored.
* @param lane Lane; lane
* @param clazz Class; class of objects to find
* @param gtu LaneBasedGTU; gtu
* @param pos RelativePosition.TYPE; relative position to start search from
* @param <T> type of objects to find
* @param route Route; the route
* @return SortedSet; sorted set of objects of requested type
* @throws GTUException if lane is not in current set
*/
<T extends LaneBasedObject> SortedSet<Entry<T>> getDownstreamObjectsOnRoute(RelativeLane lane, Class<T> clazz,
LaneBasedGTU gtu, RelativePosition.TYPE pos, Route route) throws GTUException;
/**
* Retrieve objects on a lane of a specific type. Returns upstream objects from the relative position for as far as the lane
* structure goes. Distances to upstream objects are given as positive values.
* @param lane Lane; lane
* @param clazz Class; class of objects to find
* @param gtu LaneBasedGTU; gtu
* @param pos RelativePosition.TYPE; relative position to start search from
* @param <T> type of objects to find
* @return SortedSet; sorted set of objects of requested type
* @throws GTUException if lane is not in current set
*/
<T extends LaneBasedObject> SortedSet<Entry<T>> getUpstreamObjects(RelativeLane lane, Class<T> clazz, LaneBasedGTU gtu,
RelativePosition.TYPE pos) throws GTUException;
/**
* Wrapper to hold lane-based object and it's distance.
* <p>
* Copyright (c) 2013-2018 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
* <br>
* BSD-style license. See <a href="http://opentrafficsim.org/docs/current/license.html">OpenTrafficSim License</a>.
* <p>
* @version $Revision$, $LastChangedDate$, by $Author$, initial version Sep 15, 2016 <br>
* @author <a href="http://www.tbm.tudelft.nl/averbraeck">Alexander Verbraeck</a>
* @author <a href="http://www.tudelft.nl/pknoppers">Peter Knoppers</a>
* @author <a href="http://www.transport.citg.tudelft.nl">Wouter Schakel</a>
* @param <T> class of lane based object contained
*/
class Entry<T extends LaneBasedObject> implements Comparable<Entry<T>>
{
/** Distance to lane based object. */
private final Length distance;
/** Lane based object. */
private final T laneBasedObject;
/**
* @param distance distance to lane based object
* @param laneBasedObject lane based object
*/
public Entry(final Length distance, final T laneBasedObject)
{
this.distance = distance;
this.laneBasedObject = laneBasedObject;
}
/**
* @return distance.
*/
public final Length getDistance()
{
return this.distance;
}
/**
* @return laneBasedObject.
*/
public final T getLaneBasedObject()
{
return this.laneBasedObject;
}
/** {@inheritDoc} */
@Override
public final int hashCode()
{
final int prime = 31;
int result = 1;
result = prime * result + ((this.distance == null) ? 0 : this.distance.hashCode());
result = prime * result + ((this.laneBasedObject == null) ? 0 : this.laneBasedObject.hashCode());
return result;
}
/** {@inheritDoc} */
@Override
public final boolean equals(final Object obj)
{
if (this == obj)
{
return true;
}
if (obj == null)
{
return false;
}
if (getClass() != obj.getClass())
{
return false;
}
Entry<?> other = (Entry<?>) obj;
if (this.distance == null)
{
if (other.distance != null)
{
return false;
}
}
else if (!this.distance.equals(other.distance))
{
return false;
}
if (this.laneBasedObject == null)
{
if (other.laneBasedObject != null)
{
return false;
}
}
// laneBasedObject does not implement equals...
else if (!this.laneBasedObject.equals(other.laneBasedObject))
{
return false;
}
return true;
}
/** {@inheritDoc} */
@Override
public final int compareTo(final Entry<T> arg)
{
int d = this.distance.compareTo(arg.distance);
if (d != 0 || this.laneBasedObject.equals(arg.laneBasedObject))
{
return d; // different distance (-1 or 1), or same distance but also equal lane based object (0)
}
return 1; // same distance, unequal lane based object (1)
}
/** {@inheritDoc} */
@Override
public final String toString()
{
return "LaneStructure.Entry [distance=" + this.distance + ", laneBasedObject=" + this.laneBasedObject + "]";
}
}
}