MSCFModel_NaSch.h

Go to the documentation of this file.

/****************************************************************************/
// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
// Copyright (C) 2026-2026 German Aerospace Center (DLR) and others.
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License 2.0 which is available at
// https://www.eclipse.org/legal/epl-2.0/
// This Source Code may also be made available under the following Secondary
// Licenses when the conditions for such availability set forth in the Eclipse
// Public License 2.0 are satisfied: GNU General Public License, version 2
// or later which is available at
// https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
/****************************************************************************/
// The Nagel-Schreckenberg (1992) cellular automaton car-following model
/****************************************************************************/
#pragma once
#include <config.h>
 
#include "MSCFModel.h"
#include <utils/xml/SUMOXMLDefinitions.h>
 
 
// ===========================================================================
// class definitions
// ===========================================================================
class MSCFModel_NaSch : public MSCFModel {
public:
    MSCFModel_NaSch(const MSVehicleType* vtype, double dawdle);
 
 
    ~MSCFModel_NaSch();
 
 
 
    double followSpeed(const MSVehicle* const veh, double speed, double gap2pred,
                       double predSpeed, double predMaxDecel, const MSVehicle* const pred = 0, const CalcReason usage = CalcReason::CURRENT) const;
 
    double insertionFollowSpeed(const MSVehicle* const veh, double speed, double gap2pred, double predSpeed, double predMaxDecel, const MSVehicle* const pred = 0) const;
 
    double stopSpeed(const MSVehicle* const veh, const double speed, double gap2pred, double decel, const CalcReason usage = CalcReason::CURRENT) const;
 
 
    double patchSpeedBeforeLC(const MSVehicle* veh, double vMin, double vMax) const;
 
 
    double minNextSpeedEmergency(double speed, const MSVehicle* const veh = 0) const;
 
 
    int getModelID() const {
        return SUMO_TAG_CF_NASCH;
    }
 
 
    double getImperfection() const {
        return myDawdle;
    }
 
 
    void setImperfection(double imperfection) {
        myDawdle = imperfection;
    }
 
 
    MSCFModel* duplicate(const MSVehicleType* vtype) const;
 
protected:
    double roundToCell(double speed) const;
 
    double vsafe(const MSVehicle* const veh, double speed, double gap) const;
 
protected:
    double myDawdle;
 
    double myCellSpeed;
};