Forms a variate of unit labels for a design (R.W. Payne).

### Options

`UNITLABELS` = variate |
Stores the labels |
---|---|

`MAXDIGIT` = scalar |
Number of available digits; default 8 |

### Parameters

`FACTOR` = factors |
Factors indexing the units of the design; if this is unset, the factors from the most recent `BLOCKSTRUCTURE` command are used |
---|---|

`NEWLEVELS` = variates |
Allows new levels to be specified for each `FACTOR` ; if this is unset, uses the levels already defined for the factor |

### Description

`AFLABELS`

forms a variate, specified using the `UNITLABELS`

option, containing a unique code for each unit of a design. By default, it is assumed that the codes can be up to eight digits long, but this can be modified using the `MAXDIGIT`

option.

The units are assumed to be indexed by a set of factors which can be specified by the `FACTOR`

parameter; if this is not set, `AFLABELS`

takes those from the most recent `BLOCKSTRUCTURE`

command (if any). By default, the codes are formed from the levels of the factors but, if these are unsuitable, alternative levels can be supplied using the `NEWLEVELS`

parameter. In particular, `AFLABELS`

requires the levels (or new levels) all to be positive integers.

Options: `UNITLABELS`

, `MAXDIGIT`

.

Parameters: `FACTOR`

, `NEWLEVELS`

.

### Method

The codes are formed by ordinary arithmetic so that the initial digits are the levels of the first indexing factor, then the second, and so on. If there is too much information to fit within the `MAXDIGIT`

limit, `AFLABELS`

tries to decrease the sizes of the codes by successively combining the final pairs of factors.

### See also

Procedure: `AFUNITS`

.

Commands for: Design of experiments.

### Example

CAPTION 'AFLABELS example',!t('Split plot design, see the',\ 'Guide to Genstat, Part 2, Section 4.2.1.'); STYLE=meta,plain FACTOR [NVALUES=72; LEVELS=6] Blocks & [LEVELS=3] Wplots & [LEVELS=4] Subplots GENERATE Blocks,Wplots,Subplots BLOCK Blocks/Wplots/Subplots AFLABELS [UNITLABELS=Plots] PRINT Plots,Blocks,Wplots,Subplots