profgene: Calculates the level set tree of a rectangularwise constant...

In denpro: Visualization of Multivariate Functions, Sets, and Data

Description

Returns the level set tree of a function which is rectangularwise constant.

Usage

profgene(values, recs, frekv=NULL, cvol=TRUE, ccen=TRUE, cfre=FALSE,
outlsets=TRUE, invalue=TRUE)

Arguments

values	recnum-vector of positive real values; we want to define a rectangularwise constant non-negative function and we denote with "recnum" the number of rectangles at which the function has values greater than 0.
recs	recnum*(2*d)-matrix; corresponding to each element of vector "value" we specify a rectangle. In each row of the "recs" we specify a rectangle at which the estimate has the value given at the corresponding element of "value". Rows of "recs" have the form c(b1,e1,...,bd,ed) when rectangle is the product of intervals [bi,ei], i=1,...,d.
frekv	recnum-vector; for each rectangle the number of observations in this rectangle. Supplying this argument is useful in clustering: one may see the number of observations in each node of the level set tree.
cvol	TRUE if one wants that the volumes of separated parts of the level sets are returned, note that one needs volumes for drawing volume plots
ccen	TRUE if one wants that the barycenters of the separated parts of the level sets are returned
cfre	TRUE if one wants the frequencies of separated parts of the level sets to be returned
outlsets	not needed
invalue	not needed

Value

An augmented level set tree. The level set tree is a list of vectors. The elements of the vectors supply information for each node of the tree. Below we denote with "nodenum" the number of nodes of the tree.

parent	"nodenum"-vector of integers in range 0,..., nodenum-1; links to the parent of each node. Root nodes are marked with 0.
level	"nodenum"-vector of positive real numbers; level of the level set from which the set corresponding to the node is a part of.
volume	"nodenum"-vector of positive real numbers; volume of sets corresponding to each node
center	d*nodenum-matrix; barycenters of sets corresponding to each node
invalue	"nodenum"-vector of positive integers; level of the level set in terms of original frequencies (these values are not normalized so that estimate would integrate to one)
nodefrek	"nodenum"-vector of positive integers; number of observations in the set corresponding to node. Useful in cluster analysis applications.
lsets	nodenum*binnum-matrix; describes the sets associated with nodes. We have 1 in column "c" if the bin described in c:th row of recs is part of the set associated with this node

Note

Applies the naive algorithm of pairwise comparison of the separated components of the level sets, to find which components touch each other.

Author(s)

Jussi Klemela

See Also

profhist,profkern,plotvolu

Examples

recnum<-3
d<-2
value<-seq(1:recnum)
recs<-matrix(0,recnum,2*d)
recs[1,]<-c(0,1,0,1)
recs[2,]<-c(0,1,1,2)
recs[3,]<-c(1,2,0,2)
pg<-profgene(value,recs)

denpro documentation built on May 2, 2019, 8:55 a.m.