A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
ns3::energy::RvBatteryModel Class Reference

Rakhmatov Vrudhula non-linear battery model. More...

#include "rv-battery-model.h"

+ Inheritance diagram for ns3::energy::RvBatteryModel:
+ Collaboration diagram for ns3::energy::RvBatteryModel:

Public Member Functions

 RvBatteryModel ()
 
 ~RvBatteryModel () override
 
double GetAlpha () const
 
double GetBatteryLevel ()
 
double GetBeta () const
 
double GetCutoffVoltage () const
 
double GetEnergyFraction () override
 
double GetInitialEnergy () const override
 
Time GetLifetime () const
 
int GetNumOfTerms () const
 
double GetOpenCircuitVoltage () const
 
double GetRemainingEnergy () override
 
Time GetSamplingInterval () const
 
double GetSupplyVoltage () const override
 
void SetAlpha (double alpha)
 Sets the alpha value for the battery model.
 
void SetBeta (double beta)
 Sets the beta value for the battery model.
 
void SetCutoffVoltage (double voltage)
 Sets cutoff voltage of battery.
 
void SetNumOfTerms (int num)
 Sets the number of terms of the infinite sum for estimating battery level.
 
void SetOpenCircuitVoltage (double voltage)
 Sets open circuit voltage of battery.
 
void SetSamplingInterval (Time interval)
 
void UpdateEnergySource () override
 Implements UpdateEnergySource.
 
- Public Member Functions inherited from ns3::energy::EnergySource
 EnergySource ()
 
 ~EnergySource () override
 
void AppendDeviceEnergyModel (Ptr< DeviceEnergyModel > deviceEnergyModelPtr)
 
void ConnectEnergyHarvester (Ptr< EnergyHarvester > energyHarvesterPtr)
 
void DisposeDeviceModels ()
 Calls Dispose () method of the device energy models.
 
DeviceEnergyModelContainer FindDeviceEnergyModels (std::string name)
 
DeviceEnergyModelContainer FindDeviceEnergyModels (TypeId tid)
 
Ptr< NodeGetNode () const
 
void InitializeDeviceModels ()
 Calls Start () method of the device energy models.
 
void SetNode (Ptr< Node > node)
 Sets pointer to node containing this EnergySource.
 
- Public Member Functions inherited from ns3::Object
 Object ()
 Constructor.
 
 ~Object () override
 Destructor.
 
void AggregateObject (Ptr< Object > other)
 Aggregate two Objects together.
 
void Dispose ()
 Dispose of this Object.
 
AggregateIterator GetAggregateIterator () const
 Get an iterator to the Objects aggregated to this one.
 
TypeId GetInstanceTypeId () const override
 Get the most derived TypeId for this Object.
 
template<typename T >
Ptr< T > GetObject () const
 Get a pointer to the requested aggregated Object.
 
template<>
Ptr< ObjectGetObject () const
 Specialization of () for objects of type ns3::Object.
 
template<typename T >
Ptr< T > GetObject (TypeId tid) const
 Get a pointer to the requested aggregated Object by TypeId.
 
template<>
Ptr< ObjectGetObject (TypeId tid) const
 Specialization of (TypeId tid) for objects of type ns3::Object.
 
void Initialize ()
 Invoke DoInitialize on all Objects aggregated to this one.
 
bool IsInitialized () const
 Check if the object has been initialized.
 
void UnidirectionalAggregateObject (Ptr< Object > other)
 Aggregate an Object to another Object.
 
- Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
 SimpleRefCount ()
 Default constructor.
 
 SimpleRefCount (const SimpleRefCount &o)
 Copy constructor.
 
uint32_t GetReferenceCount () const
 Get the reference count of the object.
 
SimpleRefCountoperator= (const SimpleRefCount &o)
 Assignment operator.
 
void Ref () const
 Increment the reference count.
 
void Unref () const
 Decrement the reference count.
 
- Public Member Functions inherited from ns3::ObjectBase
virtual ~ObjectBase ()
 Virtual destructor.
 
void GetAttribute (std::string name, AttributeValue &value, bool permissive=false) const
 Get the value of an attribute, raising fatal errors if unsuccessful.
 
bool GetAttributeFailSafe (std::string name, AttributeValue &value) const
 Get the value of an attribute without raising errors.
 
void SetAttribute (std::string name, const AttributeValue &value)
 Set a single attribute, raising fatal errors if unsuccessful.
 
bool SetAttributeFailSafe (std::string name, const AttributeValue &value)
 Set a single attribute without raising errors.
 
