g02ch performs a multiple linear regression with no constant on a set of variables whose sums of squares and cross-products about zero and correlation-like coefficients are given.
Syntax
C# |
---|
public static void g02ch( int n, int k1, int k, double[,] sspz, double[,] rz, double[] result, double[,] coef, double[,] rznv, double[,] cz, out int ifail ) |
Visual Basic |
---|
Public Shared Sub g02ch ( _ n As Integer, _ k1 As Integer, _ k As Integer, _ sspz As Double(,), _ rz As Double(,), _ result As Double(), _ coef As Double(,), _ rznv As Double(,), _ cz As Double(,), _ <OutAttribute> ByRef ifail As Integer _ ) |
Visual C++ |
---|
public: static void g02ch( int n, int k1, int k, array<double,2>^ sspz, array<double,2>^ rz, array<double>^ result, array<double,2>^ coef, array<double,2>^ rznv, array<double,2>^ cz, [OutAttribute] int% ifail ) |
F# |
---|
static member g02ch : n : int * k1 : int * k : int * sspz : float[,] * rz : float[,] * result : float[] * coef : float[,] * rznv : float[,] * cz : float[,] * ifail : int byref -> unit |
Parameters
- n
- Type: System..::..Int32On entry: , the number of cases used in calculating the sums of squares and cross-products and correlation-like coefficients.
- k1
- Type: System..::..Int32On entry: the total number of variables, independent and dependent , in the regression.Constraint: .
- k
- Type: System..::..Int32On entry: the number of independent variables in the regression.Constraint: .
- sspz
- Type: array<System..::..Double,2>[,](,)[,][,]An array of size [dim1, k1]Note: dim1 must satisfy the constraint:On entry: must be set to , the sum of cross-products about zero for the th and th variables, for and ; terms involving the dependent variable appear in row and column .
- rz
- Type: array<System..::..Double,2>[,](,)[,][,]An array of size [dim1, k1]Note: dim1 must satisfy the constraint:On entry: must be set to , the correlation-like coefficient for the th and th variables, for and ; coefficients involving the dependent variable appear in row and column .
- result
- Type: array<System..::..Double>[]()[][]An array of size []On exit: the following information:
, the sum of squares attributable to the regression; , the degrees of freedom attributable to the regression; , the mean square attributable to the regression; , the value for the analysis of variance; , the sum of squares of deviations about the regression; , the degrees of freedom of deviations about the regression; , the mean square of deviations about the regression; , the total sum of squares; , the total degrees of freedom; , the standard error estimate; , the coefficient of multiple correlation; , the coefficient of multiple determination; , the coefficient of multiple determination corrected for the degrees of freedom.
- coef
- Type: array<System..::..Double,2>[,](,)[,][,]An array of size [dim1, ]Note: dim1 must satisfy the constraint:On exit: for , the following information:
- , the regression coefficient for the th variable.
- , the standard error of the regression coefficient for the th variable.
- , the value of the regression coefficient for the th variable.
- rznv
- Type: array<System..::..Double,2>[,](,)[,][,]An array of size [dim1, k]Note: dim1 must satisfy the constraint:On exit: the inverse of the matrix of correlation-like coefficients for the independent variables; that is, the inverse of the matrix consisting of the first rows and columns of rz.
- cz
- Type: array<System..::..Double,2>[,](,)[,][,]An array of size [dim1, k]Note: dim1 must satisfy the constraint:On exit: the modified inverse matrix, , where
- ifail
- Type: System..::..Int32%On exit: unless the method detects an error or a warning has been flagged (see [Error Indicators and Warnings]).
Description
g02ch fits a curve of the form
to the data points
such that
The method calculates the regression coefficients, , (and various other statistical quantities) by minimizing
The actual data values are not provided as input to the method. Instead, input to the method consists of:
(i) | The number of cases, , on which the regression is based. |
(ii) | The total number of variables, dependent and independent, in the regression, . |
(iii) | The number of independent variables in the regression, . |
(iv) | The by matrix of sums of squares and cross-products about zero of all the variables in the regression; the terms involving the dependent variable, , appear in the th row and column. |
(v) | The by matrix of correlation-like coefficients for all the variables in the regression; the correlations involving the dependent variable, , appear in the th row and column. |
The quantities calculated are:
(a) | The inverse of the by partition of the matrix of correlation-like coefficients, , involving only the independent variables. The inverse is obtained using an accurate method which assumes that this sub-matrix is positive definite (see [Further Comments]). | ||
(b) | The modified matrix, , where
|
||
(c) | The regression coefficients:
|
||
(d) | The sum of squares attributable to the regression, , the sum of squares of deviations about the regression, , and the total sum of squares, :
|
||
(e) | The degrees of freedom attributable to the regression, , the degrees of freedom of deviations about the regression, , and the total degrees of freedom, :
|
||
(f) | The mean square attributable to the regression, , and the mean square of deviations about the regression, :
|
||
(g) | The value for the analysis of variance:
|
||
(h) | The standard error estimate:
|
||
(i) | The coefficient of multiple correlation, , the coefficient of multiple determination, , and the coefficient of multiple determination corrected for the degrees of freedom, :
|
||
(j) | The standard error of the regression coefficients:
|
||
(k) | The values for the regression coefficients:
|
References
Draper N R and Smith H (1985) Applied Regression Analysis (2nd Edition) Wiley
Error Indicators and Warnings
Errors or warnings detected by the method:
Some error messages may refer to parameters that are dropped from this interface
(LDSSPZ, LDRZ, LDCOEF, LDRZNV, LDCZ) In these
cases, an error in another parameter has usually caused an incorrect value to be inferred.
On entry, .
On entry, .
On entry, .
On entry, .
- This indicates that the by partition of the matrix held in rz, which is to be inverted, is not positive definite.
- Unexpected error in (F04ABF not in this release).
Accuracy
The accuracy of any regression method is almost entirely dependent on the accuracy of the matrix inversion method used. In g02ch, it is the matrix of correlation-like coefficients rather than that of the sums of squares and cross-products about zero that is inverted; this means that all terms in the matrix for inversion are of a similar order, and reduces the scope for computational error. For details on absolute accuracy, the relevant section of the document describing the inversion method used, (F04ABF not in this release), should be consulted. g02da uses a different method, based on (F04AMF not in this release), and that method may well prove more reliable numerically. It does not handle missing values, nor does it provide the same output as this method.
If, in calculating
or any of the
(see [Description]), the numbers involved are such that the result would be outside the range of numbers which can be stored by the machine, then the answer is set to the largest quantity which can be stored as a real variable, by means of a call to x02al.
Parallelism and Performance
None.
Further Comments
The time taken by g02ch depends on .
This method assumes that the matrix of correlation-like coefficients for the independent variables in the regression is positive definite; it fails if this is not the case.
This correlation matrix will in fact be positive definite whenever the correlation-like matrix and the sums of squares and cross-products (about zero) matrix have been formed either without regard to missing values, or by eliminating completely any cases involving missing values for any variable. If, however, these matrices are formed by eliminating cases with missing values from only those calculations involving the variables for which the values are missing, no such statement can be made, and the correlation-like matrix may or may not be positive definite. You should be aware of the possible dangers of using correlation matrices formed in this way (see the G02 class), but if they nevertheless wish to carry out regressions using such matrices, this method is capable of handling the inversion of such matrices, provided they are positive definite.
If a matrix is positive definite, its subsequent re-organisation by either of g02ce or g02cf will not affect this property and the new matrix can safely be used in this method. Thus correlation matrices produced by any of g02bd, g02be, g02bk or g02bl, even if subsequently modified by either g02ce or g02cf, can be handled by this method.
It should be noted that the method requires the dependent variable to be the last of the variables whose statistics are provided as input to the method. If this variable is not correctly positioned in the original data, the means, standard deviations, sums of squares and cross-products about zero, and correlation-like coefficients can be manipulated by using g02ce or g02cf to reorder the variables as necessary.
Example
This example reads in the sums of squares and cross-products about zero, and correlation-like coefficients for three variables. A multiple linear regression with no constant is then performed with the third and final variable as the dependent variable. Finally the results are printed.
Example program (C#): g02che.cs