NPEstd.tetra: The vertices of the Proportional Edge (PE) Proximity Region...

View source: R/PropEdge3D.R

NPEstd.tetraR Documentation

The vertices of the Proportional Edge (PE) Proximity Region in the standard regular tetrahedron

Description

Returns the vertices of the PE proximity region (which is itself a tetrahedron) for a point in the standard regular tetrahedron T_h=T((0,0,0),(1,0,0),(1/2,\sqrt{3}/2,0),(1/2,\sqrt{3}/6,\sqrt{6}/3))= (rv=1,rv=2,rv=3,rv=4).

PE proximity region is defined with respect to the tetrahedron T_h with expansion parameter r \ge 1 and vertex regions based on the circumcenter of T_h (which is equivalent to the center of mass in the standard regular tetrahedron).

Vertex regions are labeled as 1,2,3,4 rowwise for the vertices of the tetrahedron T_h. rv is the index of the vertex region p resides, with default=NULL. If p is outside of T_h, it returns NULL for the proximity region.

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

Usage

NPEstd.tetra(p, r, rv = NULL)

Arguments

p

A 3D point whose PE proximity region is to be computed.

r

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

rv

Index of the vertex region containing the point, either 1,2,3,4 or NULL (default is NULL).

Value

Vertices of the tetrahedron which constitutes the PE proximity region with expansion parameter r and circumcenter (or center of mass) for a point p in the standard regular tetrahedron

Author(s)

Elvan Ceyhan

References

\insertAllCited

See Also

NPEtetra, NPEtri and NPEint

Examples

## Not run: 
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<-3
Xp<-runif.std.tetra(n)$g
r<-1.5
NPEstd.tetra(Xp[1,],r)

#or try
RV<-rel.vert.tetraCC(Xp[1,],tetra)$rv
NPEstd.tetra(Xp[1,],r,rv=RV)

NPEstd.tetra(c(-1,-1,-1),r,rv=NULL)

## End(Not run)


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