sea.enumerate {ldsa}R Documentation

Enumerate All Response Patterns Associated With an Entailment Model

Description

Extracts the entailments from x satisfying a given error threshold, and then generates all patterns of observations consistent with those entailments (if any). sea.enumerate does this via a filtration process, while sea.enumerate.constructive employs a recursive construction algorithm.

Usage

sea.enumerate(x, thresh = 0.1, measure = c("rate", "z-score",
    "binom.p"), req.str = TRUE, sea.table.precomp = NULL)
sea.enumerate.constructive(x, thresh = 0.1, 
    measure = c("rate", "z-score", "binom.p"), req.str = TRUE,
    sea.table.precomp = NULL)

Arguments

x a data.frame with observations on rows; missing data is permitted.
thresh error threshold to employ when extracting entailments; only rules with error rates less than thresh are retained.
measure error measure to use; rate for absolute error rates, z-score for z-scores, or binom.p for p-values under an exact Binomial test.
req.str logical; should implications be required to satisfy White's “strong relationship” rule to be included?
sea.table.precomp an object of class sea.table, computed on x (optional).

Details

sea.enumerate and sea.enumerate.constructive differ only in the algorithms employed to perform the enumeration, and should otherwise produce identical results. sea.enumerate.constructive scales much more favorably, and is the only feasible option when the number of variables is larger than 20 or so; however, the non-recursive variant is included for those who are suspicious of how gracefully R's memory management will fail in extreme cases.

Extraction for the entailments is performed by sea.entailment; see the associated man page for more information.

Value

A matrix whose rows contain the response patterns; if no legal patterns exist, then the return value is NULL.

Author(s)

Carter T. Butts buttsc@uci.edu

See Also

sea.entailment, sea.table


[Package ldsa version 0.1-2 Index]