# NAG FL Interfaceg04bbf (random)

## ▸▿ Contents

Settings help

FL Name Style:

FL Specification Language:

## 1Purpose

g04bbf computes the analysis of variance and treatment means and standard errors for a randomized block or completely randomized design.

## 2Specification

Fortran Interface
 Subroutine g04bbf ( n, y, nt, it, tabl, c, ldc, irep, r, ef, tol, irdf, wk,
 Integer, Intent (In) :: n, iblock, nt, it(*), ldtabl, ldc, irdf Integer, Intent (Inout) :: ifail Integer, Intent (Out) :: irep(nt) Real (Kind=nag_wp), Intent (In) :: y(n), tol Real (Kind=nag_wp), Intent (Inout) :: tabl(ldtabl,5), c(ldc,nt) Real (Kind=nag_wp), Intent (Out) :: gmean, bmean(abs(iblock)), tmean(nt), r(n), ef(nt), wk(3*nt)
#include <nag.h>
 void g04bbf_ (const Integer *n, const double y[], const Integer *iblock, const Integer *nt, const Integer it[], double *gmean, double bmean[], double tmean[], double tabl[], const Integer *ldtabl, double c[], const Integer *ldc, Integer irep[], double r[], double ef[], const double *tol, const Integer *irdf, double wk[], Integer *ifail)
The routine may be called by the names g04bbf or nagf_anova_random.

## 3Description

In a completely randomized design, experimental material is divided into a number of units, or plots, to which a treatment can be applied. In a randomized block design the units are grouped into blocks so that the variation within blocks is less than the variation between blocks. If every treatment is applied to one plot in each block it is a complete block design. If there are fewer plots per block than treatments then the design will be an incomplete block design and may be balanced or partially balanced.
For a completely randomized design, with $t$ treatments and ${n}_{t}$ plots per treatment, the linear model is
 $yij = μ + τj + eij , j=1,2,…,t ​ and ​ i=1,2,…,nj ,$
where ${y}_{ij}$ is the $i$th observation for the $j$th treatment, $\mu$ is the overall mean, ${\tau }_{j}$ is the effect of the $j$th treatment and ${e}_{ij}$ is the random error term. For a randomized block design, with $t$ treatments and $b$ blocks of $k$ plots, the linear model is
 $yij(l) = μ + βi + τl + eij , i=1,2,…,b , ​ j=1,2,…,k ​ and ​ l=1,2,…,t ,$
where ${\beta }_{i}$ is the effect of the $i$th block and the $ij\left(l\right)$ notation indicates that the $l$th treatment is applied to the $j$th plot in the $i$th block.
The completely randomized design gives rise to a one-way analysis of variance. The treatments do not have to be equally replicated, i.e., do not have to occur the same number of times. First the overall mean, $\stackrel{^}{\mu }$, is computed and subtracted from the observations to give ${y}_{ij}^{\prime }={y}_{ij}-\stackrel{^}{\mu }$. The estimated treatment effects, ${\stackrel{^}{\tau }}_{j}$ are then computed as the treatment means of the mean adjusted observations, ${y}_{ij}^{\prime }$, and the treatment sum of squares can be computed from the sum of squares of the treatment totals of the ${y}_{ij}^{\prime }$ divided by the number of observations per treatment total, ${n}_{j}$. The final residuals are computed as ${r}_{ij}={y}_{ij}^{\prime }-{\stackrel{^}{\tau }}_{j}$, and, from the residuals, the residual sum of squares is calculated.
For the randomized block design the mean is computed and subtracted from the observations to give ${y}_{ij\left(l\right)}^{\prime }={y}_{ij\left(l\right)}-\stackrel{^}{\mu }$. The estimated block effects, ignoring treatment effects, ${\stackrel{^}{\beta }}_{i}$, are then computed using the block means of the ${y}_{ij\left(l\right)}^{\prime }$ and the unadjusted sum of squares computed as the sum of squared block totals for the ${y}_{ij\left(l\right)}^{\prime }$ divided by number of plots per block, $k$. The block adjusted observations are then computed as ${y}_{ij\left(l\right)}^{\prime \prime }={{y}_{i}^{\prime }j}_{\left(l\right)}={\stackrel{^}{\beta }}_{i}$. In the case of the complete block design, with the same replication for each treatment within each block, the blocks and treatments are orthogonal, and so the treatment effects are estimated as the treatment means of the block adjusted observations, ${y}_{ij\left(l\right)}^{\prime \prime }$. The treatment sum of squares is computed as the sum of squared treatment totals of the ${y}_{ij\left(l\right)}^{\prime \prime }$ divided by the number of replicates to the treatments, $r=bk/t$. Finally the residuals, and hence the residual sum of squares, are given by ${r}_{ij\left(l\right)}={y}_{ij\left(l\right)}^{\prime \prime }-{\stackrel{^}{\tau }}_{l}$.
For a design without the same replication for each treatment within each block the treatments and the blocks will not be orthogonal, so the treatments adjusted for blocks need to be computed. The adjusted treatment effects are found as the solution to the equations
 $(R-NNT/k)τ^=q,$
where $q$ is the vector of the treatment totals for block adjusted observations, ${y}_{ij\left(l\right)}^{\prime \prime }$, $R$ is a diagonal matrix with ${R}_{ll}$ equal to the number of times the $l$th treatment is replicated, and ${\mathbf{n}}$ is the $t×b$ incidence matrix, with ${N}_{lj}$ equal to the number of times treatment $l$ occurs in block $j$. The solution to the equations can be written as
 $τ^=Ωq$
where $\Omega$ is a generalized inverse of $\left(R-N{N}^{\mathrm{T}}/k\right)$. The solution is found from the eigenvalue decomposition of $\left(R-N{N}^{\mathrm{T}}/k\right)$. The residuals are first calculated by subtracting the estimated treatment effects from the block adjusted observations to give ${r}_{ij\left(l\right)}^{\prime }={y}_{ij\left(l\right)}^{\prime \prime }-{\stackrel{^}{\tau }}_{l}$. However, since only the unadjusted block effects have been removed and blocks and treatments are not orthogonal, the block means of the ${r}_{ij\left(l\right)}^{\prime }$ have to be subtracted to give the correct residuals, ${r}_{ij\left(l\right)}$ and residual sum of squares.
The mean squares are computed as the sum of squares divided by the degrees of freedom. The degrees of freedom for the unadjusted blocks is $b-1$, for the completely randomized and the complete block designs the degrees of freedom for the treatments is $t-1$. In the general case the degrees of freedom for treatments is the rank of the matrix $\Omega$. The $F$-statistic given by the ratio of the treatment mean square to the residual mean square tests the hypothesis
 $H0:τ1=τ2=⋯=τt=0.$
The standard errors for the difference in treatment effects, or treatment means, for the completely randomized or the complete block designs, are given by:
 $se(τj-τj*)=(1nj+1nj*) s2$
where ${s}^{2}$ is the residual mean square and ${n}_{j}={n}_{j*}=b$ in the complete block design. In the general case the variances of the treatment effects are given by
 $var(τ)=Ωs2$
from which the appropriate standard errors of the difference between treatment effects or the difference between adjusted means can be calculated.
In the complete block design all the information on the treatment effects is given by the within block analysis. In other designs there may be a loss of information due to the non-orthogonality of treatments and blocks. The efficiency of the within block analysis in these cases is given by the (canonical) efficiency factors, these are the nonzero eigenvalues of the matrix $\left(R-N{N}^{\mathrm{T}}/k\right)$, divided by the number of replicates in the case of equal replication, or by the mean of the number of replicates in the unequally replicated case, see John (1987). If more than one eigenvalue is zero then the design is said to be disconnected and some treatments can only be compared using a between block analysis.
Cochran W G and Cox G M (1957) Experimental Designs Wiley
Davis O L (1978) The Design and Analysis of Industrial Experiments Longman
John J A (1987) Cyclic Designs Chapman and Hall
John J A and Quenouille M H (1977) Experiments: Design and Analysis Griffin
Searle S R (1971) Linear Models Wiley

## 5Arguments

1: $\mathbf{n}$Integer Input
On entry: the number of observations.
Constraint: ${\mathbf{n}}\ge 2$ and if $\mathrm{abs}\left({\mathbf{iblock}}\right)\ge 2$, n must be a multiple of $\mathrm{abs}\left({\mathbf{iblock}}\right)$.
2: $\mathbf{y}\left({\mathbf{n}}\right)$Real (Kind=nag_wp) array Input
On entry: the observations in the order as described by iblock and nt.
3: $\mathbf{iblock}$Integer Input
On entry: indicates the block structure.
$\mathrm{abs}\left({\mathbf{iblock}}\right)\le 1$
There are no blocks, i.e., it is a completely randomized design.
${\mathbf{iblock}}\ge 2$
There are iblock blocks and the data should be input by blocks, i.e., y must contain the observations for block $1$ followed by the observations for block $2$, etc.
${\mathbf{iblock}}\le -2$
There are $\mathrm{abs}\left({\mathbf{iblock}}\right)$ blocks and the data is input in parallel with respect to blocks, i.e., ${\mathbf{y}}\left(1\right)$ must contain the first observation for block $1$, ${\mathbf{y}}\left(2\right)$ must contain the first observation for block $2\cdots {\mathbf{y}}\left(\mathrm{abs}\left({\mathbf{iblock}}\right)\right)$ must contain the first observation for block $\mathrm{abs}\left({\mathbf{iblock}}\right),{\mathbf{y}}\left(\mathrm{abs}\left({\mathbf{iblock}}+1\right)\right)$ must contain the second observation for block $1$, etc.
Constraint: ${\mathbf{iblock}}=1$, $2$ or $-2$.
4: $\mathbf{nt}$Integer Input
On entry: the number of treatments. If only blocks are required in the analysis then set ${\mathbf{nt}}=1$.
Constraints:
• if $\mathrm{abs}\left({\mathbf{iblock}}\right)\ge 2$, ${\mathbf{nt}}\ge 1$;
• otherwise ${\mathbf{nt}}\ge 2$.
5: $\mathbf{it}\left(*\right)$Integer array Input
Note: the dimension of the array it must be at least ${\mathbf{n}}$ if ${\mathbf{nt}}\ge 2$, and at least $1$ otherwise.
On entry: ${\mathbf{it}}\left(\mathit{i}\right)$ indicates which of the nt treatments plot $\mathit{i}$ received, for $\mathit{i}=1,2,\dots ,{\mathbf{n}}$.
If ${\mathbf{nt}}=1$, it is not referenced.
Constraint: $1\le {\mathbf{it}}\left(\mathit{i}\right)\le {\mathbf{nt}}$, for $\mathit{i}=1,2,\dots ,{\mathbf{n}}$.
6: $\mathbf{gmean}$Real (Kind=nag_wp) Output
On exit: the grand mean, $\stackrel{^}{\mu }$.
7: $\mathbf{bmean}\left(\mathrm{abs}\left({\mathbf{iblock}}\right)\right)$Real (Kind=nag_wp) array Output
On exit: if $\mathrm{abs}\left({\mathbf{iblock}}\right)\ge 2$, ${\mathbf{bmean}}\left(\mathit{j}\right)$ contains the mean for the $\mathit{j}$th block, ${\stackrel{^}{\beta }}_{\mathit{j}}$, for $\mathit{j}=1,2,\dots ,b$.
8: $\mathbf{tmean}\left({\mathbf{nt}}\right)$Real (Kind=nag_wp) array Output
On exit: if ${\mathbf{nt}}\ge 2$, ${\mathbf{tmean}}\left(\mathit{l}\right)$ contains the (adjusted) mean for the $\mathit{l}$th treatment, ${\stackrel{^}{\mu }}^{*}+{\stackrel{^}{\tau }}_{\mathit{l}}$, for $\mathit{l}=1,2,\dots ,t$, where ${\stackrel{^}{\mu }}^{*}$ is the mean of the treatment adjusted observations, ${y}_{ij\left(l\right)}-{\stackrel{^}{\tau }}_{l}$.
9: $\mathbf{tabl}\left({\mathbf{ldtabl}},5\right)$Real (Kind=nag_wp) array Output
On exit: the analysis of variance table. Column 1 contains the degrees of freedom, column 2 the sum of squares, and where appropriate, column 3 the mean squares, column 4 the $F$-statistic and column 5 the significance level of the $F$-statistic. Row 1 is for Blocks, row 2 for Treatments, row 3 for Residual and row 4 for Total. Mean squares are computed for all but the Total row; $F$-statistics and significance are computed for Treatments and Blocks, if present. Any unfilled cells are set to zero.
10: $\mathbf{ldtabl}$Integer Input
On entry: the first dimension of the array tabl as declared in the (sub)program from which g04bbf is called.
Constraint: ${\mathbf{ldtabl}}\ge 4$.
11: $\mathbf{c}\left({\mathbf{ldc}},{\mathbf{nt}}\right)$Real (Kind=nag_wp) array Output
On exit: if ${\mathbf{nt}}\ge 2$, the upper triangular part of c contains the variance-covariance matrix of the treatment effects, the strictly lower triangular part contains the standard errors of the difference between two treatment effects (means), i.e., ${\mathbf{c}}\left(\mathit{i},\mathit{j}\right)$ contains the covariance of treatment $\mathit{i}$ and $\mathit{j}$ if $\mathit{j}\ge \mathit{i}$ and the standard error of the difference between treatment $\mathit{i}$ and $\mathit{j}$ if $\mathit{j}<\mathit{i}$, for $\mathit{i}=1,2,\dots ,t$ and $\mathit{j}=1,2,\dots ,t$.
12: $\mathbf{ldc}$Integer Input
On entry: the first dimension of the array c as declared in the (sub)program from which g04bbf is called.
Constraint: ${\mathbf{ldc}}\ge {\mathbf{nt}}$.
13: $\mathbf{irep}\left({\mathbf{nt}}\right)$Integer array Output
On exit: if ${\mathbf{nt}}\ge 2$, the treatment replications, ${R}_{\mathit{l}\mathit{l}}$, for $\mathit{l}=1,2,\dots ,{\mathbf{nt}}$.
14: $\mathbf{r}\left({\mathbf{n}}\right)$Real (Kind=nag_wp) array Output
On exit: the residuals, ${r}_{\mathit{i}}$, for $\mathit{i}=1,2,\dots ,{\mathbf{n}}$.
15: $\mathbf{ef}\left({\mathbf{nt}}\right)$Real (Kind=nag_wp) array Output
On exit: if ${\mathbf{nt}}\ge 2$, the canonical efficiency factors.
16: $\mathbf{tol}$Real (Kind=nag_wp) Input
On entry: the tolerance value used to check for zero eigenvalues of the matrix $\Omega$. If ${\mathbf{tol}}=0.0$ a default value of ${10}^{-5}$ is used.
Constraint: ${\mathbf{tol}}\ge 0.0$.
17: $\mathbf{irdf}$Integer Input
On entry: an adjustment to the degrees of freedom for the residual and total.
${\mathbf{irdf}}\ge 1$
The degrees of freedom for the total is set to ${\mathbf{n}}-{\mathbf{irdf}}$ and the residual degrees of freedom adjusted accordingly.
${\mathbf{irdf}}=0$
The total degrees of freedom for the total is set to ${\mathbf{n}}-1$, as usual.
Constraint: ${\mathbf{irdf}}\ge 0$.
18: $\mathbf{wk}\left(3×{\mathbf{nt}}\right)$Real (Kind=nag_wp) array Workspace
19: $\mathbf{ifail}$Integer Input/Output
On entry: ifail must be set to $0$, $-1$ or $1$ to set behaviour on detection of an error; these values have no effect when no error is detected.
A value of $0$ causes the printing of an error message and program execution will be halted; otherwise program execution continues. A value of $-1$ means that an error message is printed while a value of $1$ means that it is not.
If halting is not appropriate, the value $-1$ or $1$ is recommended. If message printing is undesirable, then the value $1$ is recommended. Otherwise, the value $-1$ is recommended since useful values can be provided in some output arguments even when ${\mathbf{ifail}}\ne {\mathbf{0}}$ on exit. When the value $-\mathbf{1}$ or $\mathbf{1}$ is used it is essential to test the value of ifail on exit.
On exit: ${\mathbf{ifail}}={\mathbf{0}}$ unless the routine detects an error or a warning has been flagged (see Section 6).

## 6Error Indicators and Warnings

If on entry ${\mathbf{ifail}}=0$ or $-1$, explanatory error messages are output on the current error message unit (as defined by x04aaf).
Errors or warnings detected by the routine:
Note: in some cases g04bbf may return useful information.
${\mathbf{ifail}}=1$
On entry, ${\mathbf{irdf}}=⟨\mathit{\text{value}}⟩$.
Constraint: ${\mathbf{irdf}}\ge 0$.
On entry, ${\mathbf{ldc}}=⟨\mathit{\text{value}}⟩$ and ${\mathbf{nt}}=⟨\mathit{\text{value}}⟩$.
Constraint: ${\mathbf{ldc}}\ge {\mathbf{nt}}$.
On entry, ${\mathbf{ldtabl}}=⟨\mathit{\text{value}}⟩$.
Constraint: ${\mathbf{ldtabl}}\ge 4$.
On entry, ${\mathbf{n}}=⟨\mathit{\text{value}}⟩$.
Constraint: ${\mathbf{n}}\ge 2$.
On entry, no blocks or treatments in model.
On entry, ${\mathbf{nt}}=⟨\mathit{\text{value}}⟩$.
Constraint: ${\mathbf{nt}}\ge 1$.
On entry, ${\mathbf{tol}}=⟨\mathit{\text{value}}⟩$.
Constraint: ${\mathbf{tol}}\ge 0.0$.
${\mathbf{ifail}}=2$
On entry, ${\mathbf{n}}=⟨\mathit{\text{value}}⟩$ and ${\mathbf{iblock}}=⟨\mathit{\text{value}}⟩$.
Constraint: ${\mathbf{n}}\ge 2$ and if $\mathrm{abs}\left({\mathbf{iblock}}\right)\ge 2$, n must be a multiple of $\mathrm{abs}\left({\mathbf{iblock}}\right)$.
${\mathbf{ifail}}=3$
On entry, at least one treatment is not present. Treatment $⟨\mathit{\text{value}}⟩$ does not appear in it.
On entry, $i=⟨\mathit{\text{value}}⟩$, ${\mathbf{it}}\left(i\right)=⟨\mathit{\text{value}}⟩$ and ${\mathbf{nt}}=⟨\mathit{\text{value}}⟩$.
Constraint: $1\le {\mathbf{it}}\left(i\right)\le {\mathbf{nt}}$.
${\mathbf{ifail}}=4$
On entry, the values in y are constant.
${\mathbf{ifail}}=5$
A computed standard error is zero. This is due to rounding errors and is an unlikely error exit.
The computation of the eigenvalues has failed to converge. This is an unlikely error exit.
${\mathbf{ifail}}=6$
The treatments are totally confounded with blocks. The treatment sum of squares and degrees of freedom are zero. The analysis of variance table is not computed, except for block and total sums of squares and degrees of freedom.
${\mathbf{ifail}}=7$
The residual degrees of freedom is zero. Columns $3,4$ and $5$ of the analysis of variance table will not be computed and the matrix of standard errors and covariances, c, will not be scaled by $s$ or ${s}^{2}$.
The residual mean square is zero. Columns $3,4$ and $5$ of the analysis of variance table will not be computed and the matrix of standard errors and covariances, c, will not be scaled by $s$ or ${s}^{2}$.
${\mathbf{ifail}}=8$
The design is disconnected. The standard errors may not valid. The design may be nested.
${\mathbf{ifail}}=-99$
See Section 7 in the Introduction to the NAG Library FL Interface for further information.
${\mathbf{ifail}}=-399$
Your licence key may have expired or may not have been installed correctly.
See Section 8 in the Introduction to the NAG Library FL Interface for further information.
${\mathbf{ifail}}=-999$
Dynamic memory allocation failed.
See Section 9 in the Introduction to the NAG Library FL Interface for further information.

## 7Accuracy

The algorithm used by g04bbf, described in Section 3, achieves greater accuracy than the traditional algorithms based on the subtraction of sums of squares.

## 8Parallelism and Performance

g04bbf is threaded by NAG for parallel execution in multithreaded implementations of the NAG Library.
g04bbf makes calls to BLAS and/or LAPACK routines, which may be threaded within the vendor library used by this implementation. Consult the documentation for the vendor library for further information.
Please consult the X06 Chapter Introduction for information on how to control and interrogate the OpenMP environment used within this routine. Please also consult the Users' Note for your implementation for any additional implementation-specific information.

To estimate missing values the Healy and Westmacott procedure or its derivatives may be used, see John and Quenouille (1977). This is an iterative procedure in which estimates of the missing values are adjusted by subtracting the corresponding values of the residuals. The new estimates are then used in the analysis of variance. This process is repeated until convergence. A suitable initial value may be the grand mean $\stackrel{^}{\mu }$. When using this procedure irdf should be set to the number of missing values plus one to obtain the correct degrees of freedom for the residual sum of squares.
For designs such as Graeco–Latin squares one or more of the blocking factors has to be removed in a preliminary analysis before the final analysis using calls to g04bbf or g04bcf. The residuals from the preliminary analysis are then input to g04bbf. In these cases irdf should be set to the difference between n and the residual degrees of freedom from preliminary analysis. Care should be taken when using this approach as there is no check on the orthogonality of the two analyses.
For analysis of covariance the residuals are obtained from an analysis of variance of both the response variable and the covariates. The residuals from the response variable are then regressed on the residuals from the covariates using, say, g02cbf or g02daf. The results from those routines can be used to test for the significance of the covariates. To test the significance of the treatment effects after fitting the covariate, the residual sum of squares from the regression should be compared with the residual sum of squares obtained from the equivalent regression but using the residuals from fitting blocks only.

## 10Example

The data, given by John and Quenouille (1977), are for a balanced incomplete block design with $10$ blocks and $6$ treatments and with $3$ plots per block. The observations are the degree of pain experienced and the treatments are penicillin of different potency. The data is input and the analysis of variance table and treatment means are printed.

### 10.1Program Text

Program Text (g04bbfe.f90)

### 10.2Program Data

Program Data (g04bbfe.d)

### 10.3Program Results

Program Results (g04bbfe.r)