This module implements a distributed dual-gradient based algorithm for adjusting the backoff windows sizes in a wireless network with a CSMA-mased MAC, to maximize the network utility enforcing a fair allocation of the resources.
Ths event processor is adapted to permit observing the algorithm performances under user-defined conditions,
including asynchronous distributed executions, where signaling can be affected by losses and/or delays, and/or measurement errors.
The time evolution of different metrics can be stored in output files, for later processing.
As an example, see the fig_sec10_5_csmaBackoffOptimizationDual.m MATLAB file used for generating the graph/s of the case study in the
book using this algorithm.
To simulate a network with this module, use the Online_evGen_doNothing generator.
update_isSynchronous: Boolean type (default: false). true if all the distributed agents involved wake up synchronousely to update its state
update_averageInterUpdateTime: Default: 1.0 Average time between two updates of an agent
update_maxFluctuationInterUpdateTime: Default: 0.5 Max fluctuation in time in the update interval of an agent, in absolute time values. The update intervals are sampled from a uniform distribution within the given interval
gradient_gammaStep: Default: 5.0 Gamma step in the gradient algorithm
control_fairnessFactor: Default: 1.0 Fairness factor in utility function of link capacity assignment
simulation_randomSeed: Default: 1 Seed of the random number generator
simulation_maxNumberOfUpdateIntervals: Default: 1000.0 Maximum number of update intervals in average per agent
control_linkNominalCapacity: Default: 1.0 Nominal rate of the links. If non positive, nominal rates are rates of the initial design
simulation_outFileNameRoot: Default: csmaBackoffOptimizationDual Root of the file name to be used in the output files. If blank, no output
control_betaFactor: Default: 10.0 Factor weighting the network utility in the objective function
control_maxSeMeasurementRelativeNoise: Default: 0.1 Max relative fluctuation in gradient coordinate