Module comm_network 

Smart-grid communication network simulation framework.

Models latency, packet loss, bandwidth constraints, and their impact on power system control stability. Supports:

• Multiple smart-grid communication protocols (IEC 61850, DNP3, Modbus, MQTT, 5G URLLC, Fibre, 4G)
• Realistic latency sampling with LCG + Box–Muller jitter
• Congestion modelling (none / simple threshold / detailed queue)
• Cyber-attack impact estimation (DoS, Man-in-the-Middle)
• Control-loop delay analysis (Nyquist stability criterion)
• Monte-Carlo latency statistics (mean, σ, P95, P99, max)
• Upgrade recommendations based on measured vs. required performance

Units

All latencies are in milliseconds \[ms\], bandwidths in kilobits per second \[kbps\], and fractions (loss, availability) are dimensionless in \[0, 1\].

Structs

AttackImpact

Impact of a cyber attack on a link.

CommLink

A unidirectional network link with bandwidth and reliability characterisation.

CommMessage

A smart-grid protocol message to be simulated over a CommLink.

CommNetworkConfig

Top-level configuration for a CommNetworkSim session.

CommNetworkSim

Smart-grid communication network simulator.

ControlLoopAnalysis

Round-trip analysis of a cascaded sequence of links (control loop).

DeliveryResult

Result of simulating delivery of a single message over a link.

LatencyStats

Latency distribution statistics from a Monte-Carlo run.

PerformanceRequirements

Minimum acceptable performance for a link.

ProtectionAssessment

Protection-system performance report.

UpgradeRecommendation

A single upgrade recommendation for a link.

Enums

AttackType

Cyber-attack scenario to inject into a link.

CommMessageType

Semantic class of a smart-grid message, with implied deadline.

CommProtocol

Communication protocol used on a link.

CongestionModel

Model used to increase latency under high link utilisation.

MessagePriority

Message delivery priority (highest → lowest).