Description Usage Arguments Details References Examples
View source: R/design.rcbd_function_vFldTrial.R
Randomized complete block designs (RCBD) are exceedingly common experimental designs in many field, including agricultural reserach. Details on RCBDs can easily be found in basic experimental design textbooks or an internet search; briefly, a set of experimental entries along with check lines, if desired, comprise a single block. This block is then replicated in its entirety at least once (i.e. two blocks) and up to any number of times.
1 2 3 4 5 |
enviro |
Optional |
exp.name |
Required |
nBlks |
Optional |
entries |
A |
nEntries |
|
chks |
A |
nChks |
|
nChkReps |
Optional |
nFieldRows |
Optional, but must be provided if nFieldCols is not. |
nFieldCols |
Optional, but must be provided if nFieldRows is not |
plot.start |
Optional |
fillWithEntry |
Optional |
fillWithChk |
Optional |
dup.list |
Optional |
plot_id.template |
Optional |
Figure 1 presents a simplified version of an RCBD with two replications within an environment where each block is a rectangle and there are no fill plots. In reality a block may end and the next start in the middle of a row; this is done to minimize the size of the experiment while meeting all requirements.
RCBD may not be well-suited for all circumstances; in these cases consider using other design functions included in FldTrial: design.aibd or design.mad.
@return A list
containing:
rcbd.dgn
A dataframe
of the resulting design. A line code of 0 denotes an experimental entry, codes of 1, 2, ..., (nChks) denote the first, second, up to the (nChks)-th check, respectively. The order of the check lines and thus line code is arbitrary and has no bearing on placement or randomization.
If fillWithEntry
is TRUE
then a "D" will be placed in the "Duplicates" column for all duplicated entries.
Note that the column name "replication" is used in rcbd.dgn
rather than "block" or "blk" for reasons related to compatibility with a preferred data entry software.
plot.layout
A matrix
of plot numbers reflecting the field layout. The first column contains field row numberis (i.e. 1:nFieldRows
) and the last row contains field column numbers (i.e. 1:nFieldCols
). See Figure 1.
check.layout
A matrix
of line codes reflecting the field layout. See plot.layout
for further details.
rep.layout
A matirx
of block assignments reflecting the field layout. See plot.layout
for further details.
field.dim
The dimensions of the resulting field design; nFieldRows x nFieldCols, or a x b (Figure 1).
nDuplicates
The number of duplicated experimental entries. Will only be non-zero if fillWithEntry
is TRUE
.
rlzPerChks
The final percentage of the designed represented by check lines. This can be affected by nChkReps and fillWithCheck
Bernardo, Rex. 2010. Breeding for Quantitative Traits in Plants. Stemma Press. Woodbury, MN.
1 2 3 4 5 6 7 8 9 10 11 12 13 | ## Not run:
## Example 1 - Generic layout with 2 reps
rcbd.ex1 <- design.rcbd(exp.name = "ex1", nBlks = 2,
nEntries = 80, nChks = 3, nChkReps = 3,
nFieldRows = 8)
## Example 2 - Layout with defined lines and checks
rcbd.ex2 <- design.rcbd(exp.name = "ex2", nBlks = 2,
entries = paste("Line", 1:75, sep="."),
chks = c("Larry", "Curly", "Moe"),
nChkReps = 4, nFieldCols = 20)
## End(Not run)
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.