plotPEarcs.int: The plot of the arcs of Proportional Edge Proximity Catch...

In elvanceyhan/pcds: Proximity Catch Digraphs and Their Applications

The plot of the arcs of Proportional Edge Proximity Catch Digraphs (PE-PCDs) for 1D data (vertices jittered along y-coordinate) - one interval case

Description

Plots the arcs of PE-PCD whose vertices are the 1D points, Xp. PE proximity regions are constructed with expansion parameter r \ge 1 and centrality parameter c \in (0,1) and the intervals are based on the interval int=(a,b) That is, data set Xp constitutes the vertices of the digraph and int determines the end points of the interval.

For better visualization, a uniform jitter from U(-Jit,Jit) (default for Jit=.1) is added to the y-direction where Jit equals to the range of \{Xp, int\} multiplied by Jit with default for Jit=.1). center is a logical argument, if TRUE, plot includes the center of the interval int as a vertical line in the plot, else center of the interval is not plotted.

See also (\insertCiteceyhan:metrika-2012;textualpcds).

Usage

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

Arguments

Xp	A vector of 1D points constituting the vertices of the PE-PCD.
int	A vector of two 1D points constituting the end points of the 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 of the interval 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 range of \{Xp, int\} multiplied by Jit).
main	An overall title for the plot (default=NULL).
xlab, ylab	Titles of the x and y axes in the plot (default=NULL for both).
xlim, ylim	Two numeric vectors of length 2, giving the x- and y-coordinate ranges (default=NULL for both).
center	A logical argument, if TRUE, plot includes the center of the interval int as a vertical line in the plot, else center of the interval is not plotted.
...	Additional plot parameters.

Value

A plot of the arcs of PE-PCD whose vertices are the 1D data set Xp in which vertices are jittered along y-axis for better visualization.

Author(s)

Elvan Ceyhan

References

\insertAllCited

See Also

plotPEarcs1D and plotCSarcs.int

Examples

## Not run: 
r<-2
c<-.4
a<-0; b<-10; int<-c(a,b)

#n is number of X points
n<-10;  #try also n<-20;

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

Xp<-runif(n,a-xf,b+xf)

Xlim=range(Xp,int)
Ylim=.1*c(-1,1)

jit<-.1
set.seed(1)
plotPEarcs.int(Xp,int,r=1.5,c=.3,jit,xlab="",ylab="",center=TRUE)
set.seed(1)
plotPEarcs.int(Xp,int,r=2,c=.3,jit,xlab="",ylab="",center=TRUE)

## End(Not run)

elvanceyhan/pcds documentation built on June 29, 2023, 8:12 a.m.