pcds (version 0.1.8)

plotPEregs1D: The plot of the Proportional Edge (PE) Proximity Regions (vertices jittered along \(y\)-coordinate) - multiple interval case

Description

Plots the points in and outside of the intervals based on Yp points and also the PE proximity regions (i.e., intervals). PE proximity region is constructed with expansion parameter \(r \ge 1\) and centrality parameter \(c \in (0,1)\). If there are duplicates of Yp or Xp points, only one point is retained for each duplicate value, and a warning message is printed.

For better visualization, a uniform jitter from \(U(-Jit,Jit)\) (default is \(Jit=.1\)) times range of Xp and Yp and the proximity regions (intervals)) is added to the \(y\)-direction.

centers is a logical argument, if TRUE, plot includes the centers of the intervals as vertical lines in the plot, else centers of the intervals are not plotted.

See also (ceyhan:metrika-2012;textualpcds).

Usage

plotPEregs1D(
  Xp,
  Yp,
  r,
  c = 0.5,
  Jit = 0.1,
  main = NULL,
  xlab = NULL,
  ylab = NULL,
  xlim = NULL,
  ylim = NULL,
  centers = FALSE,
  ...
)

Value

Plot of the PE proximity regions for 1D points located in the middle or end-intervals based on Yp points

Arguments

Xp

A set of 1D points for which PE proximity regions are plotted.

Yp

A set of 1D points which constitute the end points of the intervals which partition the real line.

r

A positive real number which serves as the expansion parameter in PE proximity region; must be \(\ge 1\).

c

A positive real number in \((0,1)\) parameterizing the center inside middle intervals with the default c=.5. For the interval, \((a,b)\), the parameterized center is \(M_c=a+c(b-a)\).

Jit

A positive real number that determines the amount of jitter along the \(y\)-axis, default=0.1 and Xp points are jittered according to \(U(-Jit,Jit)\) distribution along the \(y\)-axis where Jit equals to the range of the union of Xp and Yp points multiplied by Jit).

main

An overall title for the plot (default=NULL).

xlab, ylab

Titles for the \(x\) and \(y\) axes, respectively (default=NULL for both).

xlim, ylim

Two numeric vectors of length 2, giving the \(x\)- and \(y\)-coordinate ranges (default=NULL for both).

centers

A logical argument, if TRUE, plot includes the centers of the intervals as vertical lines in the plot, else centers of the intervals are not plotted (default is FALSE).

...

Additional plot parameters.

Author

Elvan Ceyhan

References

See Also

plotPEregs1D, plotCSregs.int, and plotCSregs1D

Examples

# \donttest{
r<-2
c<-.4
a<-0; b<-10; int<-c(a,b);

#nx is number of X points (target) and ny is number of Y points (nontarget)
nx<-15; ny<-4;  #try also nx<-40; ny<-10 or nx<-1000; ny<-10;

set.seed(1)
xf<-(int[2]-int[1])*.1

Xp<-runif(nx,a-xf,b+xf)
Yp<-runif(ny,a,b)

plotPEregs1D(Xp,Yp,r,c,xlab="x",ylab="")
# }