RealisticEngineModel.h

Go to the documentation of this file.

/****************************************************************************/
// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
// Copyright (C) 2001-2024 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
/****************************************************************************/
// A detailed engine model
/****************************************************************************/
 
#pragma once
#include <config.h>
 
#include "GenericEngineModel.h"
 
#include <stdint.h>
 
#include "VehicleEngineHandler.h"
#include "EngineParameters.h"
 
 
class RealisticEngineModel : public GenericEngineModel {
 
protected:
 
    EngineParameters ep;
    //current gear
    int currentGear;
    //minimum speed to be considered for horsepower computation
    double minSpeed_mps;
    //simulation sampling time
    double dt_s;
    //xml file with engine parameters
    std::string xmlFile;
    //id of the vehicle parameters to load
    std::string vehicleType;
 
    double rpmToSpeed_mps(double rpm, double wheelDiameter_m,
                          double differentialRatio, double gearRatio);
    double rpmToSpeed_mps(double rpm);
 
    double speed_mpsToRpm(double speed_mps, double wheelDiameter_m,
                          double differentialRatio, double gearRatio);
 
    double speed_mpsToRpm(double speed_mps);
 
    double speed_mpsToRpm(double speed_mps, double gearRatio);
 
    double rpmToPower_hp(double rpm, const struct EngineParameters::PolynomialEngineModelRpmToHp* engineMapping);
 
    double rpmToPower_hp(double rpm);
 
    double speed_mpsToPower_hp(double speed_mps,
                               const struct EngineParameters::PolynomialEngineModelRpmToHp* engineMapping,
                               double wheelDiameter_m, double differentialRatio,
                               double gearRatio);
 
    double speed_mpsToPower_hp(double speed_mps);
 
    double speed_mpsToThrust_N(double speed_mps,
                               const struct EngineParameters::PolynomialEngineModelRpmToHp* engineMapping,
                               double wheelDiameter_m, double differentialRatio,
                               double gearRatio, double engineEfficiency);
 
    double speed_mpsToThrust_N(double speed_mps);
 
    double airDrag_N(double speed_mps, double cAir, double a_m2, double rho_kgpm3);
 
    double airDrag_N(double speed_mps);
 
    double rollingResistance_N(double speed_mps, double mass_kg, double cr1, double cr2);
    double rollingResistance_N(double speed_mps);
 
    double gravityForce_N(double mass_kg, double slope);
    double gravityForce_N();
 
    double opposingForce_N(double speed_mps, double mass_kg, double slope,
                           double cAir, double a_m2, double rho_kgpm3,
                           double cr1, double cr2);
 
    double opposingForce_N(double speed_mps);
 
    double maxNoSlipAcceleration_mps2(double slope, double frictionCoefficient);
 
    double maxNoSlipAcceleration_mps2();
 
    double thrust_NToAcceleration_mps2(double thrust_N);
 
    int performGearShifting(double speed_mps, double acceleration_mps2);
 
    double getEngineTimeConstant_s(double rpm);
 
    double maxEngineAcceleration_mps2(double speed_mps);
 
    double getRealBrakingAcceleration(double speed_mps, double accel_mps2, double reqAccel_mps2, SUMOTime t);
 
public:
    RealisticEngineModel();
    virtual ~RealisticEngineModel();
 
    virtual double getRealAcceleration(double speed_mps, double accel_mps2, double reqAccel_mps2, SUMOTime timeStep = 0);
 
    void loadParameters();
 
    virtual void setParameter(const std::string parameter, const std::string& value);
    virtual void setParameter(const std::string parameter, double value);
    virtual void setParameter(const std::string parameter, int value);
 
    void getEngineData(double speed_mps, int& gear, double& rpm);
};