Cluster Delay Line Realization#

class ClusterDelayLineRealization(alpha_device, beta_device, gain, line_of_sight, rice_factor, azimuth_of_arrival, zenith_of_arrival, azimuth_of_departure, zenith_of_departure, cluster_delays, cluster_delay_spread, cluster_powers, polarization_transformations, interpolation_mode=InterpolationMode.NEAREST)[source]#

Bases: ChannelRealization, Visualizable

Realization of a 3GPP Cluster Delay Line channel model.

Parameters:

  • alpha_device (Device) – First device linked by the Channel instance that generated this realization.

  • beta_device (Device) – Second device linked by the Channel instance that generated this realization.

  • gain (float) – Linear power gain factor a signal experiences when being propagated over this realization.

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

classmethod From_HDF(group, alpha_device, beta_device)[source]#

De-Serialized the object state from HDF5.

Recalls the object’s state from a HDF5 group.

Parameters:

  • group (h5py.Group) – The HDF5 group from which the object state is recalled.

  • alpha_device (Device) – First device linked by the Channel instance that generated this realization.

  • beta_device (Device) – Second device linked by the Channel instance that generated this realization.

Return type:

ClusterDelayLineRealization

Returns: The object initialized from the HDF5 group state.

plot_angles(title=None, center_los=True)[source]#
Return type:

Figure

plot_power_delay(title=None)[source]#
Return type:

Figure

plot_rays(title=None)[source]#
Return type:

Figure

state(transmitter, receiver, delay_offset, 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:

  • transmitter (Device) – Device transmitting the signal for which the channel state information is generated.

  • receiver (Device) – Device receiving the signal for which the channel state information is generated.

  • 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.

to_HDF(group)[source]#

Serialize the object state to HDF5.

Dumps the object’s state and additional information to a HDF5 group.

Parameters:

group (Group) – The HDF5 group to which the object is serialized.

Return type:

None

property azimuth_arrival_spread: float#

Spread of azimuth of arrival angles.

Returns: Angular spread in radians.

property azimuth_departure_spread: float#

Spread of azimuth of departure angles.

Returns: Angular spread in radians.

property azimuth_of_arrival: ndarray#

Azimuth of arrival angles in radians.

property azimuth_of_departure: ndarray#

Azimuth of departure angles in radians.

property cluster_delay_spread: float#

Cluster delay spread in seconds.

property cluster_delays: ndarray#

Cluster delays in seconds.

property cluster_powers: ndarray#

Cluster powers.

property line_of_sight: bool#

Does the realization include direct line of sight between the two devices?

property max_delay: float#

Maximum expected delay in seconds.

property num_clusters: int#

Number of realized scatter clusters.

property num_rays: int#

Number of rays within each cluster.

property polarization_transformations: ndarray#

Polarization transformations.

property rice_factor: float#

Rice factor.

property zenith_arrival_spread: float#

Spread of zenith of arrival angles.

Returns: Angular spread in radians.

property zenith_departure_spread: float#

Spread of zenith of departure angles.

Returns: Angular spread in radians.

property zenith_of_arrival: ndarray#

Zenith of arrival angles in radians.

property zenith_of_departure: ndarray#

Zenith of departure angles in radians.