denpro (version 0.9.2)

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

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

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)