EmpiricalConsumptionModel (API Reference)
Class EmpiricalConsumptionModel
This model defines a data-driven energy consumption model for electric vehicles.
It estimates the electrical energy required to traverse a route by combining empirically derived vehicle parameters with route characteristics such as distance, elevation changes, and driving speed. Rather than relying on a full physical simulation, this model uses observed consumption behavior to produce realistic and efficient energy estimates suitable for routing, range prediction, and navigation use cases.
Parameters specific to the electric vehicle are used to calculate energy consumption on a given route.
At minimum, you must provide ascentConsumptionInWattHoursPerMeter,
descentRecoveryInWattHoursPerMeter and a
freeFlowSpeedTable.
Note: This is a beta release of this feature, so there could be a few bugs and unexpected behaviors.
Related APIs may change for new releases without a deprecation process.
-
Field Summary
FieldsModifier and TypeFieldDescriptiondoubleRate of energy consumed per meter rise in elevation (in Wh/m, i.e., Watt-hours per meter).doubleRate of energy (in Wh/s) consumed by the vehicle's auxiliary systems (e.g., air conditioning, lights) per second of travel.doubleRate of energy recovered per meter fall in elevation (in Wh/m, i.e., Watt-hours per meter).Free flow speed table describes energy consumption when traveling at constant speed.Traffic speed table describes energy consumption when traveling under heavy traffic conditions, i.e. -
Constructor Summary
Constructors -
Method Summary
-
Field Details
-
ascentConsumptionInWattHoursPerMeter
public double ascentConsumptionInWattHoursPerMeterRate of energy consumed per meter rise in elevation (in Wh/m, i.e., Watt-hours per meter).
-
descentRecoveryInWattHoursPerMeter
public double descentRecoveryInWattHoursPerMeterRate of energy recovered per meter fall in elevation (in Wh/m, i.e., Watt-hours per meter).
-
freeFlowSpeedTable
Free flow speed table describes energy consumption when traveling at constant speed. It defines a function curve specifying consumption rate at a given free flow speed on a flat stretch of road. Map keys represent speed values that are non-negative integers in units of (km/h). Map values represent consumption values that are non-negative floating point values in units of (Wh/m). The function is linearly interpolated between each successive pair of data points: For values below the first list value, the first value is used. For values after the last list value, the last list value is used. At minimum, one key/value pair must be set. In this case the consumption value is used for all possible speed keys.
-
trafficSpeedTable
Traffic speed table describes energy consumption when traveling under heavy traffic conditions, i.e. when the vehicle is expected to often change the travel speed. It defines a function curve specifying consumption rate at a given speed under traffic conditions on a flat stretch of road. Map keys represent traffic speed values that are non-negative integers in units of (km/h). Map values represent consumption values that are non-negative floating point values in units of (Wh/m). The function is linearly interpolated between each successive pair of data points: For values below the first list value, the first value is used. For values after the last list value, the last list value is used. If only one key/value pair is set, the consumption value is used for all possible traffic speed keys. If
trafficSpeedTableis empty then onlyfreeFlowSpeedTableis used for calculating speed-related energy consumption. -
auxiliaryConsumptionInWattHoursPerSecond
public double auxiliaryConsumptionInWattHoursPerSecondRate of energy (in Wh/s) consumed by the vehicle's auxiliary systems (e.g., air conditioning, lights) per second of travel.
-
-
Constructor Details
-
EmpiricalConsumptionModel
public EmpiricalConsumptionModel()Creates a new instance.
-
-
Method Details