Idom.num3PEtetra: The indicator for three 3D points constituting a dominating...

In elvanceyhan/pcds: Proximity Catch Digraphs and Their Applications

The indicator for three 3D points constituting a dominating set for Proportional Edge Proximity Catch Digraphs (PE-PCDs) - one tetrahedron case

Description

Returns I(\{p1,p2,pt3} is a dominating set of the PE-PCD) where the vertices of the PE-PCD are the 3D data set Xp in the tetrahedron th, that is, returns 1 if {p1,p2,pt3} is a dominating set of PE-PCD, returns 0 otherwise.

Point, p1, is in the region of vertex rv1 (default is NULL), point, p2, is in the region of vertex rv2 (default is NULL); point, pt3), is in the region of vertex rv3) (default is NULL); vertices (and hence rv1, rv2 and rv3) are labeled as 1,2,3,4 in the order they are stacked row-wise in th.

PE proximity region is constructed with respect to the tetrahedron th with expansion parameter r \ge 1 and vertex regions are based on center of mass CM (equivalent to circumcenter in this case).

ch.data.pnts is for checking whether points p1, p2 and pt3 are all data points in Xp or not (default is FALSE), so by default this function checks whether the points p1, p2 and pt3 would constitute a dominating set if they actually were all in the data set.

See also (\insertCiteceyhan:Phd-thesis,ceyhan:comp-geo-2010;textualpcds).

Usage

Idom.num3PEtetra(
  p1,
  p2,
  pt3,
  Xp,
  th,
  r,
  M = "CM",
  rv1 = NULL,
  rv2 = NULL,
  rv3 = NULL,
  ch.data.pnts = FALSE
)

Arguments

p1, p2, pt3	Three 3D points to be tested for constituting a dominating set of the PE-PCD.
Xp	A set of 3D points which constitutes the vertices of the PE-PCD.
th	A 4 \times 3 matrix with each row representing a vertex of the tetrahedron.
r	A positive real number which serves as the expansion parameter in PE proximity region; must be \ge 1.
M	The center to be used in the construction of the vertex regions in the tetrahedron, th. Currently it only takes "CC" for circumcenter and "CM" for center of mass; default="CM".
rv1, rv2, rv3	The indices of the vertices whose regions contains p1, p2 and pt3, respectively. They take the vertex labels as 1,2,3,4 as in the row order of the vertices in th ( default is NULL for all).
ch.data.pnts	A logical argument for checking whether points p1 and p2 are data points in Xp or not (default is FALSE).

Value

I(\{p1,p2,pt3} is a dominating set of the PE-PCD) where the vertices of the PE-PCD are the 3D data set Xp), that is, returns 1 if {p1,p2,pt3} is a dominating set of PE-PCD, returns 0 otherwise

Author(s)

Elvan Ceyhan

References

\insertAllCited

See Also

Idom.num3PEstd.tetra

Examples

## Not run: 
set.seed(123)
A<-c(0,0,0); B<-c(1,0,0); C<-c(1/2,sqrt(3)/2,0); D<-c(1/2,sqrt(3)/6,sqrt(6)/3)
tetra<-rbind(A,B,C,D)
n<-5 #try 20, 40, 100 (larger n may take a long time)
Xp<-runif.tetra(n,tetra)$g

M<-"CM";  #try also M<-"CC";
r<-1.25

Idom.num3PEtetra(Xp[1,],Xp[2,],Xp[3,],Xp,tetra,r,M)

ind.gam3<-vector()
for (i in 1:(n-2))
 for (j in (i+1):(n-1))
   for (k in (j+1):n)
   {if (Idom.num3PEtetra(Xp[i,],Xp[j,],Xp[k,],Xp,tetra,r,M)==1)
    ind.gam3<-rbind(ind.gam3,c(i,j,k))}

ind.gam3

#or try
rv1<-rel.vert.tetraCC(Xp[1,],tetra)$rv; rv2<-rel.vert.tetraCC(Xp[2,],tetra)$rv;
rv3<-rel.vert.tetraCC(Xp[3,],tetra)$rv
Idom.num3PEtetra(Xp[1,],Xp[2,],Xp[3,],Xp,tetra,r,M,rv1,rv2,rv3)

#or try
rv1<-rel.vert.tetraCC(Xp[1,],tetra)$rv;
Idom.num3PEtetra(Xp[1,],Xp[2,],Xp[3,],Xp,tetra,r,M,rv1)

#or try
rv2<-rel.vert.tetraCC(Xp[2,],tetra)$rv
Idom.num3PEtetra(Xp[1,],Xp[2,],Xp[3,],Xp,tetra,r,M,rv2=rv2)

P1<-c(.1,.1,.1)
P2<-c(.3,.3,.3)
P3<-c(.4,.1,.2)
Idom.num3PEtetra(P1,P2,P3,Xp,tetra,r,M)

Idom.num3PEtetra(Xp[1,],c(1,1,1),Xp[3,],Xp,tetra,r,M,ch.data.pnts = FALSE)
#gives an error message if ch.data.pnts = TRUE since not all points are data points in Xp

## End(Not run)

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