This page describes the additions and changes to procedures and directives in Release 23.

## 1. Highlights

- 3 new directives
- 27 new procedures
- ability to close or view specific windows in the Genstat Graphics Viewer (
`DCLOSE`

,`DVIEW`

) - profile likelihood confidence intervals in regression and generalized linear models (
`RMPLCONFIDENCE`

,`RPLCONFIDENCE`

) - generalized linear models, generalized linear mixed models and hierarchical generalized linear models can now handle censored Poisson data (
`RTOBITPOISSON`

,`GLTOBITPOISSON`

,`HGTOBITPOISSON`

) - loess models for grouped data, fitting a different curve, slope and intercept for each group (
`RDLOESSGROUPS`

,`RKLOESSGROUPS`

,`RLOESSGROUPS`

) - trellis plots of bar and pie charts to display very large data sets of grouped data, for example from
`CVA`

analyses (`CVATRELLIS`

,`D2GROUPS`

) - efficient cluster analysis of very large data sets (
`PCPCLUSTER`

,`PTFCLUSTERS`

,`PTFILLCLUSTERS`

) - construction of Youden square designs (
`AGYOUDENSQUARE`

) - validation of a deterministic model against observed data (
`RVALIDATE`

) - convenient replacement of values in vectors and pointers (
`VREPLACE`

) - mosaic plots (
`DMOSAIC`

) - games (
`BINGO`

,`FRUITMACHINE`

,`LIFE`

,`NOUGHTSANDCROSSES`

)

## 2. What’s new

### 2.1 Directives

`DCLOSE`

closes windows in the Genstat Graphics Viewer.

`DVIEW`

views windows in the Genstat Graphics Viewer.

`%CLEAR`

clears the client Output window.

### 2.2 Procedures

`ADJACENTCELLS`

finds cells adjacent to other cells in a multi-dimensional array.

`AGYOUDENSQUARE`

generates a Youden square.

`A%VARIANCE`

calculates the percentage variance and sum of squares accounted for in the strata of an `ANOVA`

analysis.

`BINGO`

can be used to set up and then play a game of bingo.

`CVATRELLIS`

displays the distribution of groups over 2 dimensions from a `CVA`

analysis using a trellis of bar or pie charts.

`D2GROUPS`

displays the distribution of groups in a plane using a trellis of bar or pie charts.

`DMOSAIC`

produces a mosaic plot to display a table of counts.

`ELPOISSON`

calculates expected values of the lower parts of Poisson distributions.

`EUPOISSON`

calculates expected values of the upper parts of Poisson distributions.

`FRUITMACHINE`

runs a fruit machine using pop-up menus and Genstat graphics.

`GLTOBITPOISSON`

uses the Tobit method to fit a generalized linear mixed model with censored Poisson data.

`HGTOBITPOISSON `

uses the Tobit method to fit a hierarchical generalized linear model with censored Poisson data.

`KNNTRAIN`

evaluates and optimizes the *k*-nearest-neighbour algorithm using cross-validation.

`LIFE`

plays John Conway’s Game of Life.

`NEIGHBOURS`

finds the neighbours of cells in a multi-dimensional array.

`NOUGHTSANDCROSSES`

plays a game of noughts and crosses.

`PCPCLUSTER`

forms groups of units using the densities of their `PCP`

scores.

`PTFCLUSTERS`

forms clusters of points from their densities in multi-dimensional space.

`PTFILLCLUSTERS`

fills holes within clusters of points in multi-dimensional space.

`RDLOESSGROUPS`

displays results from a locally weighted regression model (loess) fitted to data with groups.

`RKLOESSGROUPS`

stores results from a locally weighted regression (loess) with groups model fitted to data with groups.

`RLOESSGROUPS`

fits locally weighted regression models (loess) to data with groups.

`RMPLCONFIDENCE`

estimates profile likelihood confidence intervals of predicted group means from a linear or generalized linear model analysis.

`RPLCONFIDENCE`

estimates profile likelihood confidence intervals of parameters in a linear or generalized linear model.

`RTOBITPOISSON`

uses the Tobit method to fit models to censored Poisson data.

`RVALIDATE`

fits regression models to validate predictions, for example from a deterministic model, against observed data.

`VREPLACE`

replaces values of vectors and pointers.

### 2.3 Functions

None.

## 3. What’s changed

Most of the changes are compatible with Release 22, the previous release. There are a few commands, however, where new options or parameters have been inserted into the existing lists. These may cause problems in statements where option or parameter names have been omitted or abbreviated (see Section 1.7.1 of Part 1 of the *Guide to the Genstat Command Language* for details). To avoid any difficulty, the name of the option/parameter after the new option/parameter should be given explicitly, and not abbreviated to fewer than four characters.

Any command, where changes in Release 23 may cause incompatibilities in existing programs, is marked in Sections 3.1 and 3.2 by the symbol ^{†}. The full details are given in Section 3.4.

### 3.1 Directives

`OPEN`

has a new parameter `UNICODE`

that can be used to identify an input file as Unicode, so that Genstat will convert it to the UTF-8 format that Genstat uses internally. This is necessary only for files that do not contain the Unicode beginning of file marker (`BOM`

).

### 3.2 Procedures

`AGNATURALBLOCK`

now allows `LEVELS`

to be unset when the `TREATMENTS`

option is set to a factor whose levels have been defined. You can also use the `TREATMENTS`

option to request unequally replicated treatments, by specifying a factor whose values have been defined with the desired replications.

`AGRAPH`

, `AUGRAPH`

, `DTABLE`

and `VGRAPH`

have additional settings `MUPPER%`

and `MLOWER%`

for the `USEAXES`

option to use those attributes from window 1. Also the `KEYMETHOD`

, `PLOTTITLEMETHOD`

and `PAGETITLEMETHOD`

options now apply to the single-factor case as well as multiple factors.

^{†}`BACKTRANSFORM`

has a new option, `%SCALE`

, to control whether back-transformed logit, probit, angular, arcsine-squareroot and complementary log-log values are expressed on the percentage scale.

`BCFDISPLAY`

can now print out-of-bag identifications.

^{†}`BCFOREST`

can now save out-of-bag identifications and votes.

`DPROBABILITY`

and `EDFTEST`

now include the exponentially modified Normal and skew Normal distributions.

`DSEPARATIONPLOT`

now allows probabilities for polytomous outcomes to be supplied in a pointer to variates.

^{†}`EXPORT`

can now include the column descriptions in spreadsheet files.

`GRANDOM`

now includes the exponentially modified Normal, inverse Normal, skew Normal, Laplace, generalized extreme value distributions.

`RLFUNCTIONAL`

now provides the Q major axis and Thei-Sen-Bartlett methods.

`RQUADRATIC`

has a new print setting, predictions, to print the predictions.

`VASERIES`

has a new print setting, description, to print a description of the model and strategy at each site.

### 3.3 Functions

None

### 3.4 Incompatibilities

`BACKTRANSFORM`

Option `%SCALE`

inserted before `BACKTRANSFORMATION`

.

`BCFOREST`

Options `IDOUTOFBAG`

and `VOTESOUTOFBAG`

inserted before `SAVE`

.

`EXPORT`

Option `EXTRAROW`

inserted before `TIMEOUT`

.