com.net2plan.interfaces.resilienceSimulation

Class ResilienceNetState

Object

com.net2plan.interfaces.resilienceSimulation.ResilienceNetState

public class ResilienceNetState
extends Object

Since:

0.2.0

Author:

Pablo Pavon-Marino, Jose-Luis Izquierdo-Zaragoza

Constructor Summary

Constructors

Constructor and Description
ResilienceNetState(NetPlan netPlan) Initializes a network state structure.

Method Summary

Methods

Modifier and Type	Method and Description
void	check(Map<String,String> net2planParameters) Checks the current network state.
NetPlan	convertToNetPlan() Converts the current network state to a network plan.
ResilienceNetState	copy() Returns a deep copy of the network state
double[]	getDemandCarriedTrafficInErlangsVector()
void	getFailureEffects(ResilienceEvents event, Set<Integer> nodesDown, Set<Integer> linksDown, Set<Integer> affectedRoutes, Set<Integer> unrecoverableRoutes, List<Double> currentLinkAvailableCapacity, Set<Integer> segmentsDown, List<Double> currentSegmentAvailableCapacity)
int[]	getFailureGroupsDown()
int	getFirstAvailableNodeDownstream(int routeId, int[] nodesDown, int[] linksDown)
int	getFirstAvailableNodeUpstream(int routeId, int[] nodesDown, int[] linksDown)
double	getLinkAvailableCapacityInErlangs(int linkId, int[] linksDown)
double[]	getLinkAvailableCapacityInErlangsVector(int[] linksDown)
double	getLinkCurrentCarriedTrafficInErlangs(int linkId) Returns the carried traffic by the specified link.
double[]	getLinkCurrentCarriedTrafficInErlangsVector() Returns a vector with the carried traffic per link.
int[]	getLinksDown() Returns the list of links which are down.
int[]	getLinkTraversingRoutes(int linkId) Returns the list of routes which are traversed by a given link.
double[]	getNodeEgressTrafficInErlangsVector() Returns the current egress traffic from each node.
double[]	getNodeIngressTrafficInErlangsVector() Returns the current ingress traffic to each node.
void	getNodeLinkStateChanges(int[] newSRGsDown, int[] newSRGsUp, Set<Integer> nodesDown2Up, Set<Integer> nodesUp2Down, Set<Integer> linksDown2Up, Set<Integer> linksUp2Down) Returns the set of current state changes in the network.
int[]	getNodesDown() Returns the list of nodes which are down.
int[]	getNodeTraversingRoutes(int nodeId)
double[]	getNodeTraversingTrafficInErlangsVector() Returns the current traffic traversing each node.
int	getNumberOfFailureGroups() Returns the number of defined SRGs.
double[]	getProtectionSegmentAvailableCapacityInErlangsVector(int[] segmentsDown)
double	getProtectionSegmentCurrentCarriedTrafficInErlangs(int segmentId) Returns the traffic carried by the specified protection segment.
double[]	getProtectionSegmentCurrentCarriedTrafficInErlangsVector() Returns a vector with the carried traffic per protection segment.
int[]	getProtectionSegmentsDown(int[] nodesDown, int[] linksDown) Returns the list of protection segments which are down.
void	getReparationEffects(ResilienceEvents event, Set<Integer> nodesDown, Set<Integer> linksDown, Set<Integer> reparableRoutes, Set<Integer> unreparableRoutes, List<Double> currentLinkAvailableCapacity, Set<Integer> segmentsDown, List<Double> currentSegmentAvailableCapacity)
double	getRouteCurrentCarriedTrafficInErlangs(int routeId) Returns the current carried traffic by a route.
double[]	getRouteCurrentCarriedTrafficInErlangsVector() Returns a vector with the current carried traffic by the routes.
int[]	getRouteCurrentSequenceOfLinksAndSegments(int routeId) Returns the list of links and segments traversed by the route.
int[]	getRouteCurrentSequenceOfNodes(int routeId)
void	setFailureGroups(int[][] N_f, int[][] E_f)
String	toString()
ResilienceNetState	unmodifiableView() Returns an unmodifiable view of the network state.
void	update(ResilienceEvents event, ProvisioningActions actions) Update the network state.