bool TraceConnect (std::string name, std::string context, const CallbackBase &cb)
 Connect a TraceSource to a Callback with a context.
 
bool TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
 Connect a TraceSource to a Callback without a context.
 
bool TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
 Disconnect from a TraceSource a Callback previously connected with a context.
 
bool TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)
 Disconnect from a TraceSource a Callback previously connected without a context.
 

Static Public Member Functions

static TypeId GetTypeId ()
 Get the type ID.
 
- Static Public Member Functions inherited from ns3::energy::EnergySource
static TypeId GetTypeId ()
 Get the type ID.
 
- Static Public Member Functions inherited from ns3::Object
static TypeId GetTypeId ()
 Register this type.
 
- Static Public Member Functions inherited from ns3::ObjectBase
static TypeId GetTypeId ()
 Get the type ID.
 

Private Member Functions

double Discharge (double load, Time t)
 Discharges the battery.
 
void DoDispose () override
 Defined in ns3::Object.
 
void DoInitialize () override
 Defined in ns3::Object.
 
void HandleEnergyDrainedEvent ()
 Handles the remaining energy going to zero event.
 
double RvModelAFunction (Time t, Time sk, Time sk_1, double beta)
 RV model A function.
 

Private Attributes

double m_alpha
 alpha value of RV model, in Coulomb
 
TracedValue< doublem_batteryLevel
 Battery level is defined as: output of Discharge function / alpha value.
 
double m_beta
 beta value of RV model, in second^-1
 
EventId m_currentSampleEvent
 Current sample event.
 
double m_cutoffVoltage
 Cutoff voltage (in Volts)
 
Time m_lastSampleTime
 Last sample time.
 
TracedValue< Timem_lifetime
 time of death of the battery
 
std::vector< doublem_load
 load profile
 
double m_lowBatteryTh
 low battery threshold, as a fraction of the initial energy
 
int m_numOfTerms
 Number# of terms for infinite sum in battery level estimation.
 
double m_openCircuitVoltage
 Open circuit voltage (in Volts)
 
double m_previousLoad
 load value (total current) of previous sampling
 
Time m_samplingInterval
 Sampling interval.
 
std::vector< Timem_timeStamps
 time stamps of load profile
 

Additional Inherited Members

- Protected Member Functions inherited from ns3::energy::EnergySource
void BreakDeviceEnergyModelRefCycle ()
 This function is called to break reference cycle between EnergySource and DeviceEnergyModel.
 
double CalculateTotalCurrent ()
 
void NotifyEnergyChanged ()
 This function notifies all DeviceEnergyModel of energy changed event.
 
void NotifyEnergyDrained ()
 This function notifies all DeviceEnergyModel of energy depletion event.
 
void NotifyEnergyRecharged ()
 This function notifies all DeviceEnergyModel of energy recharged event.
 
- Protected Member Functions inherited from ns3::Object
 Object (const Object &o)
 Copy an Object.
 
virtual void NotifyNewAggregate ()
 Notify all Objects aggregated to this one of a new Object being aggregated.
 
- Protected Member Functions inherited from ns3::ObjectBase
void ConstructSelf (const AttributeConstructionList &attributes)
 Complete construction of ObjectBase; invoked by derived classes.
 
virtual void NotifyConstructionCompleted ()
 Notifier called once the ObjectBase is fully constructed.
 

Detailed Description

Rakhmatov Vrudhula non-linear battery model.

This (energy source) model implements an analytical non-linear battery model. It is capable of capturing load capacity and recovery effects of batteries. Batteries are characterized by 2 parameters, alpha and beta, which can both be obtained from the discharge curve of the batteries.

The model is developed by Daler Rakhmatov & Sarma Vrudhula in: "Battery Lifetime Prediction for Energy-Aware Computing" and "An Analytical High-Level Battery Model for Use in Energy Management of Portable Electronic Systems".

The real-time algorithm is developed by Matthias Handy & Dirk Timmermann in: "Simulation of Mobile Wireless Networks with Accurate Modeling of non-linear battery effects". The real-time algorithm is modified by the authors of this code for improved accuracy and reduced computation (sampling) overhead.

Definition at line 42 of file rv-battery-model.h.

Constructor & Destructor Documentation

◆ RvBatteryModel()

ns3::energy::RvBatteryModel::RvBatteryModel ( )

Definition at line 86 of file rv-battery-model.cc.

References m_batteryLevel, m_lastSampleTime, m_lifetime, m_previousLoad, m_timeStamps, ns3::Simulator::Now(), NS_LOG_FUNCTION, and ns3::Seconds().

