pcds (version 0.1.8)

plotPEregs.int: The plot of the Proportional Edge (PE) Proximity Regions for a general interval (vertices jittered along \(y\)-coordinate) - one interval case

Description

Plots the points in and outside of the interval int and also the PE proximity regions (which are also intervals). PE proximity regions are constructed with expansion parameter \(r \ge 1\) and centrality parameter \(c \in (0,1)\).

For better visualization, a uniform jitter from \(U(-Jit,Jit)\) (default is \(Jit=.1\)) times range of proximity regions and Xp) is added to the \(y\)-direction. If there are duplicates of Xp points, only one point is retained for each duplicate value, and a warning message is printed. center is a logical argument, if TRUE, plot includes the center of the interval as a vertical line in the plot, else center of the interval is not plotted.

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

Usage

plotPEregs.int(
  Xp,
  int,
  r,
  c = 0.5,
  Jit = 0.1,
  main = NULL,
  xlab = NULL,
  ylab = NULL,
  xlim = NULL,
  ylim = NULL,
  center = FALSE,
  ...
)

Value

Plot of the PE proximity regions for 1D points in or outside the interval int

Arguments

Xp

A set of 1D points for which PE proximity regions are to be constructed.

int

A vector of two real numbers representing an interval.

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 int\(=(a,b)\) with the default c=.5. For the interval, int\(=(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.

center

A logical argument, if TRUE, plot includes the center of the interval as a vertical line in the plot, else center of the interval is not plotted.

...

Additional plot parameters.

Author

Elvan Ceyhan

References

See Also

plotPEregs1D, plotCSregs.int, and plotCSregs.int

Examples

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

n<-10
xf<-(int[2]-int[1])*.1
Xp<-runif(n,a-xf,b+xf)  #try also Xp<-runif(n,a-5,b+5)
plotPEregs.int(Xp,int,r,c,xlab="x",ylab="")

plotPEregs.int(7,int,r,c,xlab="x",ylab="")
# }