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 2001-2010 DLR (http://www.dlr.de/) and contributors
/****************************************************************************/
//
//   This program 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 2 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/RGBColor.h>


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


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


    virtual ~MSVehicleType() throw();




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


    SUMOReal getLength() const throw() {
        return myLength;
    }


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


    SUMOReal getMaxSpeed() const throw() {
        return myMaxSpeed;
    }

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


    SUMOReal getMaxSpeedWithDeviation(SUMOReal referenceSpeed) const throw() {
        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 throw() {
        return myDefaultProbability;
    }


    SUMOVehicleClass getVehicleClass() const throw() {
        return myVehicleClass;
    }


    SUMOEmissionClass getEmissionClass() const throw() {
        return myEmissionClass;
    }


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




    SUMOVehicleShape getGuiShape() const throw() {
        return myShape;
    }


    SUMOReal getGuiWidth() const throw() {
        return myWidth;
    }


    SUMOReal getGuiOffset() const throw() {
        return myOffset;
    }





    void saveState(std::ostream &os);




    static MSVehicleType *build(SUMOVTypeParameter &from) throw(ProcessError);


    static SUMOReal get(const std::map<std::string, SUMOReal> &from, const std::string &name,
                        SUMOReal defaultValue) throw();


private:
    std::string myID;

    SUMOReal myLength;

    SUMOReal myMaxSpeed;

    SUMOVehicleClass myVehicleClass;

    SUMOReal myDefaultProbability;

    SUMOReal mySpeedFactor;

    SUMOReal mySpeedDev;

    MSCFModel* myCarFollowModel;

    std::string myLaneChangeModel;

    SUMOEmissionClass myEmissionClass;

    RGBColor myColor;



    SUMOReal myWidth;

    SUMOReal myOffset;

    SUMOVehicleShape myShape;


private:
    MSVehicleType(const MSVehicleType&);

    MSVehicleType& operator=(const MSVehicleType&);

};


#endif

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