WorksheetFunction.RSq(Object, Object) Method

Definition

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Returns the square of the Pearson product moment correlation coefficient through data points in known_y's and known_x's. For more information, see Pearson(Object, Object). The r-squared value can be interpreted as the proportion of the variance in y attributable to the variance in x.

public:
 double RSq(System::Object ^ Arg1, System::Object ^ Arg2);

public double RSq (object Arg1, object Arg2);

Public Function RSq (Arg1 As Object, Arg2 As Object) As Double

Parameters

Arg1

Object

Known_y's - an array or range of data points.

Arg2

Object

Known_x's - an array or range of data points.

Returns

Double

Remarks

Arguments can either be numbers or names, arrays, or references that contain numbers.

Logical values and text representations of numbers that you type directly into the list of arguments are counted.

If an array or reference argument contains text, logical values, or empty cells, those values are ignored; however, cells with the value zero are included.

Arguments that are error values or text that cannot be translated into numbers cause errors.

If known_y's and known_x's are empty or have a different number of data points, RSq returns the #N/A error value.

If known_y's and known_x's contain only 1 data point, RSq returns the #DIV/0! error value.

The equation for the Pearson product moment correlation coefficient, r, is:

Figure 1: Pearson product moment correlation coefficient

where x and y are the sample means AVERAGE(known_x’s) and AVERAGE(known_y’s).

RSq returns r2, which is the square of this correlation coefficient.