DataAvailability: Function for plotting data availability of commercial...

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

Function for plotting data availability of commercial microwave link network.

Description

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

1. Bar plot with percentage of sub-links for bins of data availability (

2. Bar plot with percentage of link paths for bins of data availability (

3. Plot with average number of sub-links and link paths for each time interval of the sampling strategy.

In addition, the Average number of sub-links and link paths is printed to the screen.

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.

Data availability is computed over the number of time intervals in the dataset as obtained from DateTime. In case a time interval is missing, i.e. not present in DateTime, it is not included in the computations. Hence, the computed availability does only refer to the time intervals for which a DateTime entry is present in the dataset. In the computation of availabilities only links or paths are counted as available in case the link-derived rainfall intensities are equal to or larger than 0 (mm h^{-1}). I.e., NA values in Rmean are taken into account in the computation of data availability. So data availability is always computed over all time intervals in DateTime. Note that NA values do not exist in the DateTime object if function ”PreprocessingMinMaxRSL” has been run and note that Data must be preprocessed, because Rmean is used.

Usage

DataAvailability(
  Data,
  cex.axis,
  cex.lab,
  FigNameBarplotAvailabilityLinks,
  FigNameBarplotAvailabilityLinkPaths,
  FigNameTimeseriesAvailability,
  ps,
  Rmean,
  TimeZone = "UTC",
  verbose = TRUE
)

Arguments

Data	Data frame with microwave link data (use data(Linkdata) to load example data).
cex.axis	The magnification to be used for axis annotation relative to the current setting of ”cex” in file FigNameTimeseriesAvailability.
cex.lab	The magnification to be used for x and y labels relative to the current setting of ”cex” in file FigNameTimeseriesAvailability.
FigNameBarplotAvailabilityLinks	Name of file with bar plot with percentage of links for bins of link orientation. The extension must be ”.pdf”.
FigNameBarplotAvailabilityLinkPaths	Name of file with bar plot with percentage of links for bins of link path length. The extension must be ”.pdf”.
FigNameTimeseriesAvailability	Name of file with bar plot with percentage of links for bins of microwave frequency. The extension must be ”.pdf”.
ps	integer; the point size of text (but not symbols) in file FigNameTimeseriesAvailability.
Rmean	Vector of link-derived rainfall intensities (mm h^{-1}) with length equal to Data.
TimeZone	Time zone of data (e.g. "UTC").

Value

Figures with data availability 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)
DataAvailability(Data=Linkdata,cex.axis=0.9,cex.lab=1.15,
FigNameBarplotAvailabilityLinks="Barplot_Availability_Links.pdf",
FigNameBarplotAvailabilityLinkPaths="Barplot_Availability_LinkPaths.pdf",
FigNameTimeseriesAvailability="TimeseriesAvailability.pdf",ps=18,Rmean=Rmean,TimeZone="UTC")

overeem11/RAINLINK documentation built on July 8, 2023, 5:53 a.m.