PDESIGN procedure

Prints or stores treatment combinations tabulated by the block factors (R.W. Payne).


Options

PRINT = string
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


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.

   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. 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.

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.


Action with RESTRICT

If any of the factors is restricted, only the part of the design not excluded by the restriction will be displayed.