PropagationScenario
Communication scenarios · Implementation: mlsysim/engine/scenario_definitions/communication.py.
Construct this scenario with keyword inputs. The fields below show the types and defaults declared by this class.
A request sent distance over fiber and answered; optionally a budget and a measured round trip.
Notes
Equation: Compose mlsysim.physics.networking.calc_network_latency_ms.
Assumptions: Distance is one-way fiber distance and the helper supplies its propagation convention; measured latency is an external optional input.
Excludes: Routing stretch, queueing, switching, and retransmission are not part of the propagation floor.
References
Derivation: this scenario binds its input fields to the referenced implementation contracts: mlsysim.physics.networking.calc_network_latency_ms. The methods below identify any additional arithmetic.
Examples
>>> from mlsysim import Scenarios
>>> case = Scenarios.RoboticArmRegionalCloud
>>> str(case.round_trip)
'15.0 ms'Attributes
| Name | Description |
|---|---|
| budget | |
| distance | |
| measured_over_floor | Observed round-trip latency relative to the modeled propagation floor. Equation: |
| measured_round_trip | |
| overrun | Amount by which propagation alone exceeds the latency budget. Equation: ``round_trip - |
| round_trip | Fiber propagation lower bound for the stated one-way distance. Equation: |
distance
Type: Quantity.
Declared default: required.
budget
Type: Optional[Quantity].
Declared default: None.
measured_round_trip
Type: Optional[Quantity].
Declared default: None.
round_trip
engine.scenario_types.PropagationScenario.round_trip
Fiber propagation lower bound for the stated one-way distance. Equation: mlsysim.physics.networking.calc_network_latency_ms(distance). Units: milliseconds; routing stretch, switching, and queueing are excluded.
overrun
engine.scenario_types.PropagationScenario.overrun
Amount by which propagation alone exceeds the latency budget. Equation: round_trip - budget. Units: milliseconds; a negative value means remaining budget, not negative latency.
measured_over_floor
engine.scenario_types.PropagationScenario.measured_over_floor
Observed round-trip latency relative to the modeled propagation floor. Equation: measured_round_trip / round_trip. Units: dimensionless; the observed value is an external input.