Multipath Fading Sample

Inheritance diagram of hermespy.channel.fading.fading.MultipathFadingSample
class MultipathFadingSample(power_profile, delay_profile, los_angles, nlos_angles, los_phases, nlos_phases, los_gains, nlos_gains, los_doppler, nlos_doppler, spatial_response, gain, state)[source]

Bases: ChannelSample

Immutable sample of a statistical multipath fading channel.

Generated by the sample() routine of a MultipathFadingRealization.

Parameters:
  • transmitter_state (DeviceState) – State of the transmitting device at the time of sampling.

  • receiver_state (DeviceState) – State of the receiving device at the time of sampling.

  • carrier_frequency (float) – Carrier frequency of the channel in Hz.

  • bandwidth (float) – Bandwidth of the propagated signal in Hz.

  • path_realizations (Sequence[PathRealization]) – Realizations of the individual propagation paths.

  • spatial_response (numpy.ndarray) – Spatial response matrix of the channel realization considering alpha_device is the transmitter and beta_device is the receiver.

  • interpolation_mode (InterpolationMode, optional) – Interpolation behaviour of the channel realization’s delay components with respect to the proagated signal’s sampling rate.

plot_power_delay(axes=None)[source]
Return type:

Tuple[Figure, NDArray[Shape[*, *], Any]]

state(num_samples, max_num_taps, interpolation_mode=InterpolationMode.NEAREST)[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:
  • 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.

  • 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, an integer rounding to the nearest sampling instance will be assumed.

Return type:

ChannelStateInformation

Returns: The channel state information representing this channel realization.

property delay_profile: ndarray

Delay in seconds of each individual multipath tap.

property expected_energy_scale: float

Expected linear scaling of a propagated signal’s energy at each receiving antenna.

Required to compute the expected energy of a signal after propagation, and therfore signal-to-noise ratios (SNRs) and signal-to-interference-plus-noise ratios (SINRs).

property gain: float

Linear energy gain factor a signal experiences when being propagated over this realization.

property los_angles: ndarray

Angle of arrival of the line-of sight components.

property los_doppler: float

Doppler frequency shift of the line-of sight components.

property los_gains: ndarray

Gain factors of the line-of sight components.

property los_phases: ndarray

Phase of the line-of sight components.

property nlos_angles: ndarray

Angle of arrival of the non-line-of sight components.

property nlos_doppler: float

Doppler frequency shift of the non-line-of sight components.

property nlos_gains: ndarray

Gain factors of the non-line-of sight components.

property nlos_phases: ndarray

Phase of the non-line-of sight components.

property power_profile: ndarray

Power loss factor of each individual multipath tap.

property spatial_response: ndarray

Spatial response matrix of the channel realization considering alpha_device is the transmitter and beta_device is the receiver.