Topology: Function for plotting characteristics of topology of...

In overeem11/RAINLINK: Retrieval algorithm for rainfall mapping from microwave links in a cellular communication network.

Function for plotting characteristics of topology of commercial microwave link network.

Description

Function for plotting characteristics of topology of commercial microwave link data. This function provides the following figures:

1. Bar plot with percentage of links for bins of link path length (km).

2. Bar plot with percentage of links for bins of microwave frequency (GHz).

3. Bar plot with percentage of links for bins of orientation (degrees).

4. Scatter plot of microwave frequency (GHz) versus link path length (km).

5. Scatter density plot of microwave frequency (GHz) versus link path length (km).

Does not depend on sampling strategy.

The input microwave link data do not have to be sorted chronologically. Full-duplex links will give two data entries, these will both be used.

The computed percentages in the bar plots are only based on the range of classes presented in the bar plots, i.e. data outside these classes are not used in the computations.

When Rmean is provided, all figures are only based on data where the link-derived rainfall intensities are equal to or larger than 0 mm h^{-1}. Note that Data object must be preprocessed by function ”PreprocessingMinMaxRSL” if Rmean is provided.

Usage

Topology(
  Data,
  FigNameBarplotAngle,
  FigNameBarplotFrequency,
  FigNameBarplotPathLength,
  FigNameFrequencyVsPathLength,
  FigNameScatterdensityplotFrequencyVsPathLength,
  InputCoorSystem,
  LocalCartesianCoorSystem,
  Maxf,
  Minf,
  MaxL,
  MinL,
  Rmean = NULL,
  Stepf,
  StepL,
  MaxPercFrequency,
  MaxPercOrientation,
  MaxPercPathLength,
  PlotTitleTopology,
  verbose = TRUE
)

Arguments

Data	Data frame with microwave link data (use data(Linkdata) to load example data).
FigNameBarplotAngle	Name of file with bar plot with percentage of links for bins of link orientation. The extension must be ”.pdf”.
FigNameBarplotFrequency	Name of file with bar plot with percentage of links for bins of link path length. The extension must be ”.pdf”.
FigNameBarplotPathLength	Name of file with bar plot with percentage of links for bins of microwave frequency. The extension must be ”.pdf”.
FigNameFrequencyVsPathLength	Name of file with scatter plot of microwave frequency versus link path length. The extension must be ”.pdf”.
FigNameScatterdensityplotFrequencyVsPathLength	Name of file with scatter density plot of microwave frequency versus link path length. The extension must be ”.pdf”.
InputCoorSystem	Define EPSG code for input coordinate system (e.g., 4326L for WGS84 in degrees).
LocalCartesianCoorSystem	Define EPSG code for (local) Cartesian coordinate system (meters).
Maxf	Maximum microwave frequency to be plotted in bar plot (GHz). This is the value where the last bin class ends.
Minf	Minimum microwave frequency to be plotted in bar plot (GHz). This is the value where the first bin class ends.
MaxL	Maximum link path length to be plotted in bar plot (km). This is the value where the last bin class ends.
MinL	Minimum link path length to be plotted in bar plot (km). This is the value where the first bin class ends.
MaxPercFrequency	Maximum percentage on scale for bar plot of microwave frequency.
MaxPercOrientation	Maximum percentage on scale for bar plot of orientation.
MaxPercPathLength	Maximum percentage on scale for bar plot of path length.
PlotTitleTopology	Title of plots (e.g., which CML vendor or period).
Rmean	Vector of link-derived rainfall intensities (mm h^{-1}) with length equal to Data.
Stepf	Bin size of microwave frequency classes for bar plot in GHz.
StepL	Bin size of link path length classes for bar plot in km.

Value

Figures with characteristics of topology of commercial microwave link network.

Author(s)

Aart Overeem

References

”ManualRAINLINK.pdf”

Overeem, A., Leijnse, H., and Uijlenhoet, R., 2016: Retrieval algorithm for rainfall mapping from microwave links in a cellular communication network, Atmospheric Measurement Techniques, 9, 2425-2444, https://doi.org/10.5194/amt-9-2425-2016.

Examples

data(Linkdata)
Topology(Data=Linkdata,FigNameBarplotAngle="Barplot_Orientation.pdf",
FigNameBarplotFrequency="Barplot_Frequency.pdf",FigNameBarplotPathLength="Barplot_PathLength.pdf",
FigNameFrequencyVsPathLength="Frequency_vs_PathLength.pdf",
FigNameScatterdensityplotFrequencyVsPathLength="ScatterdensityPlot_Frequency_vs_PathLength.pdf",
InputCoorSystem=4326L,LocalCartesianCoorSystem=28992,
Maxf=40,Minf=13,MaxL=21,MinL=1,Rmean=Rmean,Stepf=1.5,StepL=2,MaxPercFrequency=40,
MaxPercOrientation=7,MaxPercPathLength=30,PlotTitleTopology="Topology")

overeem11/RAINLINK documentation built on June 29, 2024, 7:41 a.m.