Package sim2net.propagation

This package provides a collection of wireless signal propagation model classes.

A wireless transmission may be distorted by many effects such as free-space loss, refraction, diffraction, reflection or absorption. Therefore, wireless propagation models describe the influence of environment on signal quality (mainly as a function of frequency, distance or other conditions) and calculate the signal-to-noise ratio (SNR) at the receiver. Then, it is assumed that if the SNR value is higher than some prescribed threshold, the signal can be received, and the packet that is carried by the signal can be successfully received if the receiving node remains connected in this way with the sending node at least for the duration of that packet transmission.

Module sim2net.propagation._propagation

Contains an abstract class that should be implemented by all wireless signal propagation model classes.

class sim2net.propagation._propagation.Propagation(name)

Bases: object

This class is an abstract class that should be implemented by all wireless signal propagation model classes.

Parameters:
  • name (str): a name of the implemented placement model.
get_neighbors(coordinates)

Calculates identifiers of all nodes in a network that would be able to receive a wireless signal transmitted from a source node, according to the implemented propagation model. All nodes in the network are considered, one by one, as the source node.

Parameters:
  • coordinates (list): a list of coordinates of all nodes in the simulated network at the current simulation step.
Returns:
A list that in position i is a list of all nodes that would be able to receive a wireless signal transmitted by a node whose identifier is equal to i.
Raises:
  • NotImplementedError: this method is an abstract method.
logger

(Property) A logger object of the logging.Logger class with an appropriate channel name.

random_generator

(Property) An object representing the sim2net.utility.randomness._Randomness pseudo-random number generator.

Module sim2net.propagation.path_loss

This module provides an implementation of the simplified path loss model.

The path loss model predicts the reduction in attenuation (power density) a signal encounters as it propagates through space. In this simplified implementation, it is presumed that for all nodes that are within transmission range of each other, the signal-to-noise ratio (SNR) is above the minimal usable level, and hence, the nodes are able to communicate directly.

class sim2net.propagation.path_loss.PathLoss(transmission_range)

Bases: sim2net.propagation._propagation.Propagation

This class implements simplified path loss model in which the signal-to-noise ration is calculated on the given value of the transmission range of nodes.

Parameters:
  • transmission_range (float): a value of the transmission (or communication) radius of nodes, that is, the distance from a transmitter at which the signal strength remains above the minimum usable level.
Raises:
  • ValueError: raised when the given transmission range is less or equal to 0.
_PathLoss__distance(source_coordinates, destination_coordinates)

Calculates the distance between source and destination nodes in Cartesian space.

Parameters:
  • source_coordinates (list): values of the source node’s horizontal and vertical coordinates at the current simulation step;
  • destination_coordinates (list): values of the destination node’s horizontal and vertical coordinates at the current simulation step.
Returns:
The distance between source and destination nodes in Cartesian space of type float.
get_neighbors(coordinates)

Calculates identifiers of all nodes in a network that would be able to receive a wireless signal transmitted from a source node, according to the implemented propagation model. All nodes in the network are considered, one by one, as the source node.

Parameters:
  • coordinates (list): a list of coordinates of all nodes in the simulated network at the current simulation step.
Returns:
A list that in position i is a list of all nodes that would be able to receive a wireless signal transmitted by a node whose identifier is equal to i.

Examples:

>>> pathloss = PathLoss(1.0)
>>> coordinates = [[1.0, 2.0], [1.5, 2.5], [2.0, 3.0], [2.5, 3.5]]
>>> print pathloss.get_neighbors(coordinates)
[[1], [0, 2], [1, 3], [2]]
>>> coordinates = [[1.0, 2.0], [1.1, 2.1], [1.2, 2.2], [1.3, 2.3]]
>>> print pathloss.get_neighbors(coordinates)
[[1, 2, 3], [0, 2, 3], [0, 1, 3], [0, 1, 2]]