pcds (version 0.1.8)

arcsPEmid.int: The arcs of Proportional Edge Proximity Catch Digraph (PE-PCD) for 1D data - middle intervals case

Description

An object of class "PCDs". Returns arcs of PE-PCD as tails (or sources) and heads (or arrow ends) and related parameters and the quantities of the digraph. The vertices of the PE-PCD are the 1D data points in Xp in the middle interval case.

For this function, PE proximity regions are constructed with respect to the intervals based on Yp points with expansion parameter \(r \ge 1\) and centrality parameter \(c \in (0,1)\). That is, for this function, arcs may exist for points only inside the intervals. It also provides various descriptions and quantities about the arcs of the PE-PCD such as number of arcs, arc density, etc.

Vertex regions are based on center \(M_c\) of each middle interval. If there are duplicates of Yp points, only one point is retained for each duplicate value, and a warning message is printed.

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

Usage

arcsPEmid.int(Xp, Yp, r, c = 0.5)

Value

A list with the elements

type

A description of the type of the digraph

parameters

Parameters of the digraph, here, they are expansion and centrality parameters.

tess.points

Tessellation points, i.e., points on which the tessellation of the study region is performed, here, tessellation is the intervalization based on Yp points.

tess.name

Name of the tessellation points tess.points

vertices

Vertices of the digraph, i.e., Xp points

vert.name

Name of the data set which constitute the vertices of the digraph

S

Tails (or sources) of the arcs of PE-PCD for 1D data in the middle intervals

E

Heads (or arrow ends) of the arcs of PE-PCD for 1D data in the middle intervals

mtitle

Text for "main" title in the plot of the digraph

quant

Various quantities for the digraph: number of vertices, number of partition points, number of intervals, number of arcs, and arc density.

Arguments

Xp

A set or vector of 1D points which constitute the vertices of the PE-PCD.

Yp

A set or vector of 1D points which constitute the end points of the intervals.

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)\).

Author

Elvan Ceyhan

References

See Also

arcsPEend.int, arcsPE1D, arcsCSmid.int, arcsCSend.int and arcsCS1D

Examples

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

#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)
Xp<-runif(nx,a,b)
Yp<-runif(ny,a,b)

Arcs<-arcsPEmid.int(Xp,Yp,r,c)
Arcs
summary(Arcs)
plot(Arcs)

S<-Arcs$S
E<-Arcs$E

arcsPEmid.int(Xp,Yp,r,c)
arcsPEmid.int(Xp,Yp+10,r,c)

jit<-.1
yjit<-runif(nx,-jit,jit)

Xlim<-range(Xp,Yp)
xd<-Xlim[2]-Xlim[1]

plot(cbind(a,0),
main="arcs of PE-PCD for points (jittered along y-axis)\n in middle intervals ",
xlab=" ", ylab=" ", xlim=Xlim+xd*c(-.05,.05),ylim=3*c(-jit,jit),pch=".")
abline(h=0,lty=1)
points(Xp, yjit,pch=".",cex=3)
abline(v=Yp,lty=2)
arrows(S, yjit, E, yjit, length = .05, col= 4)
# }