This function is called by the Factorial Design Dialog. It is an
interface to
fac.design, and is used to produce factorial and fractional
factorial designs.
vector of the number of levels for the factors in the design.
OPTIONAL ARGUMENTS:
factor.names
object that names the factors. This may be a vector of character
strings which are the names of the factors. It may also be a list, in
which case the names attribute of the list is the names of the
factors, and the components of the list (which need not be of mode
character) label the levels of the corresponding factor. If factor
names are not given, they default to A, B, etc. If levels are not
given, they default to the factor name (possibly abbreviated) followed
by level numbers.
replications
the number of times the complete design should be replicated.
row.names
names to use for the rows of the design. The default is 1:nrows,
where nrows is the number of observations in the design.
fraction
definition for the fraction desired in a fractional factorial
design. This may either be a numerical fraction (e.g,
1/4 for a
quarter replicate), or a model formula giving one or more defining
contrasts (e.g., `A:B:D + B:C:E'). Fractional factorials are provided
only for 2-level factors. By default, a full factorial design is
created.
randomize.rows
Logical flag indicating whether to randomize the row order in the design.
restrict
vector (either numeric or character) specifying some factors (columns) in
the design which shouldn't be scrambled. This is only relevant if
randomize.rows=T.
save.name
character string giving name under which to save result. If this is
specified the result will be assigned to the working database under the
given name, and will also be returned invisibly.
show.p
logical flag: if TRUE,
save.name is specified, and the Windows S-PLUS GUI
is active, the result will be displayed in a Data Window.
VALUE:
A data.frame of class
design giving a factorial or fractional factorial
design with the specified characteristics.