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

profgene {denpro}

R Documentation

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(2d)-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

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)

[Package denpro version 0.9.0 Index]