DoE.base (version 0.23-2)

show.oas: Function to display list of available orthogonal arrays

Description

This function allows to inspect the list of available orthogonal arrays, specifying optionally specifying selection criteria.

Usage

show.oas(name = "all", nruns = "all", nlevels = "all", factors = "all", 
    show = 10, parents.only = FALSE)

Arguments

name

character string or vector of character strings giving name(s) of (an) orthogonal array(s); results in an error if name does not contain any valid name; warns if name contains any invalid name

nruns

the requested number of runs or a 2-element vector with a minimum and maximum for the number of runs

nlevels

a vector of requested numbers of levels for a set of factors in question, must contain integers > 1 only; nlevels cannot be specified together with factors

factors

a list with the two elements nlevels and number, which are both integer vectors of equal length; nlevels contains the number of levels and number the number of factors for the corresponding n

show

an integer number specifying how many designs are to be listed (upper bound), or the character string "all" for showing all designs, no matter how many. The default is to show 10 designs. show = 0 switches off the dis

parents.only

logical specifying whether to show only parent arrays or child arrays as well; the default is FALSE for inclusion of child arrays

Value

• A data frame with the three columns name, nruns and lineage, containing the design name, the number of runs and - if applicable - the lineage for generating the design from other designs. The lineage entry is empty for parent designs that are either directly available in the package and can be accessed by giving their name (e.g. L18.3.6.6.1) or are full factorials (e.g. L28.4.1.7.1). If no design has been found, the returned value is NULL.

Details

The function shows the arrays that are listed in the data frame oacat. For child arrays that have to be generated with a lineage rule (can be automatically done with function oa.design), the lineage is displayed together with the design name. The option parent.only = TRUE suppresses printing and output of child arrays. The structure of the lineage entry is documented under oacat.

References

Kuhfeld, W. (2009). Orthogonal arrays. Website courtesy of SAS Institute http://support.sas.com/techsup/technote/ts723.html. Mee, R. (2009). A Comprehensive Guide to Factorial Two-Level Experimentation. New York: Springer.

See Also

oa.design for using the designs from oacat in design creation oacat for the data frame underlying the function

Examples

## the first 10 orthogonal arrays with 24 to 28 runs
   show.oas(nruns = c(24,28))
   ## the first 10 orthogonal arrays with 24 to 28 runs
   ## excluding child arrays
   show.oas(nruns = c(24,28), parents.only=TRUE)
   ## the orthogonal arrays with 4 2-level factors, one 4-level factor and one 5-level factor
   show.oas(factors = list(nlevels=c(2,4,5),number=c(4,1,1)))
   ## the orthogonal arrays with 4 2-level factors, one 7-level factor and one 5-level factor
   show.oas(factors = list(nlevels=c(2,7,5),number=c(4,1,1)))
   ## the latter orthogonal arrays with the nlevels notation 
   ## (that can also be used in a call to oa.design subsequently)
   show.oas(nlevels = c(2,7,2,2,5,2))
   ## calling designs by name 
   show.oas(name=c("L12.2.11", "L18.2.1.3.7"))