seq_quenouille: Quenouille (1953) cross-over design specification

Description Usage Arguments Details Value Author(s) References Examples

View source: R/seq_quenouille.R

Description

Specifies cross-over designs from Quenouille (1953).

Usage

1
2
seq_quenouille(D = 3, selection = 1, labels = 0:(D - 1),
  as_matrix = T, summary = T)

Arguments

D

The number of treatments. Must be either three or four. Defaults to 3.

selection

A single numeric integer indicating which design to return, for the chosen value of D. See Details for information on supported values.

labels

A vector of labels for the treatments. Should be of length D, containing unique elements. Defaults to 0:(D - 1).

as_matrix

A logical variable indicating whether the design should be returned as a matrix, or a tibble. Defaults to T.

summary

A logical variable indicating whether a summary of the function's progress should be printed to the console. Defaults to T.

Details

seq_quenouille() supports the specification of designs from Quenouille (1953). Designs for three or four treatments (see D) are supported, for any chosen treatment labels (see labels). In addition, the designs can be returned in matrix or tibble form (see as_matrix).

Precisely, for D = 3, two designs are available (accessible by setting selection equal to one or two), and for D = 4, three designs are available (accessible by setting selection equal to one, two, or three). Ultimately, the (k,j)th element of the cross-over design matrix corresponds to the treatment a subject on the ifelsehtmlkkth sequence would receive in the jth period.

Value

Either a matrix if as_matrix = T (with rows corresponding to sequences and columns to periods), or a tibble if as_matrix = F (with rows corresponding to a particular period on a particular sequence). In either case, the returned object will have class xover_seq.

Author(s)

Based on data from the Crossover package by Kornelius Rohmeyer.

References

Quenouille MH (1953) The Design and Analysis of Experiments. Griffin: London.

Examples

1
2
3
4
5
6
7
8
9
# Quenouille (1953) designs for three treatments
quenouille1        <- seq_quenouille()
quenouille2        <- seq_quenouille(selection = 2)
# Using different labels
quenouille1_ABC    <- seq_quenouille(labels = LETTERS[1:3])
quenouille2_ABC    <- seq_quenouille(selection = 2, labels = LETTERS[1:3])
# Returning in tibble form
quenouille1_tibble <- seq_quenouille(as_matrix = F)
quenouille2_tibble <- seq_quenouille(selection = 2, as_matrix = F)

mjg211/xover documentation built on Oct. 16, 2019, 10:46 a.m.