+ Here is the call graph for this function:

◆ ~RvBatteryModel()

ns3::energy::RvBatteryModel::~RvBatteryModel ( )
override

Definition at line 96 of file rv-battery-model.cc.

References NS_LOG_FUNCTION.

Member Function Documentation

◆ Discharge()

double ns3::energy::RvBatteryModel::Discharge ( double load,
Time t )
private

Discharges the battery.

Parameters
loadLoad value (total current form devices, in mA).
tTime stamp of the load value.
Returns
Calculated alpha value.

Discharge function calculates a value which is then compared to the alpha value to determine if the battery is dead. It will also update the battery level.

Note that the load value passed to Discharge has to be in mA.

Definition at line 311 of file rv-battery-model.cc.

References m_beta, m_lastSampleTime, m_load, m_previousLoad, m_timeStamps, NS_ASSERT, NS_LOG_FUNCTION, RvModelAFunction(), and ns3::Seconds().

Referenced by UpdateEnergySource().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ DoDispose()

void ns3::energy::RvBatteryModel::DoDispose ( )
overrideprivatevirtual

Defined in ns3::Object.

Reimplemented from ns3::energy::EnergySource.

Definition at line 296 of file rv-battery-model.cc.

References ns3::energy::EnergySource::BreakDeviceEnergyModelRefCycle(), and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ DoInitialize()

void ns3::energy::RvBatteryModel::DoInitialize ( )
overrideprivatevirtual

Defined in ns3::Object.

Reimplemented from ns3::Object.

Definition at line 288 of file rv-battery-model.cc.

References NS_LOG_DEBUG, NS_LOG_FUNCTION, and UpdateEnergySource().

+ Here is the call graph for this function:

◆ GetAlpha()

double ns3::energy::RvBatteryModel::GetAlpha ( ) const
Returns
The alpha value used by the battery model.

Definition at line 233 of file rv-battery-model.cc.

References m_alpha, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ GetBatteryLevel()

double ns3::energy::RvBatteryModel::GetBatteryLevel ( )
Returns
Battery level [0, 1].

Definition at line 255 of file rv-battery-model.cc.

References m_batteryLevel, NS_LOG_FUNCTION, and UpdateEnergySource().

Referenced by GetEnergyFraction().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ GetBeta()

double ns3::energy::RvBatteryModel::GetBeta ( ) const
Returns
The beta value used by the battery model.

Definition at line 248 of file rv-battery-model.cc.

References m_beta, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ GetCutoffVoltage()

double ns3::energy::RvBatteryModel::GetCutoffVoltage ( ) const
Returns
Cutoff voltage of battery.

Definition at line 218 of file rv-battery-model.cc.

References m_cutoffVoltage, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ GetEnergyFraction()

double ns3::energy::RvBatteryModel::GetEnergyFraction ( )
overridevirtual
Returns
Energy fraction.

Implements GetEnergyFraction. For the RV battery model, energy fraction is equivalent to battery level.

Implements ns3::energy::EnergySource.

Definition at line 125 of file rv-battery-model.cc.

References GetBatteryLevel(), and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ GetInitialEnergy()

double ns3::energy::RvBatteryModel::GetInitialEnergy ( ) const
overridevirtual
Returns
Initial energy stored (theoretical capacity) in the battery, in Joules.

Implements GetInitialEnergy.

Implements ns3::energy::EnergySource.

Definition at line 102 of file rv-battery-model.cc.

References GetSupplyVoltage(), m_alpha, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ GetLifetime()

Time ns3::energy::RvBatteryModel::GetLifetime ( ) const
Returns
Lifetime of the battery.

Definition at line 263 of file rv-battery-model.cc.

References m_lifetime, and NS_LOG_FUNCTION.

◆ GetNumOfTerms()

int ns3::energy::RvBatteryModel::GetNumOfTerms ( ) const
Returns
The number of terms of the infinite sum for estimating battery level.

Definition at line 277 of file rv-battery-model.cc.

References m_numOfTerms, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ GetOpenCircuitVoltage()

double ns3::energy::RvBatteryModel::GetOpenCircuitVoltage ( ) const
Returns
Open circuit voltage of battery.

Definition at line 203 of file rv-battery-model.cc.

References m_openCircuitVoltage, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ GetRemainingEnergy()

double ns3::energy::RvBatteryModel::GetRemainingEnergy ( )
overridevirtual
Returns
Remaining energy in energy source, in Joules

Implements GetRemainingEnergy.

Implements ns3::energy::EnergySource.

