logregtree: Format of class logregtree

In LogicReg: Logic Regression

Format of class logregtree

Description

This help file contains a description of the format of class logregtree.

Usage

logregtree()

Details

When storing trees, we number the location of the nodes using the following scheme (this is an example for a tree with at most 8 terminal nodes, but the generalization should be obvious):

							1
			2								3
	4				5				6				7
8		9		10		11		12		13		14		15

Each node may or may not be present in the current tree. If it is present, it can contain an operator (“and” or “or”), in which case it has to child nodes, or it can contain a variable, in which case the node is a terminal node. It is also possible that the node does not exist (as the user only specifies the maximum tree size, not the tree size that is actually fitted).

Output files have one line for each node. Each line contains 5 numbers:

1. the node number.

2. does this node contain an “and” (1), an “or” (2), a variable (3), or is the node empty (0).

3. if the node contains a variable, which one is it; e.g. if this number is 3 the node contains X3.

4. if the node contains a variable, does it contain the regular variable (0) or its complement (1)

5. is the node empty (0) or not (1) (this information is redundant with the second number)

Example

AND

OR

OR

OR

OR

X20

OR

X17

X12

X3

X13c

X2

X1

is represented as

1	1	0	0	1
2	2	0	0	1
3	2	0	0	1
4	2	0	0	1
5	2	0	0	1
6	3	20	0	1
7	2	0	0	1
8	3	17	0	1
9	3	12	0	1
10	3	3	0	1
11	3	13	1	1
12	0	0	0	0
13	0	0	0	0
14	3	2	0	1
15	3	1	0	1

Value

An object of class logregtree is typically a substructure of an object of the class logregmodel. It will typically be the result of using the fitting function logreg. An object of class logictree has the following components:

whichtree	the sequence number of the current tree within the model.
coef	the coefficients of this tree.
trees	a matrix (data.frame) with five columns; see below for the format.

Author(s)

Ingo Ruczinski [e-mail] and Charles Kooperberg [e-mail].

References

Ruczinski I, Kooperberg C, LeBlanc ML (2003). Logic Regression, Journal of Computational and Graphical Statistics, 12, 475-511.

Ruczinski I, Kooperberg C, LeBlanc ML (2002). Logic Regression - methods and software. Proceedings of the MSRI workshop on Nonlinear Estimation and Classification (Eds: D. Denison, M. Hansen, C. Holmes, B. Mallick, B. Yu), Springer: New York, 333-344.

Selected chapters from the dissertation of Ingo Ruczinski, available from https://research.fredhutch.org/content/dam/stripe/kooperberg/ingophd-logic.pdf

See Also

logreg, plot.logregtree, print.logregtree, logregmodel

Examples

logregtree()       # displays this help file
help(logregtree)   # equivalent

LogicReg documentation built on Aug. 9, 2023, 1:07 a.m.