Prépare un bond hertzien : affaiblissement en espace libre, zone de Fresnel, marge d'évanouissement, pluie et disponibilité.
Ce programme planifie un bond hertzien. Il calcule l'affaiblissement en espace libre, la
première zone de Fresnel, le niveau reçu et la marge d'évanouissement. Il estime ensuite
l'affaiblissement dû à la pluie et la disponibilité du bond, et la compare à un objectif.
Aucun équipement n'est contacté.
Exécutez-le depuis ce dossier :
bogo run radio_link.bogo
bogo test radio_link.bogo
Pour l'utiliser sur votre propre bond, changez les champs en haut de la classe RadioLink : la
fréquence, la distance, la puissance d'émission, les gains d'antenne, la perte du câble
d'alimentation et la sensibilité du récepteur tirée de la fiche technique de la radio.
L'intensité de pluie et la latitude dépendent de l'endroit où se trouve le bond. Les valeurs du
programme (42 mm/h et 45 degrés) ne sont que des exemples. Prenez l'intensité de pluie R0.01 de
votre site dans les cartes de l'UIT-R P.837 ou dans des relevés locaux. Le résultat est une
estimation pour la pluie seulement. Il ne compte pas l'évanouissement par trajets multiples,
l'obstruction ni la panne de matériel.
radio_link.bogo
edition2027"""The plan of one microwave hop: free-space loss, link budget, fade margin and rain."""classRadioLink:
"""Checks one microwave hop against a target availability.
The rain rate and the latitude depend on where the hop is. The values below are
examples only: take the rain rate R0.01 for your site from the ITU-R P.837 maps or
from local records, and the latitude of your own hop.
"""
name = "site-a to site-b"
freq = 18GHz
distance = 12km
tx = 18dBm
antenna_a = 38dBi
antenna_b = 38dBi
feeder_loss = 2dB# waveguide and connectors, both ends together
sensitivity = -70dBm# receiver threshold of the chosen modulation
rain_rate = 42.0# EXAMPLE: mm/h passed for 0.01 percent of the year
latitude = 45.0# EXAMPLE: degrees, north or south
polarization = "vertical"
target = 99.99pct @staticmethoddef budget(distance: Distance, freq: Frequency) -> Budget:
losses: list[Gain] = [fspl(distance, freq), RadioLink.feeder_loss]
gains: list[Gain] = [RadioLink.antenna_a, RadioLink.antenna_b]
return link_budget(RadioLink.tx, gains, losses, RadioLink.sensitivity)
@staticmethoddef verdict(availability: Percent, target: Percent) -> str:
if availability >= target:
return"meets the target"return"misses the target" @staticmethoddef downtime_minutes(availability: Percent) -> float:
"""Minutes of rain outage in an average year."""return (100 - availability.value) / 100 * 365 * 24 * 60 @staticmethoddef main(args: list[str]) -> None:
r = RadioLink
b = r.budget(r.distance, r.freq)
fade = rain_fade(r.distance, r.freq, r.rain_rate, r.polarization)
print(f"Hop {r.name}: {r.distance} at {r.freq}, {r.polarization} polarization")
print(f" Free-space loss {fspl(r.distance, r.freq)}")
print(f" First Fresnel zone {fresnel(r.distance, r.freq)} radius at mid-hop")
print(f" Received level {b.rx}")
print(f" Fade margin {b.margin}")
print(f" Rain fade (0.01%) {fade} at {r.rain_rate} mm/h")
ifnot b.ok:
print(" The link does not close: no availability to compute.")
return
avail = rain_availability(
b.margin, r.distance, r.freq, r.rain_rate, r.polarization, latitude=r.latitude
)
minutes = r.downtime_minutes(avail)
print(f" Availability (rain) {avail}, about {minutes:.0f} min down a year")
print(f" Target {r.target}: the hop {r.verdict(avail, r.target)}")
classTestRadioLink:
def test_free_space_loss_matches_itu_formula(self) -> None:
# ITU-R P.525: 32.44 + 20 log10(18000 MHz) + 20 log10(1 km) = 117.55 dBassert abs(fspl(1km, 18GHz).value - 117.55) < 0.01def test_longer_hop_has_less_margin(self) -> None:
assertRadioLink.budget(20km, 18GHz).margin < RadioLink.budget(12km, 18GHz).margin
def test_verdict(self) -> None:
assertRadioLink.verdict(99.995pct, 99.99pct) == "meets the target"assertRadioLink.verdict(99.9pct, 99.99pct) == "misses the target"def test_downtime_of_three_nines(self) -> None:
assert round(RadioLink.downtime_minutes(99.9pct)) == 526