1. Home
  2. AFLABELS procedure

AFLABELS procedure

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
Updated on March 11, 2019

Was this article helpful?