Summarize the Design Properties

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).

See Also

Classes where this method applies: designkey, keymatrix, keyring, listofdesignkeys, listofkeyrings, planordesign

Examples

 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[[1]][[1]])
### Method summary applied on a designkey  object
summary(K0[1], 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[[1]][[1]])
### Method summary applied on the keyring object
r <-summary(K0[[1]])
### Method summary applied on the listofkeyrings object
r <- summary(K0, show="dtb", save ="k")
print(r)