MSVehicleType.h

Go to the documentation of this file.

/****************************************************************************/
// The car-following model and parameter
/****************************************************************************/
// SUMO, Simulation of Urban MObility; see http://sumo.sourceforge.net/
// Copyright (C) 2001-2012 DLR (http://www.dlr.de/) and contributors
/****************************************************************************/
//
//   This file is part of SUMO.
//   SUMO is free software: you can redistribute it and/or modify
//   it under the terms of the GNU General Public License as published by
//   the Free Software Foundation, either version 3 of the License, or
//   (at your option) any later version.
//
/****************************************************************************/
#ifndef MSVehicleType_h
#define MSVehicleType_h


// ===========================================================================
// included modules
// ===========================================================================
#ifdef _MSC_VER
#include <windows_config.h>
#else
#include <config.h>
#endif

#include <cassert>
#include <map>
#include <string>
#include "MSCFModel.h"
#include <utils/common/SUMOTime.h>
#include <utils/common/StdDefs.h>
#include <utils/common/SUMOVehicleClass.h>
#include <utils/common/RandHelper.h>
#include <utils/common/SUMOVTypeParameter.h>
#include <utils/common/RGBColor.h>


// ===========================================================================
// class declarations
// ===========================================================================
class MSLane;
class BinaryInputDevice;
class MSCFModel;
class SUMOVTypeParameter;


// ===========================================================================
// class definitions
// ===========================================================================
class MSVehicleType {
public:
    MSVehicleType(const std::string& id, SUMOReal lengthWithGap,
                  SUMOReal minGap, SUMOReal maxSpeed,
                  SUMOReal prob, SUMOReal speedFactor,
                  SUMOReal speedDev, SUMOVehicleClass vclass,
                  SUMOEmissionClass emissionClass,
                  SUMOReal guiWidth, SUMOVehicleShape shape,
                  const std::string& lcModel,
                  const RGBColor& c) ;


    virtual ~MSVehicleType() ;




    const std::string& getID() const {
        return myID;
    }


    SUMOReal getLength() const {
        return myLength;
    }


    SUMOReal getLengthWithGap() const {
        return myLength + myMinGap;
    }


    SUMOReal getMinGap() const {
        return myMinGap;
    }


    inline const MSCFModel& getCarFollowModel() const {
        return *myCarFollowModel;
    }


    inline MSCFModel& getCarFollowModel() {
        return *myCarFollowModel;
    }


    SUMOReal getMaxSpeed() const {
        return myMaxSpeed;
    }

    SUMOReal hasSpeedDeviation() const {
        return mySpeedDev != 0.0 || mySpeedFactor != 1.0;
    }


    SUMOReal getMaxSpeedWithDeviation(SUMOReal referenceSpeed) const {
        SUMOReal meanSpeed = mySpeedFactor * referenceSpeed;
        SUMOReal speedDev = mySpeedDev * meanSpeed;
        SUMOReal speed = MIN3(RandHelper::randNorm(meanSpeed, speedDev), meanSpeed + 2 * speedDev, myMaxSpeed);
        return MAX3((SUMOReal)0.0, speed, meanSpeed - 2 * speedDev);
    }


    SUMOReal getDefaultProbability() const {
        return myDefaultProbability;
    }


    SUMOVehicleClass getVehicleClass() const {
        return myVehicleClass;
    }


    SUMOEmissionClass getEmissionClass() const {
        return myEmissionClass;
    }


    const RGBColor& getColor() const {
        return myColor;
    }


    SUMOReal getSpeedFactor() const {
        return mySpeedFactor;
    }


    SUMOReal getSpeedDeviation() const {
        return mySpeedDev;
    }




    SUMOReal getGuiWidth() const {
        return myWidth;
    }

    SUMOVehicleShape getGuiShape() const {
        return myShape;
    }






    void saveState(std::ostream& os);




    void setLength(const SUMOReal& length) ;


    void setMinGap(const SUMOReal& minGap) ;


    void setMaxSpeed(const SUMOReal& maxSpeed) ;


    void setVClass(SUMOVehicleClass vclass) ;


    void setDefaultProbability(const SUMOReal& prob) ;


    void setSpeedFactor(const SUMOReal& factor) ;


    void setSpeedDeviation(const SUMOReal& dev) ;


    void setEmissionClass(SUMOEmissionClass eclass) ;


    void setColor(const RGBColor& color) ;


    void setWidth(const SUMOReal& width) ;


    void setShape(SUMOVehicleShape shape) ;




    static MSVehicleType* build(SUMOVTypeParameter& from) ;


    static MSVehicleType* build(const std::string& id, const MSVehicleType* from) ;


    static SUMOReal get(const SUMOVTypeParameter::CFParams& from, SumoXMLAttr attr, SUMOReal defaultValue);


    bool amVehicleSpecific() const {
        return myOriginalType != 0;
    }


private:
    std::string myID;

    SUMOReal myLength;

    SUMOReal myMinGap;

    SUMOReal myMaxSpeed;

    SUMOReal myDefaultProbability;

    SUMOReal mySpeedFactor;

    SUMOReal mySpeedDev;

    MSCFModel* myCarFollowModel;

    std::string myLaneChangeModel;

    SUMOEmissionClass myEmissionClass;

    RGBColor myColor;

    SUMOVehicleClass myVehicleClass;



    SUMOReal myWidth;

    SUMOVehicleShape myShape;


    const MSVehicleType* myOriginalType;


private:
    MSVehicleType(const MSVehicleType&);

    MSVehicleType& operator=(const MSVehicleType&);

};


#endif

/****************************************************************************/