Physical Scenario Dummy

class PhysicalScenarioDummy(seed=None, devices=None)

Bases: SimulationScenario, PhysicalScenario[PhysicalDeviceDummy], Serializable

Physical scenario for testing and demonstration.

Parameters:

• default_channel (Channel, optional) – Default channel model to be assumed for all device links. If not specified, the default_channel is set to an ideal distortionless channel model.

• noise_level (NoiseLevel, optional) – Global noise level of the scenario assumed for all devices. If not specified, the noise configuration is device-specific.

• noise_model (NoiseModel, optional) – Global noise model of the scenario assumed for all devices. If not specified, the noise configuration is device-specific.

add_device(device)

Add a new device to the scenario.

Parameters:

device (Device) – New device to be added to the scenario.

Raises:

• ValueError – If the device already exists.

• RuntimeError – If the scenario is not in default mode.

Return type:

None

new_device(*args, **kwargs)

Add a new device to the simulation scenario.

Returns:

Newly added simulated device.

Return type:

SimulatedDevice

receive_devices(impinging_signals=None, states=None, notify=True, trigger_realizations=None, leaking_signals=None)

Receive over all simulated scenario devices.

Internally calls SimulationScenario.process_inputs() and Scenario.receive_operators().

Parameters:

• impinging_signals (list[Union[DeviceInput, Signal, Iterable[Signal]]]) – List of signals impinging onto the devices.

• states (Sequence[SimulatedDeviceState | None], optional) – Sequence of simulated device states at the time of signal impingement. If not specified, the device states are assumed to be at the initial state.

• notify (bool, optional) – Notify the receiving DSP layer’s callbacks about the reception results. Enabled by default.

• trigger_realizations (Sequence[TriggerRealization], optional) – Sequence of trigger realizations. If not specified, ideal triggerings are assumed for all devices.

• leaking_signals (Sequence[Signal] | Sequence[Sequence[Signal]], optional) – Signals leaking from transmit to receive chains within the individual devices. If not specified, no leakage is assumed.

Return type:

Sequence[SimulatedDeviceReception]

Returns: list of the processed device input information.

Raises:

ValueError – If the number of impinging_signals does not match the number of registered devices.