IRPact_modellierung.network

Class HeterogeneousRegularCommunicationGraph

java.lang.Object

IRPact_modellierung.SimulationEntity

IRPact_modellierung.network.SocialGraph

IRPact_modellierung.network.CommunicationGraph

IRPact_modellierung.network.HeterogeneousRegularCommunicationGraph

public class HeterogeneousRegularCommunicationGraph
extends CommunicationGraph

A HeterogeneousRegularCommunicationGraph is a communication graph, whose nodes correspond to agents of different agent groups, which tries to be as regular as possible. Since agent groups may differ by their out-degree, and the agent group a node establishes a communication link to is chosen stochastically, the in-degree of the corresponding agent groups differs as well. Within an agent group, the out-degree however is homogeneous, and the in-degree differs by at most one (is balance as well as possible).

Nested Class Summary

Nested classes/interfaces inherited from class IRPact_modellierung.network.SocialGraph

SocialGraph.EDGEMEDIUM

Field Summary

Fields inherited from class IRPact_modellierung.network.SocialGraph

edges, neighbours, nodes, outgoingEdges, outgoingEdgesMedium

Fields inherited from class IRPact_modellierung.SimulationEntity

associatedSimulationContainer

Constructor Summary

Constructors

Constructor and Description
HeterogeneousRegularCommunicationGraph(SimulationContainer associatedSimulationContainer, SNConfiguration sNConfiguration, int numberOfNodes)
HeterogeneousRegularCommunicationGraph(SimulationContainer associatedSimulationContainer, SNConfiguration sNConfiguration, java.util.Set<SNNode> initialNodes)
HeterogeneousRegularCommunicationGraph(SimulationContainer associatedSimulationContainer, SNConfiguration sNConfiguration, java.util.Set<SNNode> nodes, java.util.Set<SNEdge> edges, java.util.HashMap<SNNode,java.util.Set<SNNode>> neighbours)

Method Summary

Modifier and Type	Method and Description
java.util.Set<SNEdge>	createEdges(SNConfiguration sNConfiguration, java.util.Set<SNNode> initialNodes) Method to create the edges of a newly instantiated graph.
static java.util.Set<SNEdge>	createHeterogeneousRegularCommunicationEdges(SimulationContainer associatedSimulationContainer, java.util.Map<ConsumerAgentGroup,java.lang.Integer> consumerGroupZMapping, SNConfiguration sNConfiguration, java.util.Set<SNNode> initialNodes) Helper method to provide the functionality to create the respective edges for a heterogeneous regular network to other methods by making the method static.
java.util.Map<ConsumerAgentGroup,java.lang.Integer>	getConsumerGroupZMapping()

Methods inherited from class IRPact_modellierung.network.CommunicationGraph

getCommunicationNeighbours, getCommunicationNeighbours

Methods inherited from class IRPact_modellierung.network.SocialGraph

addEdge, addIsolatedNode, addNodes, getAllMediaNeighbours, getEdges, getNeighbours, getNeighbours, getNeighbours, getNeighbours, getNodes, modifyEdgeMedium, modifyEdgeNodes, modifyEdgeSource, modifyEdgeTarget, removeEdge, replaceEdge, retrieveAllEdges, retrieveEdge

Methods inherited from class IRPact_modellierung.SimulationEntity

getAssociatedSimulationContainer

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HeterogeneousRegularCommunicationGraph

public HeterogeneousRegularCommunicationGraph(SimulationContainer associatedSimulationContainer,
                                              SNConfiguration sNConfiguration,
                                              java.util.Set<SNNode> nodes,
                                              java.util.Set<SNEdge> edges,
                                              java.util.HashMap<SNNode,java.util.Set<SNNode>> neighbours)

HeterogeneousRegularCommunicationGraph

public HeterogeneousRegularCommunicationGraph(SimulationContainer associatedSimulationContainer,
                                              SNConfiguration sNConfiguration,
                                              java.util.Set<SNNode> initialNodes)

HeterogeneousRegularCommunicationGraph

public HeterogeneousRegularCommunicationGraph(SimulationContainer associatedSimulationContainer,
                                              SNConfiguration sNConfiguration,
                                              int numberOfNodes)

Method Detail

getConsumerGroupZMapping

public java.util.Map<ConsumerAgentGroup,java.lang.Integer> getConsumerGroupZMapping()

createEdges

public java.util.Set<SNEdge> createEdges(SNConfiguration sNConfiguration,
                                         java.util.Set<SNNode> initialNodes)

Method to create the edges of a newly instantiated graph. For each ConsumerAgentGroup this will create edges corresponding to the number of neighbours of that ConsumerAgentGroup, as described by the ConsumerGroupZMapping. Edges will be directed to a least connected node in a (stochastically chosen, proportional to the respective ConsumerAgentGroup affinity) target ConsumerAgentGroup. Through this homogeneity of degree is achieved (as much as possible), while the degrees between the groups might be quite heterogeneous.

Specified by:

createEdges in class SocialGraph

Parameters:

sNConfiguration - The configuration of the social graph of interest

initialNodes - The nodes the social graph should be initialized with

Returns:

The set of edges according to a heterogeneous regular graph

createHeterogeneousRegularCommunicationEdges

public static java.util.Set<SNEdge> createHeterogeneousRegularCommunicationEdges(SimulationContainer associatedSimulationContainer,
                                                                                 java.util.Map<ConsumerAgentGroup,java.lang.Integer> consumerGroupZMapping,
                                                                                 SNConfiguration sNConfiguration,
                                                                                 java.util.Set<SNNode> initialNodes)

Helper method to provide the functionality to create the respective edges for a heterogeneous regular network to other methods by making the method static.

Parameters:

associatedSimulationContainer - The container the graph is used in

consumerGroupZMapping - The map of how many neighbours to create for each ConsumerAgentGroup

sNConfiguration - The configuration of the social graph of interest

initialNodes - The nodes the social graph should be initialized with

Returns:

The set of edges according to a heterogeneous regular graph