Directive Channel Realization#

class DirectiveChannelRealization(transmitter, receiver, realization)[source]#

Bases: Generic[CRT]

Channel realization with specified directivity.

Generated by realization property of ChannelPropagations.

Parameters:

  • transmitter (Device) – Device transmitting into the realized channel model. Initializes the transmitter attribute.

  • receiver (Device) – Device receiving from the realized channel model. Initializes the receiver attribute.

  • realization (CRT) – Realization of the channel linked by transmitter and receiver. Initializes the realization attribute.

propagate(signal, interpolation_mode=None)[source]#

Propagate a signal model over this realization.

Let

\[\mathbf{X} = \left[ \mathbf{x}^{(0)}, \mathbf{x}^{(1)},\, \dots,\, \mathbf{x}^{(M_\mathrm{Tx} - 1)} \right] \in \mathbb{C}^{N_\mathrm{Tx} \times M_\mathrm{Tx}}\]

be the signal transmitted by transmitter and

\[\mathbf{Y} = \left[ \mathbf{y}^{(0)}, \mathbf{y}^{(1)},\, \dots,\, \mathbf{x}^{(M_\mathrm{Rx} - 1)} \right] \in \mathbb{C}^{N_\mathrm{Rx} \times M_\mathrm{Rx}}\]

the reception of receiver, this method implements the channel propagation equation

\[\mathbf{y}^{(m)} = \sum_{\tau = 0}^{M_\mathrm{Rx} - M_\mathrm{Tx}} \mathbf{H}^{(m, \tau)} \mathbf{x}^{(m-\tau)} \ \text{.}\]
Parameters:

  • signal (DeviceOutput | Signal) – Signal model to be propagated.

  • interpolation_mode (InterpolationMode, optional) – Interpolation behaviour of the channel realization’s delay components with respect to the proagated signal’s sampling rate. If not specified, the realization’s initialization value will be assumed.

Return type:

ChannelPropagation[TypeVar(CRT, bound= ChannelRealization)]

Returns: All information generated by the propagation.

state(delay, sampling_rate, num_samples, max_num_taps)[source]#

Generate the discrete channel state information from this channel realization.

Denoted by

\[\mathbf{H}^{(m, \tau)} \in \mathbb{C}^{N_{\mathrm{Rx}} \times N_{\mathrm{Tx}}}\]

within the respective equations.

Parameters:

  • delay (float) – Delay in seconds at which the state information should be generated.

  • sampling_rate (float) – Sampling rate of the state information’s discrete samples in \(\mathrm{Hz}\).

  • num_samples (int) – Number of discrete time-domain samples of the chanel state information.

  • max_num_taps (int) – Maximum number of delay taps considered per discrete time-domain sample.

Return type:

ChannelStateInformation

Returns: The channel state information representing this channel realization.

property realization: CRT#

Wrapped non-directive channel realization.

property receiver: Device#

Device receiving from the realized channel model.

property transmitter: Device#

Device transmitting into the realized channel model.