Readme file

SERIES B
Statistical Methodology

The complex Bingham quartic distribution and shape analysis,
Journal of the Royal Statistical Society, Series B, volume 68 (2006)
, part 5, pages 747 - 765

The files comprise the following:

fb5ml.data -- Whin Sill data;
qcet2.data -- mouse vertebrae data;
cbq9.r -- R routines to carry out cbq analysis;
example.r -- sample file of commands to reproduce output of the paper.

The R routines have not been packaged as a library, but are in the file cbq9.r

The routines are not very polished and may need refining for awkward datasets, but here is a brief description of how to use them.

1. Read in the R routines using

source("cbq9.r")

2. The data should be presented in the form of a complex n x p matrix, zh, say where each row is a unit vector.

3. Carry out some preliminary calculations by setting

pre=preliminaries(zh)

4. Set nparam=1,2, or 3 depending on whether you wish to estimate all the parameters, just the concentration parameters, or just the
mean parameters (with any parameters not being estimated fixed at the tangent estimator values).

5. Do some preparations for the saddlepoint aprrox by

prep=cbq.sadint5.prep(pre$Omega0.half%*%pre$Omega0.half,niter=1)

6. Set con.ind=1,2,3 or 4 depending on which approximation to the normalizing constant is to be used (simple asymptotic, refined asymptotic, saddlepoint or exact (the last only available if p=2). Then run

param=pre$param0; p=pre$p; p2=2*p-2
if(nparam==2) param=param[1:(p2*(p2+1)/2)]
if(nparam==3) param=param[(p2*(p2+1)/2)+(1:p2)]
out=nlm.vm(cbq.mlden8.std,param,pre=pre,prep=prep,constr=constr.cbq.std,
con.ind=con.ind, nparam=nparam,niter=1,verbose=0)

7. Then "out" contains various pieces of information about the fitted parameters. To get the parameter estimates in the mean-standardized coordinate", run

process(zh,pre=pre,out)

8. The parameters can be mapped back to the original coordinates using pre$g0 which corresponds to the complex conjugate of G(mu) in the paper.

9. Some further information about comparing parameter estimates can be found in the file example.r

J. T. Kent
Department of Statistics
University of Leeds
Leeds
LS2 9JT
UK

E-mail: J.T.Kent@leeds.ac.uk

Journals

SERIES A
Statistics in Society

SERIES B
Statistical Methodology

SERIES C
Applied Statistics

SERIES D
The Statistician