OversubscriptionScenario
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 ring AllReduce whose edges all cross the bisection of fleet, at 1:1 and at oversubscription_ratio.
Notes
Equation: Compose mlsysim.solvers.BisectionModel.
Assumptions: The stated fields are inputs to mlsysim.solvers.BisectionModel; its documented validity regime, units, and modeling choices apply unchanged.
Excludes: This scenario adds no measurement, empirical calibration, or mechanisms beyond mlsysim.solvers.BisectionModel.
References
Derivation: this scenario binds its input fields to the referenced implementation contracts: mlsysim.solvers.BisectionModel. The methods below identify any additional arithmetic.
Examples
>>> from mlsysim import Scenarios
>>> case = Scenarios.RingAllReduceAcross4to1Spine
>>> type(case.result).__name__
'BisectionResult'Attributes
| Name | Description |
|---|---|
| cluster_cost | |
| communication_fraction | |
| fleet | |
| link_bandwidth | |
| oversubscription_ratio | |
| payload_per_device | |
| result | Evaluate this scenario through mlsysim.solvers.BisectionModel.solve. Equation: pass |
fleet
Type: Fleet.
Declared default: required.
link_bandwidth
Type: Quantity.
Declared default: required.
oversubscription_ratio
Type: float.
Declared default: required.
payload_per_device
Type: Quantity.
Declared default: required.
communication_fraction
Type: float.
Declared default: required.
cluster_cost
Type: Quantity.
Declared default: required.
result
engine.scenario_types.OversubscriptionScenario.result
Evaluate this scenario through mlsysim.solvers.BisectionModel.solve. Equation: pass the stated fields to that implementation; its contract defines the calculation and feasibility tests. Units: each returned field follows the referenced result schema; no independent equation is evaluated by this wrapper.