Description Usage Arguments Details Value Note Author(s) References See Also Examples

Utility functions for DoE packages, not intended for direct use

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | ```
make.generators(name, liste)
make.formulas(orignames, factor.names)
des.recode(var, recodes, as.factor.result, char)
printBy(data, byvars, ...)
Letters
gen.fun(obj, num = FALSE)
generators(design, ...)
## S3 method for class 'design'
generators(design, ...)
## S3 method for class 'catlg'
generators(design, ...)
## S3 method for class 'character'
generators(design, select.catlg = catlg, ...)
PFTs.from.variants(array, variants, R=3, rela=TRUE)
matrix.fromPFTs(PFTs)
rankPFT(pfts)
bestPFT(pfts)
rect_simplex(r)
HouseholderRotToOne(from)
``` |

`name` |
... |

`liste` |
... |

`orignames` |
... |

`factor.names` |
... |

`var` |
variable |

`recodes` |
character string specifying recodes, so far only used in the principal form “-1=level[1];1=level[2]” |

`as.factor.result` |
logical that specifies whether or not results are to be coerced to factor. The default is that factors are coerced to factor, while numeric variables with numeric recodes are kept numeric. |

`char` |
logical: should replacement be treated as character string (TRUE) or evaluated? default is FALSE |

`data` |
data frame to be printed in groups that are defined by the |

`byvars` |
character vector of variable names;
variables named here determine the groups; only adjacent observations are considered part of a group, i.e.
if data are not ordered by the |

`obj` |
an entry of a class |

`num` |
logical; if |

`design` |
FrF2 design given as catalogue entry, design itself or character string; function generators provides the generating contrasts for additional factors for these designs. |

`select.catlg` |
the catalogue in which to look for the design (should be of class |

`...` |
further arguments to function |

`array` |
orthogonal array (available in the workspace); must be matrix or data frame |

`variants` |
matrix the rows of which contain column numbers for |

`R` |
resolution of |

`rela` |
logical; relative PFTs ( |

`PFTs` |
list of (absolute or relative) projection frequency tables. |

`pfts` |
a matrix the columns of which contain the PFT entries for several designs,
with row names indicating the (relative) number of words of a triple/quadruple. |

`r` |
integer; dimension of the simplex |

`from` |
numeric vector to be rotated towards (1,0,...,0) |

Most functions are not intended for direct use.

The constant `Letters`

is the vector of all capital and lower case
letters of the Roman alphabet except `I`

and `i`

.
It is used for default factor names and has been obtained as

`Letters <- c(LETTERS[-9],letters[-9])`

.

The generic function `generators`

and its methods determine generating contrasts
for regular fractional factorial 2-level designs, which can be specified as

the design itself (created with function `FrF2`

),

a list of catalogue entries in package FrF2 object `catlg`

,

or a character string that names such a catalogue entry.

The method for the design itself cannot be used on designs of type
`FrF2.param...`

or `FrF2.folded`

. Also, it cannot
be used on designs produced with versions of FrF2 before `1.1`

in case
of blocked or splitplot designs. It is generally recommended to update all packages of the
suite (DoE.base, FrF2, DoE.wrapper, RcmdrPlugin.DoE), whenever
one of them is updated.

This paragraph describes internal functions: Function `PFTs.from.variants`

can be used to determine a list of (relative)
projection frequency tables (cf. Groemping 2011) for comparing several column
selections from the same array. Function `matrix.fromPFTs`

brings
this list into matrix form, functions `rankPFT`

and `bestPFT`

allow ranking or picking best selections.

Most functions are not intended for direct use.

The `generators`

methods output a list of human-readable character string
vectors with the generators of catalogue entries or a design.

The following functions have not yet been adapted to also handle the more
attractive new metrics calculated with functions `P3.3`

, `P4.4`

and
`GRind`

.
Function `PFTs.from.variants`

outputs a list of (relative) projection
frequency tables (each entry is produced with function `P3.3`

or `P4.4`

).
Function `matrix.fromPFTs`

outputs a matrix (reshaped from such a list, filling
missing entries with 0 counts for some designs, if required), with columns for
the different selections and rows for different (relative) numbers of generalized words.
Function `rankPFTs`

outputs a ranking vector, with 1 for the best design
(ties are kept in the original order). Function `bestPFTs`

outputs a logical vector,
with entry `TRUE`

for all best designs (identical best (R)PFTs).

This package is currently under intensive development. Substantial changes are to be expected in the near future.

Ulrike Groemping

Groemping, U. (2011). Relative projection frequency tables for orthogonal arrays.
Report 1/2011, *Reports in Mathematics, Physics and Chemistry* http://www1.beuth-hochschule.de/FB_II/reports/welcome.htm,
Department II, Beuth University of Applied Sciences, Berlin.

Hedayat, A.S., Sloane, N.J.A. and Stufken, J. (1999) *Orthogonal Arrays: Theory and Applications*, Springer, New York.

See Also `FrF2-package`

, `DoE.wrapper-package`

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | ```
## default factor names for most design generating functions
## (some quantitative designs have other default factor names)
## for up to 50 factors
Letters
## Not run:
generators("7-2.2")
generators(catlg[2:8])
generators(FrF2(16,7))
generators(FrF2(16,5,blocks=4,alias.block.2fi=TRUE))
generators(FrF2(16,5,WPs=4,nfac.WP=2))
## End(Not run)
## column selections from L18 with one 2-level and six 3-level factors
v <- rbind(1:7, c(1:6,8), c(1:5,7:8), c(1:4,6:8), c(1:3,5:8), c(1:2,4:8), c(1,3:8))
## RPFTs
RPFTs <- DoE.base:::PFTs.from.variants(L18, v, rela=TRUE)
rpfts <- DoE.base:::matrix.fromPFTs(RPFTs)
rpfts
DoE.base:::rankPFT(rpfts)
DoE.base:::bestPFT(rpfts)
``` |

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.