clutter_imt#

pycraf.pathprof.clutter_imt(freq, dist, location_percent, num_end_points=1)[source]#

Calculate the Clutter loss according to IMT.CLUTTER document (method 2).

Parameters:

freqQuantity

Frequency of radiation [GHz]

Distance between Tx/Rx antennas [km]

Minimal distance must be 0.25 km (single endpoint clutter) or 1 km (if both endpoints are to be corrected for clutter)

location_percentQuantity

Percentage of locations for which the clutter loss L_clutter (calculated with this function) will not be exceeded [%]

num_end_pointsint, optional

number of endpoints affected by clutter, allowed values: 1, 2

Returns:

Notes

The algorithm is independent of effective antenna height (w.r.t. clutter height), i.e., it doesn’t distinguish between terminals which are close to the ground and those closer to the top of the building. However, the model is only appropriate if the terminal is “in the clutter”, below the rooftops.
The result of this function is to be understood as a cumulative value. For example, if location_percent = 2%, it means that for 2% of all possible locations, the clutter loss will not exceed the returned L_clutter value, for the remaining 98% of locations it will therefore be lower than L_clutter. The smaller location_percent, the smaller the returned L_clutter, i.e., low clutter attenuations are more unlikely.
This model was proposed by ITU study group SG 3 to replace clutter_correction for IMT 5G studies (especially, at higher frequencies, where multipath effects play a role in urban and suburban areas).