HeadwayDistance.java

package org.opentrafficsim.road.gtu.lane.perception.headway;

import org.djunits.unit.LengthUnit;
import org.djunits.value.vdouble.scalar.Acceleration;
import org.djunits.value.vdouble.scalar.Length;
import org.djunits.value.vdouble.scalar.Speed;

/**
 * Container for a reference to information about a headway with just a distance, without any further information about the
 * object; it assumes a speed of 0 at the headway, so it also good to store information about a lane drop. The reason for
 * storing a speed of zero at the end of a maximum headway is that we did not check the conditions beyond that point. A GTU or
 * lane drop could be right behind the last point we checked.
 * <p>
 * Copyright (c) 2013-2016 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/license.html">OpenTrafficSim License</a>.
 * <p>
 * @version $Revision: 1368 $, $LastChangedDate: 2015-09-02 00:20:20 +0200 (Wed, 02 Sep 2015) $, by $Author: averbraeck $,
 *          initial version 11 feb. 2015 <br>
 * @author <a href="http://www.tbm.tudelft.nl/averbraeck">Alexander Verbraeck</a>
 * @author <a href="http://www.tudelft.nl/pknoppers">Peter Knoppers</a>
 */
public class HeadwayDistance implements Headway
{
    /** */
    private static final long serialVersionUID = 20160410L;

    /** the distance of the headway. */
    private final Length distance;

    /**
     * Construct a new Headway information object with just a distance, without any further information about the object; it
     * assumes a speed of 0 at the headway, so it also good to store information about a lane drop.
     * @param distance the distance that needs to be stored.
     */
    public HeadwayDistance(final double distance)
    {
        this(new Length(distance, LengthUnit.SI));
    }

    /**
     * Construct a new Headway information object with just a distance, without any further information about the object; it
     * assumes a speed of 0 at the headway, so it also good to store information about a lane drop.
     * @param distance the distance that needs to be stored.
     */
    public HeadwayDistance(final Length distance)
    {
        this.distance = distance;
    }

    /** {@inheritDoc} */
    @Override
    public final String getId()
    {
        return "DISTANCE";
    }

    /** {@inheritDoc} */
    @Override
    public final Length getLength()
    {
        return null;
    }
    
    /** {@inheritDoc} */
    @Override
    public final Speed getSpeed()
    {
        return Speed.ZERO;
    }

    /** {@inheritDoc} */
    @Override
    public final Length getDistance()
    {
        return this.distance;
    }

    /** {@inheritDoc} */
    @Override
    public final ObjectType getObjectType()
    {
        return ObjectType.DISTANCEONLY;
    }

    /** {@inheritDoc} */
    @Override
    public final Acceleration getAcceleration()
    {
        return Acceleration.ZERO;
    }

    /** {@inheritDoc} */
    @Override
    public final Length getOverlapFront()
    {
        return null;
    }

    /** {@inheritDoc} */
    @Override
    public final Length getOverlapRear()
    {
        return null;
    }

    /** {@inheritDoc} */
    @Override
    public final Length getOverlap()
    {
        return null;
    }

    /** {@inheritDoc} */
    @Override
    public final boolean isAhead()
    {
        return this.distance.ge(Length.ZERO);
    }

    /** {@inheritDoc} */
    @Override
    public final boolean isBehind()
    {
        return this.distance.lt(Length.ZERO);
    }

    /** {@inheritDoc} */
    @Override
    public final boolean isParallel()
    {
        return false;
    }

    /** {@inheritDoc} */
    @Override
    public final String toString()
    {
        return "HeadwayDistance [distance=" + this.distance + "]";
    }

}