# summary-methods: Summarize the Design Properties In planor: Generation of Regular Factorial Designs

## Description

Methods to summarize the design properties of an object, by printing the summary of each key matrix.

## Usage

 ``` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17``` ```## S4 method for signature 'designkey' summary(object, show="dtbw", save="k", ...) ## S4 method for signature 'keymatrix' summary(object, fact, block, show="dtbw", save="k", ...) ## S4 method for signature 'keyring' summary(object, show="tbw",save ="kw", ...) ## S4 method for signature 'listofdesignkeys' summary(object, show="tbw", save="kw", ...) ## S4 method for signature 'listofkeyrings' summary(object, show="tbw", save="kw", ...) ## S4 method for signature 'planordesign' summary(object, fact, block, show="dtbw", save="k", ...) ```

## Arguments

 `object` an object of the class. `fact` a character or numeric vector of parent factor names for the columns of the object. `block` a logical vector to identify the columns of the object associated with a block factor `show` an optional string to identify the type of information to display. The recognized letters are: ‘d’ for the design keys matrices, ‘t’ for the treatment effects confounded with the mean, ‘b’ for the block-and-treatment effects confounded with the mean, ‘w’ for the weight profiles. `save` an optional string to identify the type of information to return. The recognized letters are: ‘k’ for the kernel matrices, ‘w’ for the weight profiles of the treatment effects confounded with the mean. `...` ignored.

## Details

The amount of display depends on the value of the argument `show`, and the type of returned information depends on the value of the argument `save`.

• When `object` is of class `keymatrix`, “summary” prints the key matrix, the factorial effects confounded with the mean, and the weight profiles of the effects confounded with the mean, according to the value of the argument `show`.
The `keymatrix` argument being denoted by `key`,
- The rows of `key` are associated with units factors (or pseudofactors) while its columns are associated with treatment or block factors (or pseudofactors).
- The vectors in the arguments `fact` and `block` give information on the treatment and block factors, so that their length is expected to be equal to the number of columns of `key`.
- If missing, `fact` attributes a distinct parent factor to each column of `key` and `block` is set to TRUE for all columns.

“summary” returns a list with the components required by the argument `save`.

• When `object` is of class `designkey`, “summary” prints the summary of each of the key matrices. It returns a list with as many components as key matrices, each one with the components required by the argument `save`.

• When `object` is of class `listofdesignkeys`, “summary” prints the summary of each key matrix in each design key. It returns a list with as many components as design keys, each one is a list of the key matrices summaries.

• When `object` is of class `listofkeyrings`, “summary” prints the summary of each key matrix in each keyring. It returns a list with as many components as keyrings, each one is a list of the key matrices summaries.

• When `object` is of class `keyring`, “summary” prints the summary of each of its key matrices. It returns a list with as many components as key matrices.

• When `object` is a `planordesign`, this function is the summary method applied on each of the keymatrix objects contained in its `designkey` slot.

## Value

A list. See Details
Information returned for each key matrix depends on the argument `save`.

• When `save` includes the character ‘k’, the returned list has a component named ‘k’.It is a matrix, the columns of which are kernel generators of the key matrices.

• When `save` includes the character ‘w’, the returned list has a component named ‘w’, which contains the weight profiles of the effects confounded with the mean.

## Note

An R option named `planor.max.print` is set. It is equal to the number of printed rows and columns in the display of planor matrices. Default is 20. You can change its value by using the function `options()` (see `?options`).

Classes where this method applies: `designkey`, `keymatrix`, `keyring`, `listofdesignkeys`, `listofkeyrings`, `planordesign`
 ``` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22``` ```### Creation of a listofdesignkeys object K0 <- planor.designkey(factors=c("R","C","U","A","B1","B2"), nlevels=c(3,2,2,3,2,2), model=~R*C + (A+B1+B2)^2, estimate=~A:B1+A:B2, nunits=12, base=~R+C+U, max.sol=2) ### Method summary applied on a keymatrix object r <- summary(K0[][]) ### Method summary applied on a designkey object summary(K0, save=NULL) ### Method summary applied on the listofdesignkeys object r <-summary(K0, show="dt") ### Creation of a listofkeyrings object K0 <- planor.designkey(factors=c(LETTERS[1:4], "block"), nlevels=rep(3,5), model=~block+(A+B+C+D)^2, estimate=~A+B+C+D, nunits=3^3, base=~A+B+C, max.sol=2) ### Method summary applied on the keymatrix object r <-summary(K0[][]) ### Method summary applied on the keyring object r <-summary(K0[]) ### Method summary applied on the listofkeyrings object r <- summary(K0, show="dtb", save ="k") print(r) ```