Prints or stores treatment combinations tabulated by the block factors (R.W. Payne).
Options
PRINT = string token |
Controls the printing of the design (design ); default desi |
---|---|
BLOCKSTRUCTURE = formula |
Defines the block factors for the design; the default is to take those specified by the BLOCKSTRUCTURE directive |
TREATMENTSTRUCTURE = formula |
Defines the treatment factors for each design; the default is to take those specified by the TREATMENTSTRUCTURE directive |
TABLES = pointer |
Contains tables to store the tabulated factor values for printing outside the procedure in some other format |
FREPRESENTATION = string token |
How to represent the factor values (labels , levels ); default leve |
No parameters
Description
PDESIGN
allows the treatment combinations allocated to each plot in a design to be displayed as tables, classified by the block factors.
By default, the combinations are represented using the levels of the treatment factors. If any factor also has labels these are printed alongside the levels, as a key, after the tables. The levels are printed in formats that are determined automatically in a way that avoids wasted space or unnecessary decimal places. Alternatively, if you set option FREPRESENTATION=labels
, the labels are displayed in the table, instead of the levels.
The block factors are obtained from the block structure of the design, which can be specified explicitly using the BLOCKSTRUCTURE
option; otherwise PDESIGN
will use any structure that has already been defined by a BLOCKSTRUCTURE
statement earlier in the job. Similarly, the treatment factors are obtained either from the TREATMENTSTRUCTURE
option of the procedure, or from an earlier TREATMENTSTRUCTURE
statement.
If the display produced by the procedure is unsuitable, printing can be suppressed by setting option PRINT=*
(by default PRINT=design
), and the tables of treatment levels can be saved for printing outside the procedure by setting the TABLES
option to a pointer. This will be returned with an element for each treatment factor, pointing to a table classified by the block factors and storing the tabulated levels of the treatment.
Options: PRINT
, BLOCKSTRUCTURE
, TREATMENTSTRUCTURE
, TABLES
, FREPRESENTATION
.
Parameters: none.
Method
The FCLASSIFICATION
directive is used to form lists of factors from the block or treatment formulae and, if the block factors do not supply a unique combination of levels for every unit of the design, procedure AFUNITS
is used to form a factor to index the units with each combination. Each treatment factor is then copied into a variate and TABULATE
is used to put the values into a table classified by the block factors. Numbers of decimal places for printing the factor levels are determined using the DECIMALS
procedure. When FREPRESENTATION=labels
, the TLABELS
parameter of PRINT
is used to display the labels within the table.
Action with RESTRICT
If any of the factors is restricted, only the part of the design not excluded by the restriction will be displayed.
See also
Procedures: ADSPREADSHEET
, DDESIGN
.
Commands for: Design of experiments.
Example
CAPTION 'PDESIGN example',\ '1) Randomized block design in 3 blocks each of 4 plots';\ STYLE=meta,plain FACTOR [LEVELS=3; VALUES=4(1...3)] Blocks & [LEVELS=4; VALUES=(1...4)3] Plots,Treat RANDOMIZE [BLOCKSTRUCTURE=Blocks/Plots; SEED=556743] Treat PDESIGN [BLOCKS=Blocks/Plots; TREATMENTS=Treat] CAPTION '2) 4x4 latin square' FACTOR [LEVELS=4; VALUES=4(1...4)] Rows & [VALUES=(1...4)4] Columns FACTOR [LABELS=!T('A','B','C','D'); \ VALUES=1,2,3,4, 2,3,4,1, 3,4,1,2, 4,1,2,3] Treat RANDOMIZE [BLOCKSTRUCTURE=Rows*Columns; SEED=568882] Treat PDESIGN [BLOCKS=Rows*Columns; TREATMENTS=Treat] CAPTION '3) A partially confounded factorial experiment (ANOVA Example 7)' FACTOR [NVALUES=32; LEVELS=8] Blocks; VALUES=!(4(1...8)) & [LEVELS=2; LABELS=!T(O,N)] Nitrogen & [LABELS=!t(O,K)] K20 & [LABELS=!t(O,D)] Dung READ Nitrogen,K20,Dung ; FREPRESENTATION=labels O O O N K O N O D O K D N O O O K O O O D N K D N O O O K O N O D O K D O O O O O D N K O N K D N O O O O D N K O O K D O O O O K O N O D N K D O K O O O D N K O N O D O O O N O O O K D N K D : BLOCKS Blocks TREATMENTS Nitrogen * K20 * Dung PDESIGN