Methods inherited from class Object

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

Constructor Detail

ResilienceNetState

public ResilienceNetState(NetPlan netPlan)

Initializes a network state structure. It assumes that no failure groups (SRGs) are defined.

Parameters:

netPlan - Complete network design (including traffic routes)

Method Detail

convertToNetPlan

public NetPlan convertToNetPlan()

Converts the current network state to a network plan. By doing so this network plan can be used for reports.

Returns:

Network plan associated to the current network state

Since:

0.2.0

copy

public ResilienceNetState copy()

Returns a deep copy of the network state

Returns:

A deep copy of the network state

Since:

0.2.0

unmodifiableView

public ResilienceNetState unmodifiableView()

Returns an unmodifiable view of the network state.

Returns:

An unmodifiable view of the network state

Since:

0.2.0

setFailureGroups

public void setFailureGroups(int[][] N_f,
                    int[][] E_f)

getLinksDown

public int[] getLinksDown()

Returns the list of links which are down.

Returns:

List of links in state down

Since:

0.2.0

getNodesDown

public int[] getNodesDown()

Returns the list of nodes which are down.

Returns:

List of nodes in state down

Since:

0.2.0

getProtectionSegmentsDown

public int[] getProtectionSegmentsDown(int[] nodesDown,
                              int[] linksDown)

Returns the list of protection segments which are down.

Returns:

List of protection segments in state down

Since:

0.2.0

getNodeLinkStateChanges

public void getNodeLinkStateChanges(int[] newSRGsDown,
                           int[] newSRGsUp,
                           Set<Integer> nodesDown2Up,
                           Set<Integer> nodesUp2Down,
                           Set<Integer> linksDown2Up,
                           Set<Integer> linksUp2Down)

Returns the set of current state changes in the network.

Parameters:

newSRGDown - List of SRGs changing from up to down

newSRGUp - List of SRGs changing from down to up

nodesDown2Up - Set of nodes changing from down to up

nodesUp2Down - Set of nodes changing from up to down

linksDown2Up - Set of links changing from down to up

linksUp2Down - Set of links changing from up to down

Since:

0.2.0

getFailureEffects

public void getFailureEffects(ResilienceEvents event,
                     Set<Integer> nodesDown,
                     Set<Integer> linksDown,
                     Set<Integer> affectedRoutes,
                     Set<Integer> unrecoverableRoutes,
                     List<Double> currentLinkAvailableCapacity,
                     Set<Integer> segmentsDown,
                     List<Double> currentSegmentAvailableCapacity)

getReparationEffects

public void getReparationEffects(ResilienceEvents event,
                        Set<Integer> nodesDown,
                        Set<Integer> linksDown,
                        Set<Integer> reparableRoutes,
                        Set<Integer> unreparableRoutes,
                        List<Double> currentLinkAvailableCapacity,
                        Set<Integer> segmentsDown,
                        List<Double> currentSegmentAvailableCapacity)

getFirstAvailableNodeDownstream

public int getFirstAvailableNodeDownstream(int routeId,
                                  int[] nodesDown,
                                  int[] linksDown)

getFirstAvailableNodeUpstream

public int getFirstAvailableNodeUpstream(int routeId,
                                int[] nodesDown,
                                int[] linksDown)

getNodeTraversingRoutes

public int[] getNodeTraversingRoutes(int nodeId)

getLinkTraversingRoutes

public int[] getLinkTraversingRoutes(int linkId)

Returns the list of routes which are traversed by a given link.

Parameters:

linkId - Link identifier

Returns:

List of routes traversed by the link

Since:

