seq_iqbal_jones: Iqbal and Jones (1994) cross-over design specification
In mjg211/xover: Design and analysis of cross-over clinical trials

Description Usage Arguments Details Value Author(s) References Examples

Specifies cross-over designs from Iqbal and Jones (1994).

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

`D`	The number of treatments. Must be an integer between three and ten inclusive. 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`.

seq_iqbal_jones() supports the specification of designs from Iqbal and Jones (1994). Designs for three through ten 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 equal to three through ten, there are five, three, four, five, six, six, one, and one designs available respectively (accessible by setting selection equal to one through six as appropriate). Ultimately, the (k,j)th element of the cross-over design matrix corresponds to the treatment a subject on the kth sequence would receive in the jth period.

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.

Based on data from the Crossover package by Kornelius Rohmeyer.

Iqbal I, Jones B (1994) Efficient repeated measurements designs with equal and unequal period sizes. J Stat Plan Infer 42:79-88.

# Iqbal and Jones (1994) designs for four treatments
iqbal_jones1        <- seq_iqbal_jones(D = 4)
iqbal_jones2        <- seq_iqbal_jones(D = 4, selection = 2)
iqbal_jones3        <- seq_iqbal_jones(D = 4, selection = 3)
# Using different labels
iqbal_jones1_ABCD   <- seq_iqbal_jones(D = 4, labels = LETTERS[1:4])
iqbal_jones2_ABCD   <- seq_iqbal_jones(D = 4, selection = 2,
                                       labels = LETTERS[1:4])
iqbal_jones3_ABCD   <- seq_iqbal_jones(D = 4, selection = 3,
                                       labels = LETTERS[1:4])
# Returning in tibble form
iqbal_jones1_tibble <- seq_iqbal_jones(D = 4, as_matrix = F)
iqbal_jones2_tibble <- seq_iqbal_jones(D = 4, selection = 2, as_matrix = F)
iqbal_jones3_tibble <- seq_iqbal_jones(D = 4, selection = 3, as_matrix = F)