AdaptationSpeedChannel.java

package org.opentrafficsim.road.gtu.perception.mental.channel;

import org.opentrafficsim.base.parameters.ParameterException;
import org.opentrafficsim.base.parameters.ParameterTypeDouble;
import org.opentrafficsim.base.parameters.ParameterTypes;
import org.opentrafficsim.base.parameters.Parameters;
import org.opentrafficsim.road.gtu.perception.mental.AdaptationSpeed;
import org.opentrafficsim.road.gtu.perception.mental.FactorAdaptation;

/**
 * Reduces the desired speed as behavioral adaptation. The equation is v0 = v0_base * min(1, 1/(1+Beta_v0*(TS-1))).
 * <p>
 * Copyright (c) 2024-2026 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. <br>
 * BSD-style license. See <a href="https://opentrafficsim.org/docs/license.html">OpenTrafficSim License</a>.
 * </p>
 * @author Wouter Schakel
 */
public class AdaptationSpeedChannel extends FactorAdaptation
{

    /** Parameter for desired speed scaling. */
    public static final ParameterTypeDouble BETA_V0 = AdaptationSpeed.BETA_V0;

    /** Base value for the desired speed. */
    private Double fSpeed0;

    /** Base value for the desired speed relative to GTU type speed limit. */
    private Double fSpeedGtu0;

    /**
     * Constructor.
     */
    public AdaptationSpeedChannel()
    {
        //
    }

    /** {@inheritDoc} */
    @Override
    public void adapt(final Parameters parameters) throws ParameterException
    {
        if (this.fSpeed0 == null)
        {
            this.fSpeed0 = parameters.getParameter(ParameterTypes.FSPEED);
            this.fSpeedGtu0 = parameters.getParameter(ParameterTypes.FSPEED_GTU);
        }
        double factor = getFactor(parameters, BETA_V0);
        parameters.setClaimedParameter(ParameterTypes.FSPEED, this.fSpeed0 / factor, this);
        parameters.setClaimedParameter(ParameterTypes.FSPEED_GTU, this.fSpeedGtu0 / factor, this);
    }

}