Configuration Types

Timeline, physical-layer, and satellite-link configuration.

SimulationConfig

Simulation timeline configuration.

SimulationConfig(
    total_time_cutoff_ms: float = 5000.0,
    step_resolution_ms: float = 0.1,
    physical: PhysicalConfig = ...,
)

Field	Type	Default	Description
`total_time_cutoff_ms`	`float`	`5000.0`	Maximum simulation wall-clock time (ms)
`step_resolution_ms`	`float`	`0.1`	Event scheduler tick size (ms)
`physical`	`PhysicalConfig`	(required)	Physical-layer constants

Physical layer constants for link loss and propagation models.

PhysicalConfig(alpha_loss_db_km: Optional[float] = None)

Field	Type	Default	Description
`alpha_loss_db_km`	`float`	`0.22`	Fiber attenuation in dB/km (standard telecom fiber ≈ 0.22 dB/km at 1550 nm)

Derived constants (not configurable): baseline_purify_factor ≈ alpha/10, speed_of_light_in_fiber_km_ms = 200.0.

Atmospheric conditions helper for satellite links.

SatelliteConditions(
    visibility: float = 1.0,
    weather_factor: float = 1.0,
)

Field	Type	Default	Description
`visibility`	`float`	`1.0`	Atmospheric visibility (0–1)
`weather_factor`	`float`	`1.0`	Weather attenuation multiplier

Method:

Method	Signature	Description
`effective_rate(base_rate: float)`	`-> float`	Returns `base_rate * visibility * weather_factor`