Definition at line 117 of file rv-battery-model.cc.

References GetSupplyVoltage(), m_alpha, m_batteryLevel, NS_LOG_FUNCTION, and UpdateEnergySource().

+ Here is the call graph for this function:

◆ GetSamplingInterval()

Time ns3::energy::RvBatteryModel::GetSamplingInterval ( ) const
Returns
The interval between each energy update.

Definition at line 188 of file rv-battery-model.cc.

References m_samplingInterval, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ GetSupplyVoltage()

double ns3::energy::RvBatteryModel::GetSupplyVoltage ( ) const
overridevirtual
Returns
Supply voltage at the energy source.

Implements GetSupplyVoltage.

Implements ns3::energy::EnergySource.

Definition at line 109 of file rv-battery-model.cc.

References m_cutoffVoltage, m_openCircuitVoltage, and NS_LOG_FUNCTION.

Referenced by GetInitialEnergy(), and GetRemainingEnergy().

+ Here is the caller graph for this function:

◆ GetTypeId()

◆ HandleEnergyDrainedEvent()

void ns3::energy::RvBatteryModel::HandleEnergyDrainedEvent ( )
private

Handles the remaining energy going to zero event.

This function notifies all the energy models aggregated to the node about the energy being depleted. Each energy model is then responsible for its own handler.

Definition at line 303 of file rv-battery-model.cc.

References ns3::energy::EnergySource::NotifyEnergyDrained(), NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Referenced by UpdateEnergySource().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ RvModelAFunction()

double ns3::energy::RvBatteryModel::RvModelAFunction ( Time t,
Time sk,
Time sk_1,
double beta )
private

RV model A function.

Parameters
tCurrent time.
skTime stamp in array position k
sk_1Time stamp in array position k-1
betaBeta value used by the battery model.
Returns
Result of A function.

This function computes alpha value using the recorded load profile.

Definition at line 355 of file rv-battery-model.cc.

References m_numOfTerms, and NS_LOG_FUNCTION.

Referenced by Discharge().

+ Here is the caller graph for this function:

◆ SetAlpha()

void ns3::energy::RvBatteryModel::SetAlpha ( double alpha)

Sets the alpha value for the battery model.

Parameters
alphaAlpha.

Definition at line 225 of file rv-battery-model.cc.

References m_alpha, NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ SetBeta()

void ns3::energy::RvBatteryModel::SetBeta ( double beta)

Sets the beta value for the battery model.

Parameters
betaBeta.

Definition at line 240 of file rv-battery-model.cc.

References m_beta, NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ SetCutoffVoltage()

void ns3::energy::RvBatteryModel::SetCutoffVoltage ( double voltage)

Sets cutoff voltage of battery.

Parameters
voltageCutoff voltage.

Definition at line 210 of file rv-battery-model.cc.

References m_cutoffVoltage, m_openCircuitVoltage, NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ SetNumOfTerms()

void ns3::energy::RvBatteryModel::SetNumOfTerms ( int num)

Sets the number of terms of the infinite sum for estimating battery level.

Parameters
numNumber of terms.

Definition at line 270 of file rv-battery-model.cc.

References m_numOfTerms, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ SetOpenCircuitVoltage()

void ns3::energy::RvBatteryModel::SetOpenCircuitVoltage ( double voltage)

Sets open circuit voltage of battery.

Parameters
voltageOpen circuit voltage.

Definition at line 195 of file rv-battery-model.cc.

References m_openCircuitVoltage, NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ SetSamplingInterval()

void ns3::energy::RvBatteryModel::SetSamplingInterval ( Time interval)
Parameters
intervalEnergy update interval.

This function sets the interval between each energy update.

Definition at line 181 of file rv-battery-model.cc.

References m_samplingInterval, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ UpdateEnergySource()

void ns3::energy::RvBatteryModel::UpdateEnergySource ( )
overridevirtual

Implements UpdateEnergySource.

This function samples the total load (total current) from all devices to discharge the battery.

Implements ns3::energy::EnergySource.

Definition at line 132 of file rv-battery-model.cc.

References ns3::energy::EnergySource::CalculateTotalCurrent(), ns3::EventId::Cancel(), Discharge(), HandleEnergyDrainedEvent(), ns3::Simulator::IsFinished(), m_alpha, m_batteryLevel, m_currentSampleEvent, m_lastSampleTime, m_lifetime, m_lowBatteryTh, m_previousLoad, m_samplingInterval, m_timeStamps, ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Time::S, ns3::Simulator::Schedule(), and UpdateEnergySource().