0.2.0

getDemandCarriedTrafficInErlangsVector

public double[] getDemandCarriedTrafficInErlangsVector()

getNodeEgressTrafficInErlangsVector

public double[] getNodeEgressTrafficInErlangsVector()

Returns the current egress traffic from each node.

Returns:

Current egress traffic from each node

Since:

0.2.0

getProtectionSegmentAvailableCapacityInErlangsVector

public double[] getProtectionSegmentAvailableCapacityInErlangsVector(int[] segmentsDown)

getLinkAvailableCapacityInErlangs

public double getLinkAvailableCapacityInErlangs(int linkId,
                                       int[] linksDown)

getLinkAvailableCapacityInErlangsVector

public double[] getLinkAvailableCapacityInErlangsVector(int[] linksDown)

getNodeIngressTrafficInErlangsVector

public double[] getNodeIngressTrafficInErlangsVector()

Returns the current ingress traffic to each node.

Returns:

Current ingress traffic to each node

Since:

0.2.0

getNodeTraversingTrafficInErlangsVector

public double[] getNodeTraversingTrafficInErlangsVector()

Returns the current traffic traversing each node.

Returns:

Current traffic traversing each node

Since:

0.2.0

getFailureGroupsDown

public int[] getFailureGroupsDown()

check

public void check(Map<String,String> net2planParameters)

Checks the current network state.

Since:

0.2.0

getLinkCurrentCarriedTrafficInErlangs

public double getLinkCurrentCarriedTrafficInErlangs(int linkId)

Returns the carried traffic by the specified link.

Parameters:

linkId - Link identifier

Returns:

The carried traffic by the specified link

Since:

0.2.0

getLinkCurrentCarriedTrafficInErlangsVector

public double[] getLinkCurrentCarriedTrafficInErlangsVector()

Returns a vector with the carried traffic per link.

Returns:

Vector with the carried traffic per link

Since:

0.2.0

getRouteCurrentCarriedTrafficInErlangs

public double getRouteCurrentCarriedTrafficInErlangs(int routeId)

Returns the current carried traffic by a route.

Parameters:

routeId - Route identifier

Returns:

Current carried traffic in Erlangs

Since:

0.2.0

getRouteCurrentCarriedTrafficInErlangsVector

public double[] getRouteCurrentCarriedTrafficInErlangsVector()

Returns a vector with the current carried traffic by the routes.

Returns:

Vector of carried traffic by routes

Since:

0.2.0

getRouteCurrentSequenceOfNodes

public int[] getRouteCurrentSequenceOfNodes(int routeId)

getRouteCurrentSequenceOfLinksAndSegments

public int[] getRouteCurrentSequenceOfLinksAndSegments(int routeId)

Returns the list of links and segments traversed by the route.

Parameters:

routeId - Route identifier

Returns:

List of links and segments traversed by the route

Since:

0.2.0

getProtectionSegmentCurrentCarriedTrafficInErlangs

public double getProtectionSegmentCurrentCarriedTrafficInErlangs(int segmentId)

Returns the traffic carried by the specified protection segment.

Parameters:

segmentId - Protection segment identifier

Returns:

Traffic carried by the specified protection segment

Since:

0.2.0

getProtectionSegmentCurrentCarriedTrafficInErlangsVector

public double[] getProtectionSegmentCurrentCarriedTrafficInErlangsVector()

Returns a vector with the carried traffic per protection segment.

Returns:

A vector with the carried traffic per protection segment

Since:

0.2.0

update

public void update(ResilienceEvents event,
          ProvisioningActions actions)

Update the network state.

Parameters:

event - Failure/reparation

actions - List of action to perform

Since:

0.2.0

getNumberOfFailureGroups

public int getNumberOfFailureGroups()

Returns the number of defined SRGs.

Returns:

Number of defined SRGs

Since:

0.2.0

toString

public String toString()

Overrides:

toString in class Object