Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


  >  Docs Center  >  IDL Reference  >  Advanced Math and Stats  >  IMSL_MVAR_NORMALITY

IMSL_MVAR_NORMALITY

IMSL_MVAR_NORMALITY

The IMSL_MVAR_NORMALITY function computes Mardia's multivariate measures of skewness and kurtosis and tests for multivariate normality.



Syntax


Result = IMSL_MVAR_NORMALITY(x [, /DOUBLE] [, FREQUENCIES=array] [, MEANS=variable] [, NMISSING=variable] [, R_MATRIX=variable] [, SUM_FREQS=variable] [, SUM_WEIGHTS=variable] [, WEIGHTS=array])

Return Value


One-dimensional array of size 13 containing output statistics as shown in Table 19-1.

Table 19-1: Output Statistics 

I
result ( I )
0
estimated skewness
1
expected skewness assuming a multivariate normal distribution
2
asymptotic chi-squared statistic assuming a multivariate normal distribution
3
probability of a greater chi-squared
4
Mardia and Foster's standard normal score for skewness
5
estimated kurtosis
6
expected kurtosis assuming a multivariate normal distribution
7
asymptotic standard error of the estimated kurtosis
8
standard normal score obtained from Result(5) through Result(7)
9
p-value corresponding to Result(8)
10
Mardia and Foster's standard normal score for kurtosis
11
Mardia's SW statistic based upon Result(4) and Result(10)
12
p-value for Result(11)

Arguments


x

2D array containing data in which N_ELEMENTS(x(*,0)) is the number of observations (numbers of rows of data) in x and N_ELEMENTS(x(0,*)) is the dimensionality of the multivariate space for which the skewness and kurtosis are to be computed (number of variables in x).

Keywords


DOUBLE

If present and nonzero, double precision is used.

FREQUENCIES

One-dimensional array containing the frequencies. Frequencies must be an integer value. Default assumes all Frequencies equal one.

MEANS

Named variable into which a one-dimensional array of length N_ELEMENTS(x(0,*)) containing the sample means is stored.

NMISSING

Named variable into which the number of rows of data in x containing any missing values (NaN) is stored.

R_MATRIX

Named variable into which an upper triangular array containing the Cholesky RTR factorization of the covariance matrix is stored.

SUM_FREQS

Named variable into which the sum of the frequencies of all observations used in the computations is stored.

SUM_WEIGHTS

Named variable into which the sum of the weights times the frequencies for all observations used in the computations is stored.

WEIGHTS

One-dimensional array containing the weights. Weights must be non-negative. Default assumes all Weights equal one.

Discussion


The IMSL_MVAR_NORMALITY function computes Mardia's (1970) measures b1,p
and b2,p of multivariate skewness and kurtosis, respectfully, for
p = N_ELEMENTS(x(0,*)). These measures are then used in computing tests for multivariate normality. Three test statistics, one based upon b1,p alone, one based upon b2,p alone, and an omnibus test statistic formed by combining normal scores obtained from b1,p and b2,p are computed. On the order of np3, operations are required in computing b1,p when the method of Isogai (1983) is used, where n = N_ELEMENTS(x(*,0)). On the order of np2, operations are required in computing b2,p.

Let:

where:

fi is the frequency of the i-th observation, and wi is the weight for this observation. (Weights wi are defined such that xi is distributed according to a multivariate normal, N(m, S/wi) distribution, where S is the covariance matrix.) Mardia's multivariate skewness statistic is defined as:

while Mardia's kurtosis is given as:

Both measures are invariant under the affine (matrix) transformation AX + D, and reduce to univariate measures when p = N_ELEMENTS(x(0,*)) = 1. Using formulas given in Mardia and Foster (1983), the approximate expected value, asymptotic standard error, and asymptotic p-value for b2,p, and the approximate expected value, an asymptotic chi-squared statistic, and p-value for the b1,p statistic are computed. These statistics are all computed under the null hypothesis of a multivariate normal distribution. In addition, standard normal scores W1(b1,p) and W2(b2,p) (different from but similar to the asymptotic normal and chi-squared statistics above) are computed. These scores are combined into an asymptotic chi-squared statistic with two degrees of freedom:

This chi-squared statistic may be used to test for multivariate normality. A
p-value for the chi-squared statistic is also computed.

Example


In the following example, 150 observations from a 5 dimensional standard normal distribution are generated via routine IMSL_RANDOM (Chapter 12, Random Number Generation). The skewness and kurtosis statistics are then computed for these observations.

m  =  150  
n = 5
IMSL_RANDOMOPT, set = 123457
x = FLTARR(n, m)
x(*) = IMSL_RANDOM(m*n, /Normal)
x = TRANSPOSE(x)
stats = IMSL_MVAR_NORMALITY(x, Sum_Weights = sw, Sum_Freq = sf, $
   Means = means, R_Matrix = r_mat)
PRINT, ';Sum of Frequencies =', sf, FORMAT = '(A25, I4)'
PRINT, ';Sum of the weights =', sw, FORMAT = '(A25, F8.3)'
FOR i = 0, 12 DO PM, i, stats(i), FORMAT = ';(I5, F10.2)'

Sum of Frequencies = 150
Sum of the weights = 150.000
0 0.73
1 1.36
2 18.62
3 0.99
4 -2.37
5 32.67
6 34.54
7 1.27
8 -1.48
9 0.14
10 1.62
11 8.24
12 0.02

Version History


6.4
Introduced



© 2018 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us