circular_angular_spread#

sionna.phy.channel.tr38901.circular_angular_spread(angles, powers, precision: Literal['single', 'double'] | None = None, device: str | None = None) → torch.Tensor[source]#

Computes circular angular spread using the Annex A phasor formula.

For angles \(\phi_n\) in radians and linear powers \(P_n\), define normalized powers \(p_n=P_n/\sum_m P_m\) and

\[R = \left|\sum_n p_n e^{j\phi_n}\right|.\]

The circular angular spread is

\[\sigma_\phi = \sqrt{-2\ln(R)}.\]

This is the angular-spread definition from Annex A.1, Eq. (A-1), of [TR38901V1920], which follows [TR25996]. It differs from a wrapped RMS spread around the circular mean.

Parameters:

  • angles – Angles [radian] with shape [..., num_angles].

  • powers – Linear powers with shape [..., num_angles].

  • precision (Literal['single', 'double'] | None) – Precision used for internal calculations and outputs. If set to None, precision is used.

  • device (str | None) – Device for computation. If None, device is used.

Outputs:

angular_spread – Circular angular spread [radian] with shape [...].