Referenced by DoInitialize(), GetBatteryLevel(), GetRemainingEnergy(), and UpdateEnergySource().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Member Data Documentation

◆ m_alpha

double ns3::energy::RvBatteryModel::m_alpha
private

alpha value of RV model, in Coulomb

Definition at line 217 of file rv-battery-model.h.

Referenced by GetAlpha(), GetInitialEnergy(), GetRemainingEnergy(), SetAlpha(), and UpdateEnergySource().

◆ m_batteryLevel

TracedValue<double> ns3::energy::RvBatteryModel::m_batteryLevel
private

Battery level is defined as: output of Discharge function / alpha value.

The output of Discharge function is an estimated charge consumption of the battery.

The alpha value is the amount of charges stored in the battery, or battery capacity (in Coulomb).

When the battery is fully charged (no charge is consumed from the battery) the battery level is 1. When the battery is fully discharged, the battery level is 0.

NOTE Note that the definition in Timmermann's paper is the inverse of this definition. In the paper, battery level = 1 when the battery is drained.

Definition at line 243 of file rv-battery-model.h.

Referenced by RvBatteryModel(), GetBatteryLevel(), GetRemainingEnergy(), GetTypeId(), and UpdateEnergySource().

◆ m_beta

double ns3::energy::RvBatteryModel::m_beta
private

beta value of RV model, in second^-1

Definition at line 218 of file rv-battery-model.h.

Referenced by Discharge(), GetBeta(), and SetBeta().

◆ m_currentSampleEvent

EventId ns3::energy::RvBatteryModel::m_currentSampleEvent
private

Current sample event.

Definition at line 252 of file rv-battery-model.h.

Referenced by UpdateEnergySource().

◆ m_cutoffVoltage

double ns3::energy::RvBatteryModel::m_cutoffVoltage
private

Cutoff voltage (in Volts)

Definition at line 216 of file rv-battery-model.h.

Referenced by GetCutoffVoltage(), GetSupplyVoltage(), and SetCutoffVoltage().

◆ m_lastSampleTime

Time ns3::energy::RvBatteryModel::m_lastSampleTime
private

Last sample time.

Definition at line 223 of file rv-battery-model.h.

Referenced by RvBatteryModel(), Discharge(), and UpdateEnergySource().

◆ m_lifetime

TracedValue<Time> ns3::energy::RvBatteryModel::m_lifetime
private

time of death of the battery

Definition at line 254 of file rv-battery-model.h.

Referenced by RvBatteryModel(), GetLifetime(), GetTypeId(), and UpdateEnergySource().

◆ m_load

std::vector<double> ns3::energy::RvBatteryModel::m_load
private

load profile

Definition at line 221 of file rv-battery-model.h.

Referenced by Discharge().

◆ m_lowBatteryTh

double ns3::energy::RvBatteryModel::m_lowBatteryTh
private

low battery threshold, as a fraction of the initial energy

Definition at line 245 of file rv-battery-model.h.

Referenced by GetTypeId(), and UpdateEnergySource().

◆ m_numOfTerms

int ns3::energy::RvBatteryModel::m_numOfTerms
private

Number# of terms for infinite sum in battery level estimation.

Definition at line 225 of file rv-battery-model.h.

Referenced by GetNumOfTerms(), RvModelAFunction(), and SetNumOfTerms().

◆ m_openCircuitVoltage

double ns3::energy::RvBatteryModel::m_openCircuitVoltage
private

Open circuit voltage (in Volts)

Definition at line 215 of file rv-battery-model.h.

Referenced by GetOpenCircuitVoltage(), GetSupplyVoltage(), SetCutoffVoltage(), and SetOpenCircuitVoltage().

◆ m_previousLoad

double ns3::energy::RvBatteryModel::m_previousLoad
private

load value (total current) of previous sampling

Definition at line 220 of file rv-battery-model.h.

Referenced by RvBatteryModel(), Discharge(), and UpdateEnergySource().

◆ m_samplingInterval

Time ns3::energy::RvBatteryModel::m_samplingInterval
private

Sampling interval.

(1 / sampling interval) = sampling frequency

Definition at line 251 of file rv-battery-model.h.

Referenced by GetSamplingInterval(), SetSamplingInterval(), and UpdateEnergySource().

◆ m_timeStamps

std::vector<Time> ns3::energy::RvBatteryModel::m_timeStamps
private

time stamps of load profile

Definition at line 222 of file rv-battery-model.h.

Referenced by RvBatteryModel(), Discharge(), and UpdateEnergySource().


The documentation for this class was generated from the following files: