wradlib.vis.VisMethods.plot_beamblockage

VisMethods.plot_beamblockage(**kwargs)

Visualize terrain-induced radar beam blockage.

This function creates a three-panel overview of beam blockage effects for a radar sweep. The first panel shows the digital elevation model (DEM) and the selected radar ray, the second panel displays the cumulative beam blockage fraction (CBB) over the sweep, and the third panel shows a vertical profile along the selected ray including terrain, beam geometry, and cumulative beam blockage.

Parameters:

swp (xarray.Dataset) – Radar sweep dataset containing the interpolated DEM, beam height, and cumulative beam blockage fields. The dataset is expected to provide the variables DEM, CBB, and z as well as the coordinates range, azimuth, x, and y.

Other Parameters:

• figsize (tuple, optional) – Figure size passed to matplotlib. Defaults to (15, 12).

• angle (float, optional) – Azimuth angle in degrees used to select the ray for the terrain profile. The nearest available azimuth is used. Defaults to 0.

• bw (float, optional) – Radar beam width in degrees used to calculate the half-power beam radius. Defaults to 1.0.

• xlim (tuple, optional) – Range limits for the profile plot in metres. Defaults to the full sweep range.

• ylim (tuple, optional) – Height limits for the profile plot in metres. Defaults to (0, 3000).

Returns:

matplotlib.figure.Figure – The created figure.

Notes

The beam blockage fraction is computed following the methodology of Bech et al.