imt2020_composite_pattern_extended#

pycraf.antenna.imt2020_composite_pattern_extended(azim, elev, azim_i, elev_i, G_Emax, A_m, SLA_nu, phi_3db, theta_3db, d_H, d_V, d_V_sub, N_H, N_V, M_sub, theta_subtilt, rho=<Quantity 1.>, k=12.0)[source]#

Extended composite (array) antenna pattern according to R19-WP5D-C-0716 document, which is an extension of the composite pattern introduced in Rec. ITU-R M.2101-0.

This allows for sub-arrays, with pre-configured electronic phasing, which are usually used for electronic downtilt.

Parameters:
azim, elevQuantity

Azimuth/Elevation [deg]

azim_i, elev_iQuantity

Azimuthal/Elevational pointing of beam i [deg]

G_EmaxQuantity

Single element maximum gain [dBi]

A_m, SLA_nuQuantity

Front-to-back ratio (horizontal/vertical) [dB]

phi_3db, theta_3dbQuantity

Horizontal/Vertical 3dB beam width of single element [deg]

d_H, d_VQuantity

Horizontal/Vertical separation of sub-arrays in units of wavelength [dimless]

d_V_subQuantity

Vertical separation of beams in sub-arrays in units of wavelength [dimless]

N_H, N_Vint

Horizontal/Vertical number of sub-arrays

M_subint

Number of single antenna elements in each sub-array

theta_subtiltQuantity

Pre-configured electronic downtilt for the sub-arrays [deg]

rhoQuantity, optional

Correlation level (see 3GPP TR 37.840, 5.4.4.1.4, default: 1) [dimless]

kfloat, optional

Multiplication factor, can be used to get better match to measured antenna patters (default: 12). See WP5D-C-0936

Returns:
A_AQuantity

Composite (array) antenna pattern of beam i [dB]

Notes

Further information can be found in 3GPP TR 37.840 Section 5.4.4.

According to document WP5D-C-0936 the AAS pattern can still be subject to quite effective beamforming in the spurious domain. For such cases, one can simply change the d_H and d_V to fit to the out-of-band frequency, i.e., d_oob = f_oob / f * d. For example, if f = 26 GHz, f_oob = 23.8 GHz, and d = 0.5 then d_oob = 0.46. However, to match measurements, also a different k-factor should be used, i.e., 8 instead of 12.

The pre-configured electronic phasing of the sub-arrays can lead to less optimal results for the pattern quality if the theta_Etilt (=-elev_i) parameter doesn’t match theta_